List Teams

curl --request GET \
  --url https://control-plane.kubiya.ai/api/v1/teams \
  --header 'Authorization: <api-key>'

[
  {
    "id": "<string>",
    "organization_id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "status": "active",
    "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",
    "agents": [
      {}
    ],
    "runtime": "default",
    "projects": [
      {}
    ],
    "skill_ids": [
      "<string>"
    ],
    "skills": [
      {}
    ],
    "execution_environment": {
      "env_vars": {},
      "secrets": [
        "<string>"
      ],
      "integration_ids": [
        "<string>"
      ],
      "mcp_servers": {}
    }
  }
]

GET

api

teams

List Teams

curl --request GET \
  --url https://control-plane.kubiya.ai/api/v1/teams \
  --header 'Authorization: <api-key>'

[
  {
    "id": "<string>",
    "organization_id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "status": "active",
    "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",
    "agents": [
      {}
    ],
    "runtime": "default",
    "projects": [
      {}
    ],
    "skill_ids": [
      "<string>"
    ],
    "skills": [
      {}
    ],
    "execution_environment": {
      "env_vars": {},
      "secrets": [
        "<string>"
      ],
      "integration_ids": [
        "<string>"
      ],
      "mcp_servers": {}
    }
  }
]

Authorizations

Authorization

string

header

required

Query Parameters

skip

integer

default:0

limit

integer

default:100

status_filter

enum<string> | null

Team status enumeration

Available options:

active,

inactive,

archived

Response

Successful Response

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

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.

Show child attributes

configuration.member_ids

string[]

List of agent IDs in the team

configuration.instructions

default:""

Instructions for the team - can be a single string or list of instructions

configuration.reasoning

ReasoningConfig · object

Reasoning configuration

Show child attributes

configuration.reasoning.enabled

boolean

default:false

Enable reasoning for the team

configuration.reasoning.model

string | null

Model to use for reasoning

configuration.reasoning.agent_id

string | null

Agent ID to use for reasoning

configuration.reasoning.min_steps

integer | null

default:1

Minimum reasoning steps

Required range: x >= 1

configuration.reasoning.max_steps

integer | null

default:10

Maximum reasoning steps

Required range: 1 <= x <= 100

configuration.llm

LLMConfig · object

LLM configuration for the team

Show child attributes

configuration.llm.model

string | null

Default model for the team

configuration.llm.temperature

number | null

Temperature for generation

Required range: 0 <= x <= 2

configuration.llm.max_tokens

integer | null

Maximum tokens to generate

Required range: x >= 1

configuration.llm.top_p

number | null

Top-p sampling

Required range: 0 <= x <= 1

configuration.llm.top_k

integer | null

Top-k sampling

Required range: x >= 0

configuration.llm.stop

string[] | null

Stop sequences

configuration.llm.frequency_penalty

number | null

Frequency penalty

Required range: -2 <= x <= 2

configuration.llm.presence_penalty

number | null

Presence penalty

Required range: -2 <= x <= 2

configuration.tools

Tools · object[]

Tools available to the team - list of tool configurations

configuration.knowledge_base

Knowledge Base · object

Knowledge base configuration (vector store, embeddings, etc.)

configuration.session

SessionConfig · object

Session configuration

Show child attributes

configuration.session.user_id

string | null

User ID for the session

configuration.session.session_id

string | null

Session ID

configuration.session.auto_save

boolean

default:true

Auto-save session state

configuration.session.persist

boolean

default:true

Persist session across runs

configuration.dependencies

Dependencies · object

External dependencies (databases, APIs, services)

configuration.markdown

boolean

default:true

Enable markdown formatting in responses

configuration.add_datetime_to_instructions

boolean

default:false

Automatically add current datetime to instructions

configuration.structured_outputs

boolean

default:false

Enable structured outputs

configuration.response_model

string | null

Response model schema name

configuration.debug_mode

boolean

default:false

Enable debug mode with verbose logging

configuration.monitoring

boolean

default:false

Enable monitoring and telemetry

configuration.metadata

Metadata · object

Additional custom metadata for the team

created_at

string<date-time>

required

updated_at

string<date-time>

required

agents

Agents · object[]

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

Show child attributes

execution_environment.env_vars

Env Vars · object

Environment variables (key-value pairs)

Show child attributes

execution_environment.env_vars.{key}

string

execution_environment.secrets

string[]

Secret names from Kubiya vault

execution_environment.integration_ids

string[]

Integration UUIDs for delegated credentials

execution_environment.mcp_servers

Mcp Servers · object

MCP (Model Context Protocol) server configurations. Supports stdio, HTTP, and SSE transports.

Show child attributes

execution_environment.mcp_servers.{key}

MCPServerConfig · object

Unified MCP server configuration supporting multiple transport types.

This schema uses discriminated union based on the presence of 'command' or 'type' field:

If 'command' is present: stdio transport
If 'type' is present: HTTP/SSE transport

The configuration is validated to ensure only one transport type is specified.

Show child attributes

execution_environment.mcp_servers.{key}.command

string | null

Command for stdio transport (mutually exclusive with url/type)

execution_environment.mcp_servers.{key}.args

string[] | null

Arguments for stdio transport

execution_environment.mcp_servers.{key}.env

Env · object

Environment variables (used by both stdio and HTTP transports)

Show child attributes

execution_environment.mcp_servers.{key}.env.{key}

string

execution_environment.mcp_servers.{key}.transport_type

enum<string> | null

Transport type for HTTP/SSE (mutually exclusive with command)

Available options:

http,

sse

execution_environment.mcp_servers.{key}.url

string | null

URL for HTTP/SSE transport (mutually exclusive with command)

execution_environment.mcp_servers.{key}.headers

Headers · object

HTTP headers for HTTP/SSE transport

Show child attributes

execution_environment.mcp_servers.{key}.headers.{key}

string

Worker Disconnect Create Team

⌘I

Getting Started

Control Plane API

List Teams

Authorizations

Query Parameters

Response