Get Team Details

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.

Current configuration shape

A regular Team's details use id, nested tool configuration and members. For the example server, the identity fields include {"id":"reference-team","name":"Reference Team"}. Historical generated examples using team_id, async_mode or older flattened transfer-tool arrays do not describe the current TeamResponse shape.

Factories return construction metadata without instantiating a Team. Treat that metadata separately from resolved runtime configuration. A remote Team can forward its remote configuration.

GET/teams/{team_id}

Retrieve detailed configuration and member information for a specific team.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

team_id*Team Id

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl --request GET 'https://example.com/teams/string'
{  "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": "Memory",    "model": {      "name": "OpenAIChat",      "model": "gpt-4o",      "provider": "OpenAI"    }  },  "async_mode": false,  "session_table": "agno_sessions",  "memory_table": "agno_memories"}