---
title: "Revoke Connected App"
method: DELETE
path: "/v1/user/oauth/grants/{grant_id}"
tags: ["User"]
---

# Revoke Connected App

`DELETE /v1/user/oauth/grants/{grant_id}`

## Request

- Base URL: `https://api.robosystems.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.robosystems.ai/v1/user/oauth/grants/{grant_id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

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.

## Path parameters

- `grant_id` string, required

## Response `200`

Successful Response

- SuccessResponse: Standard success response for operations without specific return data.
  - `success` boolean: Indicates the operation completed successfully
  - `message` string, required: Human-readable success message
  - `data` object, nullable: Optional additional data related to the operation

## Other responses

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

---

[API](https://skmtc.dev/robosystems/apis/robosystems-api.md) · [All operations](https://skmtc.dev/robosystems/apis/robosystems-api/llms.txt) · [OpenAPI document](https://skmtc.dev/robosystems/apis/robosystems-api/revisions/e661e2d5ca6a?raw)
