# API reference Every operation of the Sceniq creator API, version 2026-09-30.2. Each one is a REST endpoint under https://sceniq.earth/api/v1 and an MCP tool at https://sceniq.earth/api/mcp, except the two photo uploads, which are REST only. Send the API key as Authorization: Bearer sk_sceniq_... ## Account - [whoami](https://developers.sceniq.earth/reference/whoami.md): `GET /v1/me`. Who this key belongs to, plus endpoints and limits. - [get_authoring_guide](https://developers.sceniq.earth/reference/get_authoring_guide.md): `GET /v1/authoring-guide`. The full Sceniq authoring playbook (markdown). ## Guides - [list_guides](https://developers.sceniq.earth/reference/list_guides.md): `GET /v1/guides`. All guides of this creator (drafts included). - [create_guide](https://developers.sceniq.earth/reference/create_guide.md): `POST /v1/guides`. Create a new draft guide. - [get_guide](https://developers.sceniq.earth/reference/get_guide.md): `GET /v1/guides/{productId}`. One guide: settings, region, properties, price, counts. - [update_guide](https://developers.sceniq.earth/reference/update_guide.md): `PATCH /v1/guides/{productId}`. Change guide settings (name, headline, tags, country). - [set_guide_region](https://developers.sceniq.earth/reference/set_guide_region.md): `PUT /v1/guides/{productId}/region`. Set the map region (label, center, zoom, bbox). - [set_guide_price](https://developers.sceniq.earth/reference/set_guide_price.md): `PUT /v1/guides/{productId}/price`. Set the one-time price. - [get_guide_readiness](https://developers.sceniq.earth/reference/get_guide_readiness.md): `GET /v1/guides/{productId}/readiness`. Publish checklist: blocking gates, warnings, review link. - [list_stale_notices](https://developers.sceniq.earth/reference/list_stale_notices.md): `GET /v1/guides/{productId}/stale-notices`. Dated facts that ran out or need a new check. ## Custom properties - [list_properties](https://developers.sceniq.earth/reference/list_properties.md): `GET /v1/guides/{productId}/properties`. Custom spot property definitions of a guide. - [create_property](https://developers.sceniq.earth/reference/create_property.md): `POST /v1/guides/{productId}/properties`. Add a custom property definition. - [update_property](https://developers.sceniq.earth/reference/update_property.md): `PATCH /v1/properties/{propertyDefId}`. Relabel a property or manage its options. - [convert_property](https://developers.sceniq.earth/reference/convert_property.md): `POST /v1/properties/{propertyDefId}/convert`. Change a property's kind without losing values. - [archive_property](https://developers.sceniq.earth/reference/archive_property.md): `POST /v1/properties/{propertyDefId}/archive`. Archive a property (values on spots are preserved). - [reorder_properties](https://developers.sceniq.earth/reference/reorder_properties.md): `PUT /v1/guides/{productId}/properties/order`. Set the display order of all live properties. ## Spots - [list_spots](https://developers.sceniq.earth/reference/list_spots.md): `GET /v1/guides/{productId}/spots`. All spots of a guide in editor order. - [create_spot](https://developers.sceniq.earth/reference/create_spot.md): `POST /v1/guides/{productId}/spots`. Add a spot (a place the creator has been to). - [get_spot](https://developers.sceniq.earth/reference/get_spot.md): `GET /v1/spots/{spotId}`. One spot with its photos, chapters and routes. - [update_spot](https://developers.sceniq.earth/reference/update_spot.md): `PATCH /v1/spots/{spotId}`. Edit a spot (fields, arrival, facts, archive). - [delete_spot](https://developers.sceniq.earth/reference/delete_spot.md): `DELETE /v1/spots/{spotId}`. Delete a spot (refused once the guide has buyers). - [upsert_spots](https://developers.sceniq.earth/reference/upsert_spots.md): `POST /v1/guides/{productId}/spots/batch`. Create or update up to 25 spots by your own ref. - [set_spot_routes](https://developers.sceniq.earth/reference/set_spot_routes.md): `PUT /v1/spots/{spotId}/routes`. Set which routes reach this spot. ## Areas: parks, islands, regions - [list_areas](https://developers.sceniq.earth/reference/list_areas.md): `GET /v1/guides/{productId}/areas`. Parks, islands and regions shared by several spots. - [set_area](https://developers.sceniq.earth/reference/set_area.md): `PUT /v1/guides/{productId}/areas`. Create an area, or replace one area's content. - [delete_area](https://developers.sceniq.earth/reference/delete_area.md): `DELETE /v1/guides/{productId}/areas/{areaId}`. Delete an area (spots lose the link, nothing else). ## Chapters and collections - [list_chapters](https://developers.sceniq.earth/reference/list_chapters.md): `GET /v1/guides/{productId}/chapters`. Chapters and collections with their members. - [create_chapter](https://developers.sceniq.earth/reference/create_chapter.md): `POST /v1/guides/{productId}/chapters`. Create a chapter or a collection. - [update_chapter](https://developers.sceniq.earth/reference/update_chapter.md): `PATCH /v1/chapters/{collectionId}`. Edit a chapter (name, description, prose, cover). - [set_chapter_members](https://developers.sceniq.earth/reference/set_chapter_members.md): `PUT /v1/chapters/{collectionId}/members`. Replace the ordered member list of a chapter. - [set_chapter_intro](https://developers.sceniq.earth/reference/set_chapter_intro.md): `PUT /v1/chapters/{collectionId}/intro`. Set the structured front matter of an intro chapter. - [reorder_chapter](https://developers.sceniq.earth/reference/reorder_chapter.md): `PUT /v1/chapters/{collectionId}/position`. Move a chapter between two neighbours. - [delete_chapter](https://developers.sceniq.earth/reference/delete_chapter.md): `DELETE /v1/chapters/{collectionId}`. Delete a chapter or collection (spots stay). ## Routes (how to get there) - [list_routes](https://developers.sceniq.earth/reference/list_routes.md): `GET /v1/guides/{productId}/routes`. Routes (hikes, approaches) with their spot and facility links. - [create_route](https://developers.sceniq.earth/reference/create_route.md): `POST /v1/guides/{productId}/routes`. Add a route (how to get there). - [update_route](https://developers.sceniq.earth/reference/update_route.md): `PATCH /v1/routes/{routeId}`. Edit a route. - [set_route_spots](https://developers.sceniq.earth/reference/set_route_spots.md): `PUT /v1/routes/{routeId}/spots`. Replace the ordered spots a route passes. - [set_route_facilities](https://developers.sceniq.earth/reference/set_route_facilities.md): `PUT /v1/routes/{routeId}/facilities`. Replace the places a route uses. - [delete_route](https://developers.sceniq.earth/reference/delete_route.md): `DELETE /v1/routes/{routeId}`. Delete a route (spots and places remain). ## Places: stays, transport, food, parking - [list_facilities](https://developers.sceniq.earth/reference/list_facilities.md): `GET /v1/guides/{productId}/facilities`. Places of a guide (stays, transport, food, parking). - [create_facility](https://developers.sceniq.earth/reference/create_facility.md): `POST /v1/guides/{productId}/facilities`. Add a place: a stay, transport, tour, food or parking. - [update_facility](https://developers.sceniq.earth/reference/update_facility.md): `PATCH /v1/facilities/{facilityId}`. Edit a place. - [delete_facility](https://developers.sceniq.earth/reference/delete_facility.md): `DELETE /v1/facilities/{facilityId}`. Delete a place. ## Photos - [list_media](https://developers.sceniq.earth/reference/list_media.md): `GET /v1/guides/{productId}/media`. Photos of a guide with their owner rows. - [update_media](https://developers.sceniq.earth/reference/update_media.md): `PATCH /v1/media/{mediaId}`. Set a photo's caption, alt, credit, focal point or provenance. - [reorder_media](https://developers.sceniq.earth/reference/reorder_media.md): `PUT /v1/media/{mediaId}/order`. Move a photo within its owner's gallery. - [delete_media](https://developers.sceniq.earth/reference/delete_media.md): `DELETE /v1/media/{mediaId}`. Remove a photo. - [upload_media](https://developers.sceniq.earth/reference/upload_media.md): `POST /v1/media/upload`. Upload a photo (raw bytes or multipart). - [upload_media_batch](https://developers.sceniq.earth/reference/upload_media_batch.md): `POST /v1/media/upload-batch`. Upload up to 10 photos in one request. ## Link health - [get_link_report](https://developers.sceniq.earth/reference/get_link_report.md): `GET /v1/guides/{productId}/links`. Health of every link buyers can open in the guide. - [check_links](https://developers.sceniq.earth/reference/check_links.md): `POST /v1/guides/{productId}/links/check`. Check the guide's links now. - [set_link_verified](https://developers.sceniq.earth/reference/set_link_verified.md): `PUT /v1/guides/{productId}/links/verified`. Record that a link was confirmed by hand. ## Sales page - [get_sales_page](https://developers.sceniq.earth/reference/get_sales_page.md): `GET /v1/guides/{productId}/sales-page`. The default sales page: draft, published state, media map. - [save_sales_page_draft](https://developers.sceniq.earth/reference/save_sales_page_draft.md): `PUT /v1/guides/{productId}/sales-page/draft`. Save the sales page draft (never publishes). ## Publishing - [get_publish_status](https://developers.sceniq.earth/reference/get_publish_status.md): `GET /v1/guides/{productId}/publish`. What buyers see, unpublished changes, and what blocks a publish. - [publish_changes](https://developers.sceniq.earth/reference/publish_changes.md): `POST /v1/guides/{productId}/publish`. Publish a live guide's draft changes to buyers. ## Creator profile - [get_profile](https://developers.sceniq.earth/reference/get_profile.md): `GET /v1/profile`. The creator's public profile. - [update_profile](https://developers.sceniq.earth/reference/update_profile.md): `PATCH /v1/profile`. Change the display name or real name. - [set_profile_socials](https://developers.sceniq.earth/reference/set_profile_socials.md): `PUT /v1/profile/socials`. Replace the social links on the profile.