---
title: "List a site's collaborators and pending invites"
method: GET
path: "/api/v1/sites/{slug}/members"
tags: ["Members"]
---

# List a site's collaborators and pending invites

`GET /api/v1/sites/{slug}/members`

## Request

- Base URL: `https://api.dotsy.ai`
- URL: `https://api.dotsy.ai/api/v1/sites/{slug}/members`
- Auth: HTTP bearer

The people who were given access to this one site, plus invites nobody has accepted yet. This is the guest list. To see the workspace's own teammates, use `listSiteTeammates`. Needs the site Owner role.

`limit` and `cursor` page `members` only, oldest first. `pendingInvites` always comes back complete.

## Path parameters

- `slug` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

The collaborators and pending invites.

- SiteMemberList
  - `members` SiteMember[], required
    - `userId` string, required
    - `email` string, nullable, required
    - `name` string, nullable, required
    - `role` 'owner' | 'editor' | 'viewer', required
    - `isInternal` boolean, required: True for someone inside your own organization, as opposed to an outside guest.
    - `invitedBy` string, nullable, required: The id of whoever invited them.
    - `createdAt` number, required: When access was granted, Unix ms.
  - `nextCursor` string, nullable: Present only when the request sent `limit`. Pass it as `cursor` (with the same `limit`) for the next page; null on the last page.
  - `pendingInvites` SitePendingInvite[], required: Always the complete list, whatever `limit` says.
    - `id` string, required
    - `email` string, required
    - `role` 'editor' | 'viewer', required
    - `isInternal` boolean, required
    - `invitedBy` string, required
    - `expiresAt` number, required: Unix ms.
    - `createdAt` number, required: Unix ms.

## Other responses

- `400`: `invalid_cursor`: the `cursor` is not one this API returned. Restart the listing without it.
- `401`: Missing or invalid credentials.
- `403`: `forbidden_role`: managing a site's people needs the site Owner role.
- `404`: `site_not_found`: no such site, or it is not visible to this account.

---

[API](https://skmtc.dev/dotsy/apis/dotsy-api.md) · [All operations](https://skmtc.dev/dotsy/apis/dotsy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dotsy/apis/dotsy-api/revisions/4272ed3b85d7?raw)