Skip to main content
PUT
Python

Authorizations

Authorization
string
header
required

Enter your JWT token

Path Parameters

workflowId
integer<int32>
required

Body

application/json

The plan, as JSON.

PUT /v1/workflows/{id}'s body: the plan, and the revision id the caller read with it (GET /v1/workflows/{id}/plan's revisionId).

plan
object | null

The plan an AI agent writes; the compiler turns it into a real workflow.

expectedRevisionId
integer<int64> | null

Response

Success.

workflowId
integer<int32>
required
revisionId
integer<int64>
required

The workflow's revision after this save: the next update's expectedRevisionId.

diagnostics
object[]
required
workspaceId
string<uuid>
required

The workspace the row lives in.

environmentId
string<uuid>
required

The environment the row lives in.