Drafts - Nohead

Every command also takes the global options, such as --json.

`nohead drafts list`

List a collection’s drafts, most recently changed first.

nohead drafts list [options] <collection>

Argument
`<collection>`	Collection slug or ID.

Option
`--record <id>`	This record’s draft instead, whatever its collection.
`--limit <n>`	Page size (1-100, default 100)
`--cursor <cursor>`	Continue from a previous page’s next_cursor.
`--all`	Follow cursors and return every draft.

Show a draft, with the record’s values as they read after the merge.

nohead drafts get [options] <draft>

Argument
`<draft>`	Draft ID (drf_…)

Option
`--expand <fields>`	Relation fields whose records to embed (comma-separated)

Start a record’s draft from its values (the given fields over them), or from an earlier revision.

nohead drafts create [options] <record>

Argument
`<record>`	Record ID.

Option
`--from-revision <n>`	Start from this revision’s values instead of the record’s.
`--set <key=value>`	Set a field (key=text or key:=json); repeatable.
`--data <json>`	Record data as a JSON object.
`--data-file <path>`	Read record data from a JSON file (- for stdin)

Change a draft; only the given fields change (null clears one)

nohead drafts update [options] <draft>

Argument
`<draft>`	Draft ID (drf_…)

Option
`--if-revision <n>`	Fail with 412 unless the draft is still at this revision.
`--set <key=value>`	Set a field (key=text or key:=json); repeatable.
`--data <json>`	Record data as a JSON object.
`--data-file <path>`	Read record data from a JSON file (- for stdin)

Apply a draft to its record now, as one revision (the record stays live or not)

nohead drafts merge [options] <draft>

Argument
`<draft>`	Draft ID (drf_…)

Option
`--if-revision <n>`	Fail with 412 unless the draft is still at this revision.

Delete a draft for good (the record is unchanged)

nohead drafts discard [options] <draft>

Argument
`<draft>`	Draft ID (drf_…)

Option
`--if-revision <n>`	Fail with 412 unless the draft is still at this revision.
`--yes`	confirm: a discarded draft cannot be restored.

Merge a draft later (within a minute of the time)

nohead drafts schedule [options] <draft>

Argument
`<draft>`	Draft ID (drf_…)

Option
`--merge-at <time>`	ISO 8601 time, or +2h / +3d.

Cancel a draft’s scheduled merge.

nohead drafts unschedule [options] <draft>

Argument
`<draft>`	Draft ID (drf_…)