List members

View as MarkdownOpen in Claude
Lists the members of the space, optionally filtered by role. Results are paged; follow the `links.next` URL for the next page, which carries the filter and the `page_token` for you. A member who has been invited but has not accepted appears with `activated: false`. #### Permissions Authenticate with a [Personal access token](/docs/apis/authorization#personal-access-tokens) whose holder is an owner or admin of the space. A project API token is not accepted on this endpoint, and a Personal access token has no scopes: the holder's role in the space is the whole authorization decision.

Authentication

AuthorizationBasic
Personal access token authentication for space-wide administration. Send HTTP Basic auth with an empty username and the Personal access token as the password. A Personal access token carries your own authority rather than a project's: it is created from your user menu in the Dashboard, is prefixed `pat_`, and has no scopes. The holder must be an owner or admin of the space named by the subdomain, and the token acts only on that space. Example: ``` Authorization: Basic base64(:pat_...) ```

Query parameters

roleenumOptional

Return only members with this role. An unknown value is rejected with unknown_role.

Allowed values:
page_sizeintegerOptional1-1000Defaults to 50
The number of results per page.
page_numberintegerOptional>=0Defaults to 0

The page index. Any value above 0 also requires page_token.

page_tokenstringOptional

The cursor for any page after the first, taken from the links.next URL of the previous response.

Response

The request has succeeded.
datalist of objects
The members on this page.

Errors

401
Unauthorized Error
422
Unprocessable Entity Error
500
Internal Server Error