Teams

List members

List the members of a team.

GET /teams/{teamId}/members

Returns the members of a team, oldest first. Requires at least the viewer role.

Authentication: Bearer token · Role: viewer · Permission:teams:read · Rate limit: default (120 / 60s)

Path parameters

teamId

string · uuid v7 required

The ID of the team.

Request

curl https://api.twominutereports.com/v1/teams/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/members \
  -H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response

{
  "success": true,
  "data": [
    {
      "id": "0190f8a1-2b3c-7d4e-8f90-1a2b3c4d5e6f",
      "name": "Ada Lovelace",
      "email": "[email protected]",
      "avatarUrl": "https://assets.gox.ai/tmr/avatars/ada.png",
      "role": "owner",
      "joinedAt": "2026-01-12T08:15:00.000Z"
    },
    {
      "id": "0190f8a4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "name": "Grace Hopper",
      "email": "[email protected]",
      "avatarUrl": null,
      "role": "editor",
      "joinedAt": "2026-02-01T10:00:00.000Z"
    }
  ]
}

{
  "success": false,
  "error": { "code": "BAD_REQUEST", "message": "Invalid UUID: \"abc\"" }
}

{
  "success": false,
  "error": { "code": "FORBIDDEN", "message": "You do not have permission to perform this action" }
}

The member object

string · uuid v7

The member's user ID. Use it as userId in update role and remove member.

name

string | null

The member's full name, or null if not set.

string

The member's email address.

avatarUrl

string | null

The member's avatar image URL, or null if they have not set one.

role

string

One of viewer, editor, owner.

joinedAt

string

When the member joined the team.

Update team name

Rename a team.

Update member role

Change a team member's role.