Skip to main content
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

  • scope is primary for members of the primary (they have inherited access to every current and future Ringg Space) and sub for people added only to Ringg Spaces.
  • sub_workspace_ids lists direct Ringg Space memberships only. Inherited access is not repeated there.
  • permissions_by_workspace gives the effective permissions per workspace id, inherited rows included, so you can render access without re-deriving it.
  • invite_status is success or pending.

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

X-API-KEY
string
required

(Required) The API key of the PRIMARY workspace. A Ringg Space's key is refused with 400.

Example:

"7251cb4b-3373-43a4-844c-b27a1d45e0c9"

Response

Successful Response: The family member matrix.

primary_workspace_id
string
Example:

"2f9a1c44-7e88-4bb1-9a01-5d3c2e7f6a11"

members
object[]