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: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "<string>",
  "priority": "medium",
  "project_id": "<string>",
  "agents": [],
  "teams": [],
  "environments": [],
  "worker_queues": [],
  "refinement_feedback": "<string>",
  "conversation_context": "<string>",
  "previous_plan": {},
  "iteration": 1
}
'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

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

teams
TeamInfo · object[]

Available teams

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

Response

Successful Response