Elizon Docs
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

StatuserrorWhen
403forbiddenThe team belongs to a different project than your project-scoped key.
404team_not_foundNo team with that ID exists in your organization.

On this page