v1
latestOpenAPI 3.1.12026-07-267189154.8 KBList post draft versions
List saved draft versions for a post's channel editors, newest first. Each channel with an editor is returned as its own entry with its own versions array, nextCursor, and optional error.
Pagination: Each channel paginates independently. To fetch more versions for a channel, call again with channel set to that channel and cursor set to the nextCursor from the previous response. channel is required whenever cursor is set.
Errors: When channel is set and that channel has no editor for this post, the endpoint returns 404 NOT_FOUND. If a single channel's version history fails to load, that channel's entry has an empty versions array plus an error string — the rest of the response still succeeds.
Use the returned version IDs with GET /posts/{id}/channels/{channel}/versions/{versionId} to read the copy of a specific version.
Path parameters
Post ID (UUID)
Query parameters
Optional. Only return versions for this channel. Omit to return every channel that has an editor. Required when cursor is set.
Max versions returned per channel, newest first. Default 15, max 100.
Pagination cursor from a previous response's channels[].nextCursor. Requires channel — each channel paginates independently.
Response
Version history grouped by channel