Skip to content

Discard a sequence draft

$ lightfield sequence discard-draft
POST/v1/sequences/{id}/draft/discard

Discards the open draft at expectedVersion. A published sequence keeps its published version. A sequence that has never been published is deleted with its draft, and sequenceDeleted is true. Returns 404 draft_not_found when no draft is open, and 409 when expectedVersion is not the open draft’s version; retrieve the draft and retry.

Required scope: sequences:update

Rate limit category: Write

ParametersExpand Collapse
--id: string

Unique identifier of the sequence.

--expected-version: string

The open draft’s version as last read.

ReturnsExpand Collapse
sequence_discard_draft_response: object { sequenceDeleted, sequenceId }
sequenceDeleted: boolean

True when the sequence had never been published, so discarding its only draft deleted it.

sequenceId: string

The sequence whose draft was discarded.

Discard a sequence draft

lightfield sequence discard-draft \
  --api-key 'My API Key' \
  --id id \
  --expected-version expectedVersion
{
  "sequenceDeleted": true,
  "sequenceId": "sequenceId"
}
Returns Examples
{
  "sequenceDeleted": true,
  "sequenceId": "sequenceId"
}