Browse the API reference

Update Graph Member Role

put/v1/graphs/{graph_id}/members/{user_id}

Change an explicit member's graph role. Requires graph admin. Implicit org owner/admin access is managed through org roles.

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

Name	Type	Description
`user_id`required	string	User Id
`graph_id`required	string	Graph identifier

Request body

Required, application/json.

Field Type Description

Field	Type	Description
`role`required	GraphRole	Ordered per-graph roles: viewer < member < admin. One of: `viewer`, `member`, `admin`

rolerequired

GraphRole

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

One of: viewer, member, admin

Example request

curl

curl -X PUT "https://api.robosystems.ai/v1/graphs/{graph_id}/members/{user_id}" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "role": "string"
}'

Responses

200 Successful Response

Field	Type	Description
`user_id`required	string
`name`required	string
`email`required	string
`role`required	GraphRole	Ordered per-graph roles: viewer < member < admin. One of: `viewer`, `member`, `admin`
`source`required	string	'explicit' for a direct grant; 'org_role' for implicit admin held by org owners/admins One of: `explicit`, `org_role`
`granted_at`optional	string (date-time)	When the explicit grant was created (null for implicit access)

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