Skip to main content
POST
/
api
/
v1
/
agents
/
{agent_id}
/
execute
Execute Agent
curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/agents/{agent_id}/execute \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "<string>",
  "system_prompt": "<string>",
  "stream": false,
  "worker_queue_id": "<string>",
  "user_metadata": {}
}'
{
  "execution_id": "<string>",
  "workflow_id": "<string>",
  "status": "<string>",
  "message": "<string>"
}

Path Parameters

agent_id
string
required

Body

application/json
prompt
string
required

The prompt to execute

worker_queue_id
string
required

Worker queue ID (UUID) to route execution to - REQUIRED

system_prompt
string | null

Optional system prompt

stream
boolean
default:false

Whether to stream the response

user_metadata
object | null

User attribution metadata (optional, auto-filled from token)

Response

Successful Response

execution_id
string
required
workflow_id
string
required
status
string
required
message
string
required