Skip to main content
POST
Start an action content draft

Authorizations

Authorization
string
header
required

API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.

Path Parameters

projectId
string<uuid>
required
actionId
string<uuid>
required

UUID of the action.

Body

application/json
requestIdempotencyKey
string<uuid>
required
draftKind
enum<string>

The draft the caller expects, from the draft read. When sent, the start refuses with draft_kind_changed if the action now takes the other kind.

Available options:
page,
section_edits
modelId
string

A model id from the draft read; the default model when absent.

Required string length: 1 - 120

Response

Started draft run

data
object
required
meta
object
required