latestOpenAPI 3.1.02026-08-223391355.6 KB

aa8d44585147

members-access

List workspace members

Plan: Enterprise

Returns a paginated list of workspace members, filtered by role and status.

get/v1/workspaces/{workspace_id}/members

Path parameters

workspace_idstring required

Workspace ID

Workspace ID

Query parameters

limitinteger

Maximum results per page.

Maximum results per page.

cursorstring

Opaque cursor from a prior response. Omit on the first page.

Opaque cursor from a prior response. Omit on the first page.

querystring

Substring filter applied to display name, username, and email tokens (matching the workspace member search backend).

Substring filter applied to display name, username, and email tokens (matching the workspace member search backend).

rolesstring

Comma-separated role filter. Valid values: owner, admin, member, viewer, collaborator. Empty = all roles. Unknown values return 400.

Comma-separated role filter. Valid values: owner, admin, member, viewer, collaborator. Empty = all roles. Unknown values return 400.

status'all' | 'active' | 'pending'

Filter by membership status. Default 'active' excludes pending invites.

Filter by membership status. Default 'active' excludes pending invites.

sort_by'name' | 'joined_at' | 'role' | 'relevance'

Sort field. Defaults to relevance when query is set, otherwise role + recency.

Sort field. Defaults to relevance when query is set, otherwise role + recency.

sort_order'asc' | 'desc'

Sort direction. Only applied when sort_by is set; the default-sort case has a fixed direction baked into the underlying query.

Sort direction. Only applied when sort_by is set; the default-sort case has a fixed direction baked into the underlying query.

scim_managed'managed' | 'unmanaged'

Filter by SCIM provisioning status. Empty = all members, 'managed' = only SCIM-provisioned members, 'unmanaged' = only members not managed by SCIM.

Filter by SCIM provisioning status. Empty = all members, 'managed' = only SCIM-provisioned members, 'unmanaged' = only members not managed by SCIM.

Response

OK