Skip to main content
POST
Create Team

Authorizations

Authorization
string
header
required

Enter your Kubiya API token (format: Bearer )

Body

application/json

Create a new team with full Agno capabilities

name
string
required

Team name

Required string length: 1 - 255
description
string | null

Team description

runtime
string | null
default:default

Runtime type for team leader: 'default' (Agno) or 'claude_code' (Claude Code SDK). Default: 'default'

configuration
TeamConfiguration · object

Team configuration aligned with Agno Team

skill_ids
string[]

Tool set IDs to associate with this team

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

Team response with structured configuration

id
string
required
organization_id
string
required
name
string
required
description
string | null
required
status
enum<string>
required

Team status enumeration

Available options:
active,
inactive,
archived,
idle
configuration
TeamConfiguration · object
required

Comprehensive team configuration aligned with Agno's Team capabilities. This allows full control over team behavior, reasoning, tools, and LLM settings.

created_at
string<date-time>
required
updated_at
string<date-time>
required
runtime
string
default:default

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

projects
Projects · object[]

Projects this team belongs 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