Skip to main content
POST
Bind the workflow definition

Authorizations

Authorization
string
header
required

An Agent credential (nits_…), or a person token (nitp_…) on a deployment that enables them. GET /api/v1/session names the principal a credential proves.

Body

application/json
branchId
string
required
Required string length: 1 - 200
definition
object
required

Ids are unique within roles, stages, transitions and gates; a stage's requiredRole names a declared role; only consensus-read stages declare readers, and they must; only auto-label stages run by a runner declare runner; every transition names declared stages; a sampling gate below the full rate only enters a stage that judges work (adjudicate, consensus-read or review).

idempotencyKey
string
required
Required string length: 1 - 200
projectId
string
required
Required string length: 1 - 200
expectedWorkflowVersion
string | null
Required string length: 1 - 200

Response

Bind the workflow definition

commit
object
required
workflowVersion
string
required