API Reference
List teams
GET /api/v1/teams — list the teams your API key can see.
GET /api/v1/teamsQuery parameters
| Parameter | Type | Description |
|---|---|---|
page | integer ≥ 1 | Default 1. |
limit | integer 1–100 | Default 20. |
status | active | paused | draft | archived | Only teams with this status. |
coordination_mode | handoff | dynamic_delegation | parallel | plan_execute | Only teams with this mode. |
project_ref_id | string (UUID) | Org-scoped keys: only teams in this project. A project-scoped key always lists its own project and ignores this. |
Response
200 OK, newest first. Each item has the shape of Get team, with members and without currentVersion.
{
"data": [
{
"teamId": "3f9c...",
"name": "Escalations",
"coordinationMode": "dynamic_delegation",
"...": "..."
}
],
"total": 1,
"page": 1,
"limit": 20
}Errors
| Status | error | When |
|---|---|---|
400 | validation error | A query parameter fails validation. |
422 | project_not_found | project_ref_id is not a project of your organization. |
Example
curl "https://api.elizon.ai/api/v1/teams?status=active" \
-H "X-API-Key: elz_your_key_here"