Skip to main content
POST
Execute Plan

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