Skip to main content
POST
/
api
/
v1
/
workflows
Create Workflow
curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/workflows \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "steps": [
    "<unknown>"
  ],
  "configuration": {},
  "team_id": "<string>"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "status": "pending",
  "steps": [
    "<unknown>"
  ],
  "current_step": "<string>",
  "configuration": {},
  "team_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "state": {},
  "error_message": "<string>"
}

Authorizations

​
Authorization
string
header
required

Body

application/json
​
name
string
required

Workflow name

​
description
string | null

Workflow description

​
steps
any[]

Workflow steps

​
configuration
Configuration · object

Workflow configuration

​
team_id
string | null

Team ID

Response

Successful Response

​
id
string
required
​
name
string
required
​
description
string | null
required
​
status
enum<string>
required

Workflow status enumeration

Available options:
pending,
running,
paused,
completed,
failed,
cancelled
​
steps
any[]
required
​
current_step
string | null
required
​
configuration
Configuration · object
required
​
team_id
string | null
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
started_at
string<date-time> | null
required
​
completed_at
string<date-time> | null
required
​
state
State · object
required
​
error_message
string | null
required