Skip to main content
POST
Create Workflow
Creates a new workflow definition. Workflows define a directed acyclic graph (DAG) of steps that orchestrations execute in sequence. Each step specifies its type, configuration, and dependencies — enabling complex multi-step AI pipelines with deterministic execution order. Workflows are created in draft status and must be published before they can be executed. This two-phase approach allows teams to review and validate workflow definitions before they are available to agents.

Response

string
Unique workflow identifier.
string
Workflow name.
string
Workflow description.
string
Workflow version.
array
The validated workflow step definitions.
string
Workflow status. Always draft on creation.
string
ISO 8601 timestamp of creation.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
definition
any
required
name
string
required

Workflow name

owner_agent_id
string
required
description
string | null
metadata
any
version
string

Response

Workflow created

workflow_id
string<uuid>
name
string
steps
object[]
triggers
object
created_at
string<date-time>