Add Agent To Team

Add an agent to a team.

This sets the agent’s team_id foreign key. You can also manage members through the team’s configuration.member_ids field. Only allows adding agents to teams belonging to the current organization.

POST /api/v1/teams/{team_id}/agents/{agent_id}

Add Agent To Team

cURL

curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/teams/{team_id}/agents/{agent_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "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": {
    "working_dir": "<string>",
    "env_vars": {},
    "secrets": [
      "<string>"
    ],
    "integration_ids": [
      "<string>"
    ],
    "mcp_servers": {}
  }
}

Authorizations

Authorization · string · header · required

Enter your Kubiya API token (format: Bearer )

Path Parameters

team_id · string · required

agent_id · string · required

Response

200

application/json

Successful Response

Team response including member agents

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.

Show child attributes

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 | null

Execution environment configuration for agents/teams

Show child attributes