---
title: "List All Teams"
method: GET
path: "/teams"
tags: ["Teams"]
---

# List All Teams

`GET /teams`

Retrieve a comprehensive list of all teams configured in this OS instance.

**Returns team information including:**
- Team metadata (ID, name, description, execution mode)
- Model configuration for team coordination
- Team member roster with roles and capabilities
- Knowledge sharing and memory configurations

## Response `200`

List of teams retrieved successfully

- TeamResponse[]
  - `id` string, nullable
  - `name` string, nullable
  - `db_id` string, nullable
  - `description` string, nullable
  - `role` string, nullable
  - `mode` string, nullable
  - `model` ModelResponse
    - `name` string, nullable — Name of the model
    - `model` string, nullable — Model identifier
    - `provider` string, nullable — Model provider name
  - `tools` object, nullable
  - `sessions` object, nullable
  - `knowledge` object, nullable
  - `memory` object, nullable
  - `reasoning` object, nullable
  - `default_tools` object, nullable
  - `system_message` object, nullable
  - `response_settings` object, nullable
  - `introduction` string, nullable
  - `streaming` object, nullable
  - `members` union[], nullable
    - union
      - AgentResponse
        - `id` string, nullable
        - `name` string, nullable
        - `db_id` string, nullable
        - `description` string, nullable
        - `role` string, nullable
        - `is_factory` boolean
        - `model` ModelResponse
          - `name` string, nullable — Name of the model
          - `model` string, nullable — Model identifier
          - `provider` string, nullable — Model provider name
        - `tools` object, nullable
        - `sessions` object, nullable
        - `knowledge` object, nullable
        - `memory` object, nullable
        - `reasoning` object, nullable
        - `default_tools` object, nullable
        - `system_message` object, nullable
        - `extra_messages` object, nullable
        - `response_settings` object, nullable
        - `introduction` string, nullable
        - `streaming` object, nullable
        - `metadata` object, nullable
        - `input_schema` object, nullable
        - `factory_input_schema` object, nullable
        - `is_component` boolean
        - `current_version` integer, nullable
        - `stage` string, nullable
      - TeamResponse — recursive
  - `metadata` object, nullable
  - `input_schema` object, nullable
  - `is_factory` boolean
  - `factory_input_schema` object, nullable
  - `is_component` boolean
  - `current_version` integer, nullable
  - `stage` string, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/agno/apis/agno-api-reference.md) · [All operations](https://skmtc.net/agno/apis/agno-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agno/agno-api-reference/revisions/5f6149d395d0/schema)