API Reference
Get team
GET /api/v1/teams/:teamId — one team, with its members.
GET /api/v1/teams/{teamId}Response
200 OK
{
"teamId": "3f9c...",
"name": "Escalations",
"description": null,
"goal": "Resolve escalated tickets.",
"instructions": null,
"status": "active",
"projectId": "2b7e...",
"coordinationMode": "dynamic_delegation",
"leadType": "managed",
"leadLlmConfigId": "8b1e...",
"leadModelId": "gpt-4o",
"leadInstructions": null,
"leadMemberAgentId": null,
"leadMemberDelegateEligible": true,
"leadMemberCanAnswerDirectly": false,
"determineInputForMembers": true,
"addTeamHistoryToMembers": false,
"shareMemberInteractions": false,
"addNameToContext": true,
"addDatetimeToContext": false,
"addHistoryToContext": false,
"numHistoryRuns": 3,
"maxIterations": null,
"budgetCapJson": null,
"policyJson": null,
"members": [
{
"agentId": "a1...",
"agentName": "Billing",
"role": null,
"sortOrder": 0,
"delegateEligible": true
},
{
"agentId": "a2...",
"agentName": "Technical",
"role": null,
"sortOrder": 1,
"delegateEligible": true
}
],
"currentVersion": 3,
"createdAt": "2026-10-01T00:00:00.000Z",
"updatedAt": "2026-10-01T00:00:00.000Z"
}Every field except teamId, members[].agentName, currentVersion, createdAt and updatedAt can be set with Create team and Update team. What the settings do is described in Teams. currentVersion counts saved configurations: every create and update saves one, the same history Studio's Team Builder shows.
Errors
| Status | error | When |
|---|---|---|
403 | forbidden | The team belongs to a different project than your project-scoped key. |
404 | team_not_found | No team with that ID exists in your organization. |