list_team_members

List collaborators on a team. Owner pseudo-row is prepended; role_id is null for the owner.

Purpose

List the collaborators on a team — the owner pseudo-row is prepended to every pivot member. role_id is null for the owner. Emails are surfaced verbatim because team members are internal collaborators, not subscribers.

Required ability

team-member:view-any

Input schema

{
  "type": "object",
  "required": ["team_id"],
  "properties": {
    "team_id": {
      "type": "string",
      "description": "UUID of the team whose members to list."
    }
  }
}

Output shape

{
  "data": [
    {
      "id": "usr_01HX...",
      "team_id": "tem_01HX...",
      "name": "Priya Patel",
      "email": "[email protected]",
      "role_id": null,
      "is_owner": true,
      "joined_at": "2026-04-02T14:15:00Z"
    }
  ],
  "meta": { "total": 3 }
}

Example prompts

"Who is on team tem_01HX...?"

"List collaborators on my Research Studio team."

Failure modes

RESOURCE_NOT_FOUND — team_id is not a valid UUID, or the team falls outside the caller's visibility set.
AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks team-member:view-any.

get_team
list_teams
list_roles — resolve role_id to permission sets.
Team Members API