# Draft API

Source: https://dev.arcxp.com/api/content-administration/draft-api-production/

The **Draft API** standardizes Arc XP content publishing by providing a basic set of document **save** and **publish** operations that currently support story documents. Arc XP plans to extend the operations to support other content types.

The Draft API is a developer API to create, update, and delete documents.

> **Caution:**
> 
> Do not call the Draft API from PageBuilder Engine or other frontend or rendering systems.

If you need to retrieve documents or redirects for PageBuilder Engine, use the [Content API](https://dev.arcxp.com/api/public-content-retrieval/content-api/).

> **Note:**
> 
> Before diving into the Draft API endpoints, read [Getting Started with the Draft API](https://dev.arcxp.com/publishing-platform/developer-docs/draft-api/getting-started-with-the-draft-api) 

See https://alc-swagger-template.s3.amazonaws.com/docs/swagger/arc-products/prod.draft.json for Open API specs

## Common use cases

### Recovering previous versions of a story with story ID

When returning story revisions, you can receive 25 revisions through the API. To continue to revisions beyond the last 25, use the `after` parameter.

`https://api.[orgId].arcpublishing.com/draft/v1/story/[storyId]/revision` returns `{"revisions": [...], "last": "[revisionID]"}`. (This example excludes the revisions array for clarity.)

To get the next page, use the `after` parameter: `https://api.[orgId].arcpublishing.com/draft/v1/story/[storyId]/revision?after=[revisionID]`. If no more records exist, the result does not include the last field in the response.