Browse the API reference

List Connected Apps

get/v1/user/oauth/grants

Part of User.

Every MCP client the user has authorized through OAuth, with the one graph each connection reaches. Active grants only: a revoked grant cannot be reinstated, so it leaves the list.

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.

Example request

curl

curl -X GET "https://api.robosystems.ai/v1/user/oauth/grants" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY"

Responses

200 Successful Response

Field Type Description

grantsrequired

OAuthGrantInfo[]

Active OAuth grants, newest first

OAuthGrantInfo fields

Field	Type	Description
`id`required	string	Grant ID
`client_name`required	string	The connected client's display name
`client_uri`optional	string	The client's homepage, if declared
`client_is_trusted`required	boolean	Whether the client is on the trusted list (pre-registered, or a known metadata-document host). Untrusted clients registered themselves.
`graph_id`required	string	The one graph this consent reaches
`graph_name`optional	string	The graph's display name, when the graph still exists
`resource`required	string	The MCP URL the grant's tokens are bound to (their audience)
`scope`required	string	Granted scopes, space-separated
`created_at`required	string	When the user consented
`last_used_at`optional	string	Last token use, if any

Status	Meaning
400	Invalid request
401	Authentication required
403	Access denied
429	Rate limit exceeded
500	Internal server error