List Family Members
Lists every person with access anywhere in the family and where that access comes from: members of the primary (who inherit access to every Ringg Space) and people added directly to one or more Ringg Spaces.
GET
List Family Members
List everyone with access anywhere in the family and where that access comes from. Members of the primary inherit access to every Ringg Space; people added directly to a Ringg Space see only that Ringg Space.
When to use
- Access audits across all client or team workspaces.
- Showing who can reach a given Ringg Space in your own admin tool.
Reading the response
scopeisprimaryfor members of the primary (they have inherited access to every current and future Ringg Space) andsubfor people added only to Ringg Spaces.sub_workspace_idslists direct Ringg Space memberships only. Inherited access is not repeated there.permissions_by_workspacegives the effective permissions per workspace id, inherited rows included, so you can render access without re-deriving it.invite_statusissuccessorpending.
Integration notes
- Authenticate with the primary workspace’s API key.
- To add or remove people, use the workspace member endpoints against the relevant workspace; this endpoint is read-only.
Error responses
- 400:
Sub-workspaces cannot have their own sub-workspaces.— the key belongs to a Ringg Space. - 401: Invalid or missing API key.
- 403:
Sub-workspaces are not enabled for this workspace.
Example
Headers
(Required) The API key of the PRIMARY workspace. A Ringg Space's key is refused with 400.
Example:
"7251cb4b-3373-43a4-844c-b27a1d45e0c9"