---
title: "Revoke OAuth grant"
method: DELETE
path: "/oauth/grants/{id}"
tags: ["OAuth Grants"]
---

# Revoke OAuth grant

`DELETE /oauth/grants/{id}`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/oauth/grants/{id}`
- Auth: HTTP bearer

Revokes the specified OAuth grant, withdrawing the access previously granted to the client.

## Path parameters

- `id` string, uuid, required

## Response `200`

OAuth grant revoked successfully

- object
  - `data` OAuthGrant
    - `id` string, uuid, required: Unique identifier for the OAuth grant
    - `record_type` 'oauth_grant', required: Record type identifier
    - `client_id` string, required: OAuth client identifier
    - `scopes` string[], required: List of granted OAuth scopes
    - `last_used_at` string, date-time, nullable: Timestamp when the grant was last used
    - `created_at` string, date-time, required: Timestamp when the grant was created

## Other responses

- `404`: OAuth grant not found

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/oauth/grants/:id/delete.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)