List All Teams

Team storage and identity

Use the database-backed example Team server. Keep the Team run's returned run_id and session_id; a nested member run is not interchangeable with the Team run. Stored run, checkpoint and session operations require the configured database.

JWT user isolation is opt-in; non-admin service-account PAT callers always self-scope. Scoped callers need their own matching Team session and run, while configured resource authorization also applies. Run and checkpoint lookups return 404 for inaccessible or mismatched records. For factories, retain any factory_input needed by endpoints that reconstruct the Team.

This returns an array of visible Team configurations/metadata, filtered by configured resource access and stored-component visibility. It is not an unrestricted inventory of all database rows.

Current objects use id and nested configuration fields such as tools and members. The generated historical team_id/async_mode examples are not current constructor or response defaults. A factory entry describes construction without instantiating the Team; use Get Team Details for the selected entry.

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

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl --request GET 'https://example.com/teams'
[  {    "team_id": "basic-team",    "name": "Basic Team",    "mode": "coordinate",    "model": {      "name": "OpenAIChat",      "model": "gpt-4o",      "provider": "OpenAI"    },    "tools": [      {        "name": "transfer_task_to_member",        "description": "Use this function to transfer a task to the selected team member.\nYou must provide a clear and concise description of the task the member should achieve AND the expected output.",        "parameters": {          "type": "object",          "properties": {            "member_id": {              "type": "string",              "description": "(str) The ID of the member to transfer the task to. Use only the ID of the member, not the ID of the team followed by the ID of the member."            },            "task_description": {              "type": "string",              "description": "(str) A clear and concise description of the task the member should achieve."            },            "expected_output": {              "type": "string",              "description": "(str) The expected output from the member (optional)."            }          },          "additionalProperties": false,          "required": [            "member_id",            "task_description"          ]        }      }    ],    "members": [      {        "agent_id": "basic-agent",        "name": "Basic Agent",        "model": {          "name": "OpenAIChat",          "model": "gpt-4o",          "provider": "OpenAI gpt-4o"        },        "memory": {          "app_name": "Memory",          "model": {            "name": "OpenAIChat",            "model": "gpt-4o",            "provider": "OpenAI"          }        },        "session_table": "agno_sessions",        "memory_table": "agno_memories"      }    ],    "enable_agentic_context": false,    "memory": {      "app_name": "agno_memories",      "app_url": "/memory/1",      "model": {        "name": "OpenAIChat",        "model": "gpt-4o",        "provider": "OpenAI"      }    },    "async_mode": false,    "session_table": "agno_sessions",    "memory_table": "agno_memories"  }]