Teams
Read-only access to the organization's teams and their members and project grants.
A team is a named group of people in the organization. Granting a team access to a project gives every member of that team standard access to it — the team-based equivalent of adding each person individually. A person belongs to at most one team, and a project's effective access is the union of team-granted and individual access.
Team management — creating, renaming, deleting, membership, and project grants — is configured from the organization settings UI. This REST surface is read-only: it exposes the team structure so external tools can mirror it. Write endpoints are intentionally not part of this version.
Endpoints
| Method | Path | Notes |
|---|---|---|
GET | /api/v1/teams | List. Supports query, offset paging. |
GET | /api/v1/teams/{id} | Returns the team plus its members and linked projects. |
Team model (list)
{
"id": "9b1c…",
"name": "Design",
"createdAt": "2026-06-01T08:30:00.000Z",
"updatedAt": "2026-06-19T14:22:11.000Z",
"memberCount": 5,
"projectCount": 3
}| Field | Type | Notes |
|---|---|---|
name | string | 1–60 chars. Unique within the organization. |
memberCount | int | People currently in the team. |
projectCount | int | Projects the team grants access to. |
Listing teams
GET /api/v1/teams?query=design&limit=25&offset=0| Param | Type | Notes |
|---|---|---|
limit | int 1–100 | Default 50. |
offset | int ≥ 0 | Default 0. |
query | string | Case-insensitive search over name. |
Returns { data, total }, ordered by name.
Retrieving a team
GET /api/v1/teams/{id}Returns the team plus a members array (userId, name, email, image) and a projects array (id, name, status, color). A 404 is returned for an unknown id or a team that belongs to another organization.