Members

Network members (role/status management)

List the members of a network

Returns the network's members, each with its role and status. Requires at least read-only access. Results are cursor-paginated and ordered by member id. Pass ?expand=user to inline each member's user profile in the response.

Add an existing user to the network with a role

Adds an already-existing user to the network with the given role (admin or viewer), creating an immediately active membership; this does not send an email (use the invitation endpoints to onboard someone by email). Requires the administrator role, and a caller may not grant a role higher than its own (403). Returns 400 if the user does not exist and 409 if they are already a member.

Get a single network member

Returns one member of the network by user id. Requires at least read-only access. Pass ?expand=user to inline the member's user profile. Responds with 404 if the user is not a member of this network.

Remove a member from the network

Removes a member's membership from the network. Requires the administrator role. Removing the last active admin is blocked and returns 409 (as is a version conflict). On success returns 204 with no body.

Change a member's role and/or status

Updates a member's role (admin/viewer) and/or status (active/pending/suspended); at least one of the two must be provided. Requires the administrator role, and a caller cannot grant a role higher than its own (403). Demoting, suspending, or otherwise removing the last active admin is blocked and returns 409, as does a version conflict.