v3

OpenAPI 3.1.02026-07-31350397683.8 KB
Agent Workflow

Save Agent Workflow

Attach an imported workflow to an agent and mark the agent's provider CUSTOM.

This is the persistence step for document-ingested workflows (e.g. an IVR diagram parsed in Bluejay AI): the reviewed graph becomes the agent's stored workflow with no external source behind it.

Only agents with no workflow provider (or already CUSTOM) accept an import — an agent synced from ElevenLabs/VAPI/Retell/DFCX is refused with 409 so an import can never clobber a provider-managed workflow.

put/v1/agents/{agent_id}/workflow

Path parameters

agent_idstring required

Headers

X-API-Keystring required

API key required to authenticate requests.

Request body

workflowobject required

Scenario-graph blob: {nodes: [{id, type, data}], edges: [{id, source, target, sourceHandle?}], is_ivr_flow?}

Response

Successful Response

object required