Skip to main content
POST
Submit, approve or reject a function 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}$
name
string
required

Function name — a Python identifier.

Maximum string length: 64
Pattern: ^[a-z][a-z0-9_]{0,63}$
version
integer
required
transition
string
required
Pattern: ^(submit|approve|reject)$

Body

application/json
notes
string | null

Response

Successful Response

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

Lifecycle state of a single version.

draft → submitted → approved, 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
drafted_by_run
string | null
submitted_by
string | null
submitted_at
string<date-time> | null
approved_by
string | null
approved_at
string<date-time> | null
simulation
SimulationSummary · object | null