Skip to main content
POST
Submit a version for approval

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}$
version
integer
required
Required range: x >= 1

Body

application/json
notes
string | null

Reviewer note recorded with the transition.

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
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