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

# List team members

`GET /team-members`

## Request

- Base URL: `https://joinways.app/api/v1`
- URL: `https://joinways.app/api/v1/team-members`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://joinways.app/oauth/authorize`, token URL `https://joinways.app/api/oauth/token`, scopes: `mcp.read`)

Members of the workspace with their role. A member is identified by `user_id` (the value to pass as `assigned_to_account_id`); `account_id` is the workspace. Not paginated. **Role permission:** none (any member).

## Response `200`

Members of the workspace.

- object
  - `members` TeamMember[], required
    - `user_id` string, uuid: The member (value of `assigned_to_account_id`).
    - `account_id` string, uuid: The workspace.
    - `role` string
    - `role_hierarchy_level` integer: 1 = owner; lower is higher.
    - `is_primary_owner` boolean
    - `name` string, nullable
    - `email` string, nullable
    - `picture_url` string, nullable

## Other responses

- `401`: Missing, invalid, expired or revoked bearer token (`unauthorized`).
- `429`: Too many requests (`rate_limited`). `details.reason`: `per-ip`, `per-account-minute`, `per-account-day`, or `email_rate_limited` (email budget). Always carries `Retry-After`: wait that many seconds.

---

[API](https://skmtc.dev/joinways/apis/joinways-public-api.md) · [All operations](https://skmtc.dev/joinways/apis/joinways-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/joinways/apis/joinways-public-api/revisions/39e84309953e?raw)