Skip to main content
POST
/
api
/
v1
/
tasks
/
plan
/
stream
Plan Task Stream
curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/tasks/plan/stream \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "<string>",
  "priority": "medium",
  "project_id": "<string>",
  "agents": [
    {
      "id": "<string>",
      "name": "<string>",
      "model_id": "<string>",
      "description": "<string>",
      "capabilities": [
        "<string>"
      ],
      "status": "active"
    }
  ],
  "teams": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "agent_count": 0,
      "status": "active"
    }
  ],
  "environments": [
    {
      "id": "<string>",
      "name": "<string>",
      "display_name": "<string>",
      "status": "active"
    }
  ],
  "worker_queues": [
    {
      "id": "<string>",
      "name": "<string>",
      "environment_id": "<string>",
      "status": "active",
      "active_workers": 0
    }
  ],
  "refinement_feedback": "<string>",
  "conversation_context": "<string>",
  "previous_plan": {},
  "iteration": 1,
  "planning_strategy": "claude_code_sdk",
  "quick_mode": false
}
'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Enter your Kubiya API token (format: Bearer )

Body

application/json

Request to plan a task

description
string
required

Task description

priority
enum<string>
default:medium

Task priority

Available options:
low,
medium,
high,
critical
project_id
string | null

Associated project ID

agents
AgentInfo · object[]

Available agents (outer context from CLI)

teams
TeamInfo · object[]

Available teams (outer context from CLI)

environments
EnvironmentInfo · object[]

Available execution environments

worker_queues
WorkerQueueInfo · object[]

Available worker queues

refinement_feedback
string | null

User feedback for plan refinement

conversation_context
string | null

Conversation history for context

previous_plan
Previous Plan · object

Previous plan for refinement

iteration
integer
default:1

Planning iteration number

planning_strategy
enum<string> | null
default:claude_code_sdk

Planning strategy to use (claude_code_sdk or agno)

Available options:
claude_code_sdk,
agno
quick_mode
boolean
default:false

Use fast planning for --local mode (Haiku vs Sonnet)

Response

Successful Response