---
title: "List team members"
method: GET
path: "/members"
tags: ["Team"]
---

# List team members

`GET /members`

## Request

- Base URL: `https://api.rizamo.com/v1`
- URL: `https://api.rizamo.com/v1/members`
- Auth: HTTP bearer

The team's people who share a profile with you, or reach every profile, with their profiles narrowed to yours: whom to assign an inbox thread to. No emails. People are invited, changed and removed by owners in the web app.

## Response `200`

OK

- object
  - `items` Teammate[], required
    - `id` string, required: Their user id (`user_`): the `assigneeId` that hands them a thread.
    - `name` string, required
    - `role` 'owner' | 'editor' | 'viewer', required: owner and editor answer and change things; viewer only reads.
    - `profileIds` string[], nullable, required: The profiles they reach, of those you reach. Null: every profile. A thread goes only to someone who reaches its profile.

## Other responses

- `401`: `unauthorized`: No API key or sign-in, or the key does not work: it was deleted, or it expired.
- `403`: `forbidden`: The caller may not do this: the key or agent lacks the scope (the message names it), or the action needs another role or a fresh sign-in.
- `429`: `rate_limited`: Over one of Rizamo's limits, or a network asked Rizamo to slow down: wait for `Retry-After` seconds, or as long as the message says.
- `500`: `internal`: Our side failed: retry, and send the `requestId` if it keeps failing.
- `503`: `timeout`: The request took too long to work out, most often a report: try again in a moment, or ask a report for a shorter period or one profile.

---

[API](https://skmtc.dev/rizamo/apis/rizamo-api.md) - [All operations](https://skmtc.dev/rizamo/apis/rizamo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rizamo/apis/rizamo-api/revisions/31b0c1b1ffb5?raw)
