# Delete an app authorization

From **GitHub v3 REST API**.

`DELETE /applications/{client_id}/grant`

OAuth application owners can revoke a grant for their OAuth application and a specific user. You must use [Basic Authentication](https://docs.github.com/enterprise-server@3.0/rest/overview/other-authentication-methods#basic-authentication) when accessing this endpoint, using the OAuth application's `client_id` and `client_secret` as the username and password. You must also provide a valid OAuth `access_token` as an input parameter and the grant for the token's owner will be deleted.
Deleting an OAuth application's grant will also delete all OAuth tokens associated with the application for the user. Once deleted, the application will have no access to the user's account and will no longer be listed on [the application authorizations settings screen within GitHub](https://github.com/settings/applications#authorized).

## Parameters

### `client_id`

- Location: path
- Required: true
- Type: `string`

The client ID of your GitHub app.

## Request body

- Required: true
### `application/json`

- Type: `object`

```json
{
  "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a"
}
```

```json
{"properties":{"access_token":{"description":"The OAuth access token used to authenticate to the GitHub API.","type":"string"}},"required":["access_token"],"type":"object"}
```

## Responses

### `204`

Response

### `422`

Validation failed

### `application/json`

- Type: `object`

Validation Error

```json
{"description":"Validation Error","properties":{"documentation_url":{"type":"string"},"errors":{"items":{"properties":{"code":{"type":"string"},"field":{"type":"string"},"index":{"type":"integer"},"message":{"type":"string"},"resource":{"type":"string"},"value":{"oneOf":[{"nullable":true,"type":"string"},{"nullable":true,"type":"integer"},{"items":{"type":"string"},"nullable":true,"type":"array"}]}},"required":["code"],"type":"object"},"type":"array"},"message":{"type":"string"}},"required":["message","documentation_url"],"title":"Validation Error","type":"object"}
```

## Request examples

### cURL

```shell
curl --request DELETE \
  --url {protocol}://{hostname}/api/v3/applications/{client_id}/grant \
  --header 'content-type: application/json' \
  --data '{
  "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a"
}'
```