Skip to main content
POST
/
api
/
v1
/
teams
Create Team
curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/teams \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "runtime": "default",
  "configuration": {
    "member_ids": [
      "<string>"
    ],
    "instructions": "",
    "reasoning": {
      "enabled": false,
      "model": "<string>",
      "agent_id": "<string>",
      "min_steps": 1,
      "max_steps": 10
    },
    "llm": {
      "model": "<string>",
      "temperature": 1,
      "max_tokens": 2,
      "top_p": 0.5,
      "top_k": 1,
      "stop": [
        "<string>"
      ],
      "frequency_penalty": 0,
      "presence_penalty": 0
    },
    "tools": [
      {}
    ],
    "knowledge_base": {},
    "session": {
      "user_id": "<string>",
      "session_id": "<string>",
      "auto_save": true,
      "persist": true
    },
    "dependencies": {},
    "markdown": true,
    "add_datetime_to_instructions": false,
    "structured_outputs": false,
    "response_model": "<string>",
    "debug_mode": false,
    "monitoring": false,
    "metadata": {}
  },
  "skill_ids": [
    "<string>"
  ],
  "skill_configurations": {},
  "execution_environment": {
    "working_dir": "<string>",
    "env_vars": {},
    "secrets": [
      "<string>"
    ],
    "integration_ids": [
      "<string>"
    ],
    "mcp_servers": {}
  }
}
'
{
  "id": "<string>",
  "organization_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "configuration": {
    "member_ids": [
      "<string>"
    ],
    "instructions": "",
    "reasoning": {
      "enabled": false,
      "model": "<string>",
      "agent_id": "<string>",
      "min_steps": 1,
      "max_steps": 10
    },
    "llm": {
      "model": "<string>",
      "temperature": 1,
      "max_tokens": 2,
      "top_p": 0.5,
      "top_k": 1,
      "stop": [
        "<string>"
      ],
      "frequency_penalty": 0,
      "presence_penalty": 0
    },
    "tools": [
      {}
    ],
    "knowledge_base": {},
    "session": {
      "user_id": "<string>",
      "session_id": "<string>",
      "auto_save": true,
      "persist": true
    },
    "dependencies": {},
    "markdown": true,
    "add_datetime_to_instructions": false,
    "structured_outputs": false,
    "response_model": "<string>",
    "debug_mode": false,
    "monitoring": false,
    "metadata": {}
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "runtime": "default",
  "projects": [
    {}
  ],
  "skill_ids": [
    "<string>"
  ],
  "skills": [
    {}
  ],
  "execution_environment": {
    "working_dir": "<string>",
    "env_vars": {},
    "secrets": [
      "<string>"
    ],
    "integration_ids": [
      "<string>"
    ],
    "mcp_servers": {}
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.kubiya.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

Execution environment configuration for agents/teams