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
}

Documentation Index

Fetch the complete documentation index at: https://docs.kubiya.ai/llms.txt

Use this file to discover all available pages before exploring further.

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