Browse the API reference

Revoke Connected App

delete/v1/user/oauth/grants/{grant_id}

Part of User.

Revokes the grant and every access and refresh token minted from it. The client's next request fails with 401 and it must ask the user to authorize again. Revoking an already revoked grant succeeds and changes nothing.

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
`grant_id`required	string	Grant Id

Example request

curl

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

Responses

200 Successful Response

Field Type Description

Field	Type	Description
`success`optional	boolean	Indicates the operation completed successfully Default: `true`
`message`required	string	Human-readable success message
`data`optional	object	Optional additional data related to the operation

successoptional

boolean

Indicates the operation completed successfully

Default: true

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