Set Selected Graph
put
/v1/user/selected-graphPart of User.
Remembers the graph as the caller's current one: GET /v1/graphs then reports it as selectedGraphId, and the apps open on it. One graph per user, replacing the previous selection. Only a graph the caller belongs to can be selected; shared repositories cannot be.
Authentication
Authenticate in any one of these ways — not all of them:
- API key in the
X-API-Keyheader. - Bearer token in the
Authorizationheader.
Request body
Required, application/json.
| Field | Type | Description |
|---|---|---|
graph_idrequired | string | The graph the apps open on the caller's next load Constraints: at least 1 character |
Example request
curl
curl -X PUT "https://api.robosystems.ai/v1/user/selected-graph" \
-H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"graph_id": "kg1a2b3c4d5"
}'Responses
200 Successful Response
| Field | Type | Description |
|---|---|---|
successoptional | boolean | Indicates the operation completed successfully Default: |
messagerequired | string | Human-readable success message |
dataoptional | object | Optional additional data related to the operation |
| 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 |