Skip to main content
PUT
Replace or clear a revision's flow graph

Authorizations

x-api-key
string
header
required

Path Parameters

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

Body

application/json

Replace or clear an assistant revision's private workflow graph.

compiled_graph=null is an explicit transition to the bare-assistant runtime. Standalone workflow graph endpoints intentionally retain their stricter request schema and still require a graph object.

compiled_graph
Compiled Graph · object | null
required
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