Draft API

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.

Note

Before diving into the Draft API endpoints, read Getting Started with the Draft API

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.