Skip to main content
POST
Create Agent

Authorizations

Authorization
string
header
required

Enter your Kubiya API token (format: Bearer )

Body

application/json
name
string
required

Agent name

description
string | null

Agent description

system_prompt
string | null

System prompt for the agent

capabilities
any[]

Agent capabilities

configuration
Configuration · object

Agent configuration

model_id
string | null

LiteLLM model identifier

model
string | null

Model identifier (alias for model_id)

llm_config
Llm Config · object

Model-specific configuration

runtime
string | null

Runtime type: 'default' (Agno) or 'claude_code' (Claude Code SDK)

runner_name
string | null

Preferred runner for this agent

team_id
string | null

Team ID to assign this agent to

environment_ids
string[]

Environment IDs to deploy this agent to

skill_ids
string[]

Tool set IDs to associate with this agent

skill_configurations
Skill Configurations · object

Tool set configurations keyed by skill ID

execution_environment
ExecutionEnvironment · object | null

Execution environment: env vars, secrets, integrations

Response

Successful Response

id
string
required
organization_id
string
required
name
string
required
description
string | null
required
system_prompt
string | null
required
status
string
required
capabilities
any[]
required
configuration
Configuration · object
required
model_id
string | null
required
llm_config
Llm Config · object
required
runtime
string | null
required
runner_name
string | null
required
team_id
string | null
required
created_at
string
required
updated_at
string
required
last_active_at
string | null
required
state
State · object
required
error_message
string | null
required
projects
Projects · object[]

Projects this agent belongs to

environments
Environments · object[]

Environments this agent is deployed to

skill_ids
string[] | null

IDs of associated skills

skills
Skills · object[] | null

Associated skills with details

execution_environment
ExecutionEnvironment · object | null

Execution environment configuration for agents/teams