content-draft

Commit an author's edit to a content draft

post/api/v1/content-draft/{draftId}/commit

Path parameters

draftIdstring uuid required

The unique identifier for the draft

Request body

baseVersioninteger required

The record version the posted draft was derived from; 409 when the draft has moved on.

{"stackTrail":"components:schemas:ContentDraftCommitDraftRequestDTO:properties:draft","oasType":"schema","type":"unknown","description":"The complete draft as the author currently has it. Half-authored content is accepted; a body that is not shaped like a mission draft is not."}

Response

canRedoboolean required

Whether an undone version is still ahead of the cursor

canUndoboolean required

Whether an earlier version is still retained to step back to

changedSectionsstring[] required

Names of the top-level draft sections this commit moved. Empty when the draft already said what was posted, in which case nothing was written.

cursorVersionnumber required

The version whose content the draft is showing. Equal to version unless something has been undone.

draftIdstring required

The draft this commit was applied to

versionnumber required

The write counter after the commit. Send this as baseVersion on the next commit.

Changes

Changed in 1 of the 12 revisions of this API.1