Skip to main content
POST
/
api
/
v1
/
tasks
/
plan
/
execute
Execute Plan
curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/tasks/plan/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "plan": {},
  "worker_queue_id": "<string>",
  "agent_id": "<string>",
  "plan_generation_id": "<string>"
}
'
{
  "execution_id": "<string>",
  "status": "<string>",
  "plan_title": "<string>",
  "total_tasks": 123
}

Authorizations

Authorization
string
header
required

Enter your Kubiya API token (format: Bearer )

Body

application/json

Request to execute a plan

plan
Plan · object
required

The plan JSON to execute

worker_queue_id
string
required

Worker queue ID to route task executions to

agent_id
string | null

Agent ID to use for task execution (optional, extracted from plan if not provided)

plan_generation_id
string | null

ID of the plan generation execution that created this plan (for linking)

Response

Successful Response

Response for plan execution

execution_id
string
required
status
string
required
plan_title
string
required
total_tasks
integer
required