DELETE/applications/{client_id}/grant

Delete an app authorization

OAuth and GitHub application owners can revoke a grant for their application and a specific user. You must provide a valid OAuth access_token as an input parameter and the grant for the token's owner will be deleted. Deleting an 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.

RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 1 body field

client_idstringrequired

The client ID of the GitHub app.

access_tokenstringrequired

The OAuth access token used to authenticate to the GitHub API.

2 status codes

204Response

422Validation failed, or the endpoint has been spammed.

messagestringrequired

documentation_urlstringrequired

errorsarray<object>optional

Error handling

A 422 is returned: Validation failed, or the endpoint has been spammed.

import { Client } from "acme-sdk";

const client = new Client({
  baseUrl: "https://api.acme.com",
  auth: { bearer: process.env.API_TOKEN },
  retry: {
    maxAttempts: 3,
    retryOn: [
      408,
      425,
      429,
      500,
      502,
      503,
      504,
    ],
    backoffMs: 500,
    maxBackoffMs: 8000,
  },
  timeoutMs: 30000,
});

const result = await client.grant.delete({
  clientId: "c0a80123-4567-89ab-cdef-0123456789ab",
  accessToken: "sk_live_4eC39Hq",
});

{
  "message": "This is an example message.",
  "documentation_url": "https://example.com",
  "errors": [
    {
      "resource": "example_value",
      "field": "example_value",
      "message": "This is an example message.",
      "code": "123456",
      "index": 1,
      "value": "example_value"
    }
  ]
}

Request

Response

Errors