Browse the API reference

Add Graph Member

post/v1/graphs/{graph_id}/members

Grant a member of the graph's organization access at a chosen role. 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

Name	Type	Description
`graph_id`required	string	Graph identifier

Request body

Required, application/json.

Field Type Description

Field	Type	Description
`user_id`required	string	User to grant access to (must belong to the graph's organization)
`role`optional	GraphRole	Graph role: viewer (read-only), member (read/write), admin (full control) One of: `viewer`, `member`, `admin` Default: `member`

user_idrequired

string

User to grant access to (must belong to the graph's organization)

roleoptional

GraphRole

Graph role: viewer (read-only), member (read/write), admin (full control)

One of: viewer, member, admin

Default: member

Example request

curl

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

Responses

201 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