Create a draft version
Create a new draft version — empty, from a template, or cloned from an
existing version (source selects which). Drafts stay editable until
published.
Authorizations
Access token from POST /management/v1/auth/token (publishable-key exchange) or a login session. Publishable-key tokens are agent-scoped and serve the messaging surface; login tokens also serve management.
Path Parameters
^[0-9a-fA-F]{24}$Body
Create a draft version — empty, from a template, or cloned from an
existing version (source selects which).
version, agent-scope, template, empty Required when source='version'
^[0-9a-fA-F]{24}$Required when source='template'
^[0-9a-fA-F]{24}$Runtime build (e.g. '0.4.0') to stamp on the draft. Omit to inherit the cloned source's runtime (or none, for source='empty').
1Response
Successful Response
Returns the created draft version.
Version id
^[0-9a-fA-F]{24}$Owning agent id
^[0-9a-fA-F]{24}$Canonical tag, e.g. 'v3.2'
draft, published, archived Lineage: cloned from
^[0-9a-fA-F]{24}$Counts of the entities configured in a version.
Runtime build this version's bundle targets, e.g. '0.8.0'. None when the bundle pins no runtime
AUI schema version of this version's bundle — the 'schema_version' it was pushed with. None until a bundle is pushed