STstorydoc
versions

Create a new story version

Creates a personalized version of an existing story template with custom data. Each version gets a unique URL and can be tracked independently.

post/v2/versions

Request

  • Base URL
    https://api.storydoc.com
  • Auth
    HTTP bearer

Request body

storyIdstring required

The ID of the story template. Extract this from your Storydoc editor URL: https://editor.storydoc.com/pages/editor/{storyId}

senderEmailstring email required

Email of the sender (must exist in organization)

daysToExpireinteger

Number of days until version expires. Omit for permanent/public version

Example request

{
  "storyId": "61b1e50223b713000a41ca74",
  "senderEmail": "john.doe@company.com",
  "daysToExpire": 30,
  "data": {
    "title": "Sales Presentation",
    "company": "ACME Corp",
    "custom_field_1": "Any value",
    "custom_field_2": 12345,
    "logo": {
      "domain": "acme.com",
      "theme": "dark"
    },
    "partner_logo": {
      "domain": "microsoft.com",
      "theme": "light"
    }
  }
}

Response

Version created successfully

urlstring uri

Public URL for the version

shortUrlstring uri

Shortened URL for the version

editorUrlstring uri

URL to edit the version in Storydoc editor

versionUrlstring uri

URL to view version details in Storydoc platform

versionIdstring

Unique identifier for the version (only in create response)

Example response

{
  "url": "https://www.storydoc.com/5d7d8922e00d9265/2e91b144-092f-456b-8f2e-0bae9f7f3355",
  "shortUrl": "https://view.storydoc.com/4GdDGt",
  "editorUrl": "https://app.storydoc.com/pages/editor/61b1e50223b713000a41ca74/61b1f40a3a86b7a96d0d8ccc",
  "versionUrl": "https://app.storydoc.com/pages/editor/61b1e50223b713000a41ca74/versions/61b1f40a3a86b7a96d0d8ccc",
  "versionId": "61b1f40a3a86b7a96d0d8ccc"
}

Changes

No recorded changes to this operation across all 1 revision of this API.