Skip to content

List a team's members

GET
/teams/{id}/members

Returns rows from team_memberships. Membership does NOT propagate to descendants — each member-of-a-team is an explicit join.

id
required
string format: uuid

Members of this team

Array<object>
object
team_id
required
string format: uuid
user_ref
required
integer format: int64
added_at
required
string format: date-time
added_by_user_ref
integer format: int64
nullable
username

The member’s username. Added for the team page’s member strip (#684) — without it a client can only render the ref, and resolving names would be one request per member.

string
display_name

The member’s profile display name, or null when they have no profile row. A client should fall back to username.

string
nullable

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed