Create a draft version of an existing content item.

post

https://example.com/authoring/v1/content/{id}/create-draft

Use the /content/{id}/create-draft endpoint to create a draft version of an existing content item. You can create a draft version when a content item document is in ready or retired status. If a draft of the content item already exists, you cannot create a draft.

User roles: admin, manager, editor

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

Provide the ID of the content item that you want to create a draft version.

Query Params

include

string

Optional. Parameters used to include additional fields inside each returned content item. Use "links" to include the links section, which contains URLs for actions that can be performed on the content item. Use "metadata" to include additional fields for each of the items referenced by the content item, such as the URL of the referenced assets. You can specify multiple fields as a comma-separated value. For example, "include=links, metadata".

fields

string

Only the content items fields that are specified here are returned for each result. Any content item field is a valid value and can be specified as a comma-separated list. For example, to list the content item fields name and ID, provide the value ID, and name. All content item fields are returned by default.

Headers

If-Match

string

Provide an revision value from a previous request to check when a content item was last updated. If the value that you provide is old, the call returns a 412 with the latest version of the content item.

Responses

200Successfully created a draft version of the content item.

400The content item is not in the ready state and cannot create a draft.

404The content item with ID {id} was not found.

409A draft already exists with the given ID or unable to create a draft of the content item as it was updated by another user since you retrieved it.

412The If-Match pre-condition failed. The revision value that you provided in the If-Match parameter did not match the recent document version. The error message includes the recent version of the document.

429Too Many Requests, the server has reached a limit, the request must be sent again at a later time.

503Unable to change the status of the content item as the service is unavailable. Try again later.

defaultUnexpected error.