Skip to main content

List User Candidates

GET 
/workspaces/:workspace_id/user-candidates

List users who are not yet members of this workspace.

Accessible to workspace admins of this workspace and platform admins.

Platform admins see every user on the platform. A workspace admin only sees users who share at least one workspace with them — the platform-wide user directory is never exposed to a non-platform-admin. Users already in this workspace are excluded from both.

Returns 404 if the workspace does not exist, and 403 if the caller is not a workspace_admin member of it (or a platform admin).

Request​

Responses​

Successful Response