> ## Documentation Index
> Fetch the complete documentation index at: https://wordsmithai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List support members

> List the Wordsmith engineers who have a support member in your organisation.

A support member is a user in your organisation that belongs to one named Wordsmith engineer. It holds no role of its own, so it can see nothing until your organisation approves a [support access grant](https://wordsmithai.mintlify.site/api-reference/support-access/list-support-grants.md) for it. Suspended support members are included.

`sign_in_mode` is `customer_identity` when the engineer signs in through your own identity provider with `email`, or `wordsmith_driven` when Wordsmith staff reach it only by acting on behalf of it. Adding and removing support members happens in the web app.

## Authentication

Requires an API key, or an OAuth token with `directory:admin`. `directory:admin` is never granted by default. The caller must also hold a role with the view support access permission; the predefined admin role holds both. A Wordsmith support member is always refused, whatever role it holds. Support access must be turned on for your organisation.

## Query parameters

**cursor** `string`

The `cursor` from the previous page.

**limit** `integer` (default: 50)

Support members per page, up to 200.

## Response

Returns `200` with a page of support members.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.wordsmith.ai/api/v1/support-access/members" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"
```

```json Response theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "items": [
    {
      "id": "5b0e6f1e-8a43-4f0e-9d0a-3e2c51f8a7b4",
      "name": "Wordsmith support – Alex Morgan",
      "email": "alex.morgan.guest@example.com",
      "sign_in_mode": "customer_identity",
      "engineer_name": "Alex Morgan",
      "engineer_email": "alex.morgan@wordsmith.ai",
      "is_suspended": false,
      "created_at": "2026-11-10T09:00:00Z"
    }
  ],
  "cursor": null
}
```

## Errors

| Status | `error_code` | When |
| - | - | - |
| 403 | `insufficient_scope` | The OAuth token does not hold `directory:admin`. |
| 403 | `forbidden` | The caller lacks the support access permission, is a Wordsmith support member, or support access is off for your organisation. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.