Skip to main content
POST
Apply graph ops to a revision's flow

Authorizations

x-api-key
string
header
required

Path Parameters

agent_id
string<uuid>
required
revision_id
string<uuid>
required

Body

application/json

Body for POST /revisions/{id}/graph/ops — an ordered PATCH batch.

ops
(UpsertNodeOp · object | RemoveNodeOp · object | UpdateNodeFieldsOp · object | AddEdgeOp · object | RemoveEdgeOp · object | SetEntryNodeOp · object | UpsertContextVariableOp · object | RemoveContextVariableOp · object | SetPersonaOp · object | SetComponentOutputsOp · object)[]
required
Maximum array length: 200
base_version
integer | null

Response

Successful Response

Graph result plus the owning assistant revision's authored execution flag.

updated
boolean
required
validation
WorkflowGraphValidationResponse · object
required

Validation result for a submitted CompiledWorkflowGraph payload.

workflow_enabled
boolean
required
revision
WorkflowRevisionResponse · object | null

Full revision response — the compile-poll target (WF-08).

Clients poll GET /workflows/revisions/{id} and read compilation_status

  • compilation_errors + compiled_graph to determine whether an async compile job is done. compilation_task_id is the Celery task handle the conductor uses to cancel an in-flight compile.
graph_version
integer | null
blocking_error_count
integer
default:0