Skip to main content
POST
Create a draft version

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

workspace
string
required

Workspace slug.

Maximum string length: 64
Pattern: ^[a-z0-9][a-z0-9-]{0,63}$
key
string
required

Decision key — a flat slug, never a path.

Maximum string length: 64
Pattern: ^[a-z0-9][a-z0-9-]{0,63}$

Body

application/json
content
string
required

Raw JDM JSON. Stored byte-exact; the sha256 of these bytes becomes the version's content_sha. Structurally validated before it is written.

notes
string | null

What changed and why.

Response

Successful Response

workspace
string
required
key
string
required
version
integer
required
content_sha
string
required
status
enum<string>
required

Lifecycle state of a single version.

draftsubmittedapproved, with reject returning a submitted version to draft and retire taking an approved version out of circulation.

Available options:
draft,
submitted,
approved,
retired
created_by
string
required
created_at
string<date-time>
required
content
string
required

Raw JDM JSON, byte-exact.

notes
string | null
submitted_by
string | null
submitted_at
string<date-time> | null
approved_by
string | null
approved_at
string<date-time> | null
source_instance
string | null
source_version
integer | null