Discard a sequence 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

Path ParametersExpand Collapse

id: string

Unique identifier of the sequence.

Body ParametersJSONExpand Collapse

expectedVersion: string

The open draft’s version as last read.

ReturnsExpand Collapse

SequenceDiscardDraftResponse 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

curl https://api.lightfield.app/v1/sequences/$ID/draft/discard \
    -H 'Content-Type: application/json' \
    -H 'Lightfield-Version: 2026-03-01' \
    -H "Authorization: Bearer $API_KEY" \
    -d '{
          "expectedVersion": "expectedVersion"
        }'

{
  "sequenceDeleted": true,
  "sequenceId": "sequenceId"
}

Returns Examples

{
  "sequenceDeleted": true,
  "sequenceId": "sequenceId"
}