Skip to main content
POST
Execute Team

Authorizations

Authorization
string
header
required

Enter your Kubiya API token (format: Bearer )

Path Parameters

team_id
string
required

Body

application/json
prompt
string
required

The prompt/task to execute

worker_queue_id
string
required

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

system_prompt
string | null

Optional system prompt for team coordination

stream
boolean
default:false

Whether to stream the response

user_metadata
User Metadata · object | null

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

execution_environment
ExecutionEnvironment · object | null

Optional execution environment overrides (working_dir, env_vars, etc.)

execution_metadata
Execution Metadata · object | null

Optional metadata for tracking and filtering executions (e.g., meta_agent_session_id, trigger_type)

Response

Successful Response

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