API reference
59 operations for building and editing Sceniq guides. 57 of them are both a REST endpoint and an MCP tool with the same name and the same input; the two photo uploads are REST only. Every page lists the parameters, every response field, an example and the errors.
- REST
- https://sceniq.earth/api/v1
- MCP
- https://sceniq.earth/api/mcp
- Auth
- Authorization: Bearer sk_sceniq_...
- Version
- 2026-09-30.2
Account
Guides
- GETlist_guidesAll guides of this creator (drafts included)/v1/guides
- POSTcreate_guideCreate a new draft guide/v1/guides
- GETget_guideOne guide: settings, region, properties, price, counts/v1/guides/{productId}
- PATCHupdate_guideChange guide settings (name, headline, tags, country)/v1/guides/{productId}
- PUTset_guide_regionSet the map region (label, center, zoom, bbox)/v1/guides/{productId}/region
- PUTset_guide_priceSet the one-time price/v1/guides/{productId}/price
- GETget_guide_readinessPublish checklist: blocking gates, warnings, review link/v1/guides/{productId}/readiness
- GETlist_stale_noticesDated facts that ran out or need a new check/v1/guides/{productId}/stale-notices
Custom properties
- GETlist_propertiesCustom spot property definitions of a guide/v1/guides/{productId}/properties
- POSTcreate_propertyAdd a custom property definition/v1/guides/{productId}/properties
- PATCHupdate_propertyRelabel a property or manage its options/v1/properties/{propertyDefId}
- POSTconvert_propertyChange a property's kind without losing values/v1/properties/{propertyDefId}/convert
- POSTarchive_propertyArchive a property (values on spots are preserved)/v1/properties/{propertyDefId}/archive
- PUTreorder_propertiesSet the display order of all live properties/v1/guides/{productId}/properties/order
Spots
- GETlist_spotsAll spots of a guide in editor order/v1/guides/{productId}/spots
- POSTcreate_spotAdd a spot (a place the creator has been to)/v1/guides/{productId}/spots
- GETget_spotOne spot with its photos, chapters and routes/v1/spots/{spotId}
- PATCHupdate_spotEdit a spot (fields, arrival, facts, archive)/v1/spots/{spotId}
- DELETEdelete_spotDelete a spot (refused once the guide has buyers)/v1/spots/{spotId}
- POSTupsert_spotsCreate or update up to 25 spots by your own ref/v1/guides/{productId}/spots/batch
- PUTset_spot_routesSet which routes reach this spot/v1/spots/{spotId}/routes
Areas: parks, islands, regions
Chapters and collections
- GETlist_chaptersChapters and collections with their members/v1/guides/{productId}/chapters
- POSTcreate_chapterCreate a chapter or a collection/v1/guides/{productId}/chapters
- PATCHupdate_chapterEdit a chapter (name, description, prose, cover)/v1/chapters/{collectionId}
- PUTset_chapter_membersReplace the ordered member list of a chapter/v1/chapters/{collectionId}/members
- PUTset_chapter_introSet the structured front matter of an intro chapter/v1/chapters/{collectionId}/intro
- PUTreorder_chapterMove a chapter between two neighbours/v1/chapters/{collectionId}/position
- DELETEdelete_chapterDelete a chapter or collection (spots stay)/v1/chapters/{collectionId}
Routes (how to get there)
- GETlist_routesRoutes (hikes, approaches) with their spot and facility links/v1/guides/{productId}/routes
- POSTcreate_routeAdd a route (how to get there)/v1/guides/{productId}/routes
- PATCHupdate_routeEdit a route/v1/routes/{routeId}
- PUTset_route_spotsReplace the ordered spots a route passes/v1/routes/{routeId}/spots
- PUTset_route_facilitiesReplace the places a route uses/v1/routes/{routeId}/facilities
- DELETEdelete_routeDelete a route (spots and places remain)/v1/routes/{routeId}
Places: stays, transport, food, parking
- GETlist_facilitiesPlaces of a guide (stays, transport, food, parking)/v1/guides/{productId}/facilities
- POSTcreate_facilityAdd a place: a stay, transport, tour, food or parking/v1/guides/{productId}/facilities
- PATCHupdate_facilityEdit a place/v1/facilities/{facilityId}
- DELETEdelete_facilityDelete a place/v1/facilities/{facilityId}
Photos
- GETlist_mediaPhotos of a guide with their owner rows/v1/guides/{productId}/media
- PATCHupdate_mediaSet a photo's caption, alt, credit, focal point or provenance/v1/media/{mediaId}
- PUTreorder_mediaMove a photo within its owner's gallery/v1/media/{mediaId}/order
- DELETEdelete_mediaRemove a photo/v1/media/{mediaId}
- POSTupload_mediaUpload a photo (raw bytes or multipart)/v1/media/upload
- POSTupload_media_batchUpload up to 10 photos in one request/v1/media/upload-batch