Add Agent To Team

curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/teams/{team_id}/agents/{agent_id} \
  --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": {}
  }
}

POST

api

teams

{team_id}

agents

{agent_id}

Add Agent To Team

curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/teams/{team_id}/agents/{agent_id} \
  --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

Path Parameters

team_id

string

required

agent_id

string

required

Response

Successful Response

Team response including member agents

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

Update Team Remove Agent From Team

⌘I

Getting Started

Control Plane API

Add Agent To Team

Authorizations

Path Parameters

Response