Duplicate a story
const url = 'https://example.com/api/stories/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/duplicate';const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/stories/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/duplicate \ --header 'Authorization: Bearer <token>'Copy a story you can read into a new private draft you own.
Its owner or an admin copies the draft; anyone else the published document. Scenes on maps you can’t read are left out of the copy. The copy gets its own copies of the images it uses and of the cover.
Authorizations
Section titled “ Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ”Responses
Section titled “ Responses ”Successful Response
object
A story’s visibility as stored. A private story shared with groups is
restricted: its groups’ members read it too.
object
object
object
object
Longitude, latitude.
Visibility by map layer id. Layers the map no longer has are ignored, and a layer left out keeps its saved visibility.
object
The chapter has a scene on a map you can’t read, so it’s shown without one.
object
Made by the client and stable across saves.
An image uploaded to the host story.
object
Made by the client and stable across saves.
object
object
Made by the client and stable across saves.
object
object
Made by the client and stable across saves.
object
An http or https address; any other scheme is refused.
Open the link in a new tab.
object
Made by the client and stable across saves.
object
An https address on a host an admin approved for stories. Stored as given and never fetched by the server.
Names the frame for screen readers.
object
Made by the client and stable across saves.
object
An https address on a host an admin approved for stories. Stored as given and never fetched by the server.
Names the frame for screen readers.
object
Show the chapter navigation bar.
Chapter panel beside the map or floating over it.
Where a floating panel sits.
Reader page theme; follow uses the reader’s.
How the map moves into a chapter whose scene sets no transition.
The sharing groups the story is shared with, by name.
object
Unique group identifier.
Group name.
Example
{ "visibility": "private", "document": { "chapters": [ { "scene": { "camera": { "bearing": 0, "pitch": 0 }, "transition": "fly" }, "scene_hidden": false, "blocks": [ { "type": "markdown", "v": 1 } ] } ], "settings": { "navigation": false, "layout": "side", "panel_position": "left", "theme": "follow", "transition": "fly" } }}Bad request — invalid payload
Unauthorized — missing or invalid credentials
Forbidden — caller lacks write access
Not found
The copied images would take your stories past the most image bytes the admin allows (detail.code story_asset_owner_limit).
Validation error
Too many requests — retry after the advertised interval
Headers
Section titled “ Headers ”Seconds until the request may be retried
Internal server error
Bad gateway — an upstream provider failed
Service unavailable — the database could not serve the request