AuralisDocs
OperationsWorkspace administration

List members with their roles and account status

Everyone in this workspace, ordered by role from owner down.

/v1/workspace/membersViewer
Operation id
list_workspace_members
Access
Any workspace role can call this.
GET/v1/workspace/members

Everyone in this workspace, ordered by role from owner down.

This is the members screen. Each row carries the workspace role, the person's account status, when they last signed in and when they were created.

role is what they may do here. status is about the account itself, so a suspended member keeps their role and cannot use it.

Someone invited but not yet joined is not in this list. Invitations are a separate collection.

Tenancy: the request is scoped to one workspace, and the credential presented is what selects it. A caller with no membership in that workspace is refused with 404, which is indistinguishable from a workspace that does not exist.

Authorisation: any workspace role, including viewer. Reads are open to every member.

Access: Authorization: Bearer carrying either a realm access token or an API key. A key must hold the workspace-admin:read scope, and the workspace role of the person who owns it must meet the floor above.

Authorization

AuthorizationBearer <token>

A realm-issued access token, presented as Authorization: Bearer <token>. It acts as the person who signed in, and every operation resolves their workspace role live from the membership record.

In: header

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/workspace/members"
{}