# Storydoc API V2

OpenAPI file: https://docs.storydoc.com/source.json

## Description

This is version `2.1.0` of this API documentation. Last update on Oct 14, 2026.
# Overview
The Storydoc API V2 provides capabilities for automating Storydoc version creation and management. Create personalized versions of your Storydoc templates with custom data, password protection, and gated content.

## Key Features
- **Version Management**: Create and update personalized versions of your Storydoc templates
- **Dynamic Variables**: Support for text, numbers, links, dates, arrays, and logo variables
- **Access Control**: Password protection and gated content forms

## What a key can see
An API key acts as the person who created it and sees the same stories, versions, folders and analytics they see in Storydoc. An administrator's key sees the whole organization. Anyone else's key sees stories in folders shared with everyone, stories in folders they are a member of, and stories in no folder. Stories, versions and folders outside that answer as not found, and analytics leave out their events. Organization-wide tokens, which only administrators can create, see everything.

## Rate Limits
**Version Endpoints**: 150 requests per minute per IP address

**Rate Limit Headers**: Every response includes the following headers to help you monitor usage:
- `x-rate-limit-counter`: Current number of requests made
- `x-rate-limit-maximum`: Maximum allowed requests per minute

**Rate Limit Exceeded**: When the limit is exceeded, you'll receive a 429 status code with the error message "Too many requests". Wait for the rate limit window to reset before making additional requests.

## Servers

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


## Topics

### [Authentication](https://docs.storydoc.com/authentication.md)


## Endpoints

### [versions](https://docs.storydoc.com/group/endpoint-versions.md)

- [List versions](https://docs.storydoc.com/operation/operation-listversions.md)

- [Create a new story version](https://docs.storydoc.com/operation/operation-createstoryversion.md)

- [Get a version](https://docs.storydoc.com/operation/operation-getversion.md)

- [Update an existing version](https://docs.storydoc.com/operation/operation-updatestoryversion.md)


### [account](https://docs.storydoc.com/group/endpoint-account.md)

- [Get account details](https://docs.storydoc.com/operation/operation-getaccount.md)


### [stories](https://docs.storydoc.com/group/endpoint-stories.md)

- [Get story details](https://docs.storydoc.com/operation/operation-getstory.md)

- [Get all variables of a story](https://docs.storydoc.com/operation/operation-getstoryvariables.md)

- [List all stories](https://docs.storydoc.com/operation/operation-getstories.md)

- [Generate a new story from a prompt](https://docs.storydoc.com/operation/operation-generatestory.md)


### [analytics](https://docs.storydoc.com/group/endpoint-analytics.md)

- [Query analytics events](https://docs.storydoc.com/operation/operation-getanalyticsevents.md)


### [folders](https://docs.storydoc.com/group/endpoint-folders.md)

- [List folders](https://docs.storydoc.com/operation/operation-listfolders.md)




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