API referenceAgents and workflowsWorkflows
Create an AI workflow (a visual DAG of inference steps)
Requires the workflows:create permission.
The optional spec is the JSON DAG (nodes + edges); it lands as the mutable draft. Node types: trigger.manual, trigger.webhook, llm, template, http, branch, approval, output.
AuthorizationBearer <token>
An access token from this zone's POST /oauth/token, or a session token from POST /api/v1/auth/login. Send it as Authorization: Bearer <token>.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/workflows" \ -H "Content-Type: application/json" \ -d '{ "name": "string" }'{ "canary": { "online": true, "state": "string", "version": 0, "weight": 0 }, "created_at": "2019-08-24T14:15:22Z", "current_version": 0, "deployed_version": 0, "deployment_state": "string", "description": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "idle_undeploy_minutes": 0, "name": "string", "require_eval_pass": true, "runner_online": true, "spec": {}, "status": "string", "tags": { "property1": "string", "property2": "string" }, "trigger_type": "string", "updated_at": "2019-08-24T14:15:22Z", "webhook_set": true}