Unsorted (new)
The Team tag group exposes the project roster — every human and
agent visible in a project — overlaid with each actor's current
availability and assignments. It is the narrative counterpart to the
Redoc reference for team; request
and response shapes live there.
Typical flow
GET /v1/projects/{project}/team— fetch the project roster. Eachitemsentry is aProjectTeamMembercarryingactor_id,actor_kind,display_name,availability, andassignments.- Narrow the same call with
kind=userorkind=agentwhen you only need one side of the roster. - Filter by
availabilityorassignment_statusto slice on Actor State, or passq(up to 120 characters) to match against the display name.
The response carries a truncated flag. When it is true, more than
500 rows matched the query — tighten your filters before relying on
the result.
Authentication
All operations use the API-wide Bearer scheme described on the API keys page.
Common errors
| Code | Cause | Fix |
|---|---|---|
| 400 | A query parameter is malformed — for example, kind outside the user/agent enum or q over 120 characters. | Drop or correct the offending parameter and retry. |
| 401 | API key is missing or invalid. | Send a valid Authorization: Bearer <key> header. |
| 403 | The key cannot view the requested project. | Use a key whose org scope includes the project. |
| 404 | The {project} handle does not resolve. | Verify the project handle in the path. |
See also
- Actor State API — the source
of
availability,assignment_status, andassignmentsfields surfaced on each team member. - Team Redoc reference — full request and response schemas.