Skip to main content
PATCH
Update Team

Authorizations

Authorization
string
header
required

Enter your Kubiya API token (format: Bearer )

Path Parameters

team_id
string
required

Body

application/json

Update an existing team

name
string | null

Team name

Required string length: 1 - 255
description
string | null

Team description

status
enum<string> | null

Team status

Available options:
active,
inactive,
archived,
idle
runtime
string | null

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

configuration
TeamConfiguration · object | null

Team configuration

skill_ids
string[] | null
skill_configurations
Skill Configurations · object | null
environment_ids
string[] | null
execution_environment
ExecutionEnvironment · object | null

Execution environment configuration for agents/teams

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