Skip to main content
POST
/
api
/
v1
/
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}
{
  "id": "<string>",
  "organization_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "status": "active",
  "configuration": {
    "member_ids": [
      "<string>"
    ],
    "instructions": "<string>",
    "reasoning": {
      "enabled": false,
      "model": "<string>",
      "agent_id": "<string>",
      "min_steps": 2,
      "max_steps": 50
    },
    "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",
  "projects": [
    {}
  ],
  "skill_ids": [
    "<string>"
  ],
  "skills": [
    {}
  ],
  "execution_environment": {
    "env_vars": {},
    "secrets": [
      "<string>"
    ],
    "integration_ids": [
      "<string>"
    ]
  },
  "agents": [
    {}
  ]
}

Path Parameters

team_id
string
required
agent_id
string
required

Response

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
configuration
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
agents
Agents · object[]
required
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
object | null

Execution environment configuration for agents/teams