API

Upload service and syndication feeds for NEWPALMYRA

Programmatic access to NEWPALMYRA uploads and archive feeds. Request an API key by email if you need to contribute photos or assets through the upload endpoint.

Upload service

JSON REST API at /api/v1/ for health checks, upload API key requests, photo submissions, and the personalized image queue.

Method Path Auth Description
GET /api/v1/health None Health check
POST /api/v1/keys/request None Request an upload API key (queued for review)
POST /api/v1/image-subscribe None Join the queue for a personalized NEWPALMYRA image
POST /api/v1/upload X-API-Key Upload a reference photo or asset (multipart form)

Upload request

POST /api/v1/upload accepts multipart/form-data with fields file, title, description, and optional monument. Include header X-API-Key: YOUR_KEY. Submissions are stored under CC0.

Image subscribe request

POST /api/v1/image-subscribe accepts JSON {"email": "you@example.com", "instagram": "yourhandle", "website": "https://yoursite.example"} (instagram and website optional) and returns 202 Accepted when queued. Admins generate collectibles from the image queue in the admin console; contributors receive a public download link at GET /api/v1/claim-images/{token} when notified.

Feeds

Atom feeds for NEWPALMYRA archives. Subscribe in your feed reader or poll for updates. Each collection page also links its own feed.

Collection Format URL
Site (all sections) Atom 1.0 /atom.xml
News Atom 1.0 /news/atom.xml
Press Atom 1.0 /press/atom.xml
Models Atom 1.0 /models/atom.xml
Events Atom 1.0 /events/atom.xml
Community Atom 1.0 /projects/atom.xml
Programs Atom 1.0 /programs/atom.xml
Photos Atom 1.0 /photos/atom.xml
People Atom 1.0 /people/atom.xml
Partners Atom 1.0 /partners/atom.xml
TODO Atom 1.0 /todo/atom.xml

Press articles are published under /posts/ (legacy URLs) and listed at /press/. The press feed is at /press/atom.xml. Photo and TODO feeds are built from archive data at build time.

Contact

API key requests and questions: info@newpalmyra.org