Browse the API reference

List Graph Members

get/v1/graphs/{graph_id}/members

Part of Graph Members.

All users with access to the graph: explicit grants plus org owners/admins who hold implicit admin. Requires graph admin.

Authentication

Authenticate in any one of these ways — not all of them:

  • API key in the X-API-Key header.
  • Bearer token in the Authorization header.

Path parameters

NameTypeDescription
graph_idrequiredstringGraph identifier

Example request

curl
curl -X GET "https://api.robosystems.ai/v1/graphs/{graph_id}/members" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY"

Responses

200 Successful Response

FieldTypeDescription
membersrequiredGraphMemberResponse[]

A user with access to a graph.

GraphMemberResponse fields
FieldTypeDescription
user_idrequiredstring
namerequiredstring
emailrequiredstring
rolerequiredGraphRole

Ordered per-graph roles: viewer < member < admin.

One of: viewer, member, admin

sourcerequiredstring

'explicit' for a direct grant; 'org_role' for implicit admin held by org owners/admins

One of: explicit, org_role

granted_atoptionalstring (date-time)

When the explicit grant was created (null for implicit access)

totalrequiredinteger
graph_idrequiredstring
StatusMeaning
400Invalid request
401Authentication required
403Access denied
404Resource not found
422Validation Error
429Rate limit exceeded
500Internal server error