# Create a new story version

**POST /v2/versions**

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


## Servers
- Production API server: https://api.storydoc.com (Production API server)


## Authentication methods
- Bearer auth


## Parameters



### Body: application/json (object)

- **storyId** (string)
  The ID of the story template. Extract this from your Storydoc editor URL: https://editor.storydoc.com/pages/editor/{storyId}
- **senderEmail** (string(email))
  Email of the sender (must exist in organization)
- **daysToExpire** (integer)
  Number of days until version expires. Omit for permanent/public version
- **data** (object)



## Responses
### 200
Version created successfully

#### Body: application/json (object)
- **url** (string(uri))
  Public URL for the version
- **shortUrl** (string(uri))
  Shortened URL for the version
- **editorUrl** (string(uri))
  URL to edit the version in Storydoc editor
- **versionUrl** (string(uri))
  URL to view version details in Storydoc platform
- **versionId** (string)
  Unique identifier for the version (only in create response)

### 400
Invalid request parameters

#### Body: application/json (object)
- **error** (string)


### 403
Authentication failed or token outdated

#### Body: application/json (object)
- **error** (string)


### 429
Rate limit exceeded
#### Headers
- **x-rate-limit-counter** (integer)
  Current request count
- **x-rate-limit-maximum** (integer)
  Maximum allowed requests

#### Body: application/json (object)
- **error** (string)


### 500
Internal server error

#### Body: application/json (object)
- **error** (string)

- **errorId** (string)



[Powered by Bump.sh](https://bump.sh)