GitHub

GitHub Oauth-Authorizations API

OAuth Authorizations API

GitHub OpenAPI
Business capability
Identity & Access Management BC-620.20

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /applications/grants List the OAuth apps I've granted access · GitHub List Your Grants #
Ask an LLM
“Which OAuth applications have I granted access to my account?”
“Can I list my grants for just one OAuth app client ID?”
Tell an agent
List all OAuth grants on my account.
Show my OAuth grants for client ID {client_id}.
GET /applications/grants/{grant_id} Get one OAuth grant · GitHub Get a Single Grant #
Ask an LLM
“What scopes did I grant a particular OAuth app?”
“Can I look up a single application grant by its ID?”
Tell an agent
Get OAuth grant {grant_id}.
Show the app and scopes behind grant {grant_id}.
DELETE /applications/grants/{grant_id} Revoke an OAuth grant and its tokens · GitHub Delete a Grant #
Ask an LLM
“How do I cut off an OAuth app's access to my account entirely?”
“Does deleting a grant also revoke all of that app's tokens for me?”
Tell an agent destructive · confirm first
Delete OAuth grant {grant_id}.
Revoke application grant {grant_id} and every token under it.
GET /authorizations List my OAuth authorizations · GitHub List Your Authorizations #
Ask an LLM
“What OAuth tokens and authorizations exist on my account?”
“Can I filter my authorizations down to one OAuth app?”
Tell an agent
List my OAuth authorizations.
Show my authorizations created for OAuth client {client_id}.
POST /authorizations Create a new OAuth authorization (deprecated) · GitHub Create a New Authorization #
Ask an LLM
“Can I still create a personal token through the OAuth Authorizations API?”
“What should I use instead now that creating authorizations is deprecated?”
Tell an agent
Create an OAuth authorization with scopes {scopes} and note {note}.
Create a new authorization for client {client_id} using secret {client_secret} with fingerprint {fingerprint}.
PUT /authorizations/clients/{client_id} Get or create an authorization for an OAuth app · GitHub Get-or-create an Authorization for a Specific App #
Ask an LLM
“Can I reuse an existing authorization for an OAuth app instead of making a duplicate?”
“What happens if an authorization for this app client already exists?”
Tell an agent
Get or create an authorization for app {client_id} using secret {client_secret}.
Ensure an authorization exists for client {client_id} with secret {client_secret} and scopes {scopes}.
PUT /authorizations/clients/{client_id}/{fingerprint} Get or create an app authorization by fingerprint · GitHub Get-or-create an Authorization for a Specific App and Fingerprint #
Ask an LLM
“Can I keep separate authorizations for the same app per device using a fingerprint?”
“How does the fingerprint distinguish authorizations for one client ID?”
Tell an agent
Get or create the authorization for app {client_id} and fingerprint {fingerprint} using secret {client_secret}.
Ensure a per-device authorization tagged {fingerprint} exists for client {client_id} (secret {client_secret}).
GET /authorizations/{authorization_id} Get one OAuth authorization · GitHub Get a Single Authorization #
Ask an LLM
“What scopes and note are attached to one of my authorizations?”
“Can I look up a single OAuth authorization by its ID?”
Tell an agent
Get OAuth authorization {authorization_id}.
Show the scopes and note on authorization {authorization_id}.
PATCH /authorizations/{authorization_id} Change an OAuth authorization's scopes or note · GitHub Update an Existing Authorization #
Ask an LLM
“Can I add a scope to an existing authorization without recreating it?”
“How do I drop a scope from one of my OAuth authorizations?”
Tell an agent
Add scopes {add_scopes} to authorization {authorization_id}.
Remove scopes {remove_scopes} from authorization {authorization_id}.
DELETE /authorizations/{authorization_id} Delete an OAuth authorization · GitHub Delete an Authorization #
Ask an LLM
“How do I revoke one specific OAuth authorization on my account?”
“Is deleting a single authorization different from deleting the whole grant?”
Tell an agent destructive · confirm first
Delete OAuth authorization {authorization_id}.
Revoke the single authorization {authorization_id} from my account.

Documentation

📖
Documentation
https://docs.github.com/en/rest/apps
📖
Documentation
https://docs.github.com/en/rest/codes-of-conduct/codes-of-conduct
📖
Documentation
https://docs.github.com/en/rest/emojis
📖
Documentation
https://docs.github.com/en/rest/gitignore
📖
Documentation
https://docs.github.com/en/rest/apps/installations
📖
Documentation
https://docs.github.com/en/rest/enterprise-admin
📖
Documentation
https://docs.github.com/en/rest/activity/events
📖
Documentation
https://docs.github.com/en/rest/orgs
📖
Documentation
https://docs.github.com/en/rest/rate-limit
📖
Documentation
https://docs.github.com/en/enterprise-cloud@latest/rest/scim
📖
Documentation
https://docs.github.com/en/rest/using-the-rest-api/getting-started-with-the-rest-api
📖
Documentation
https://docs.github.com/en/rest/teams
📖
Documentation
https://docs.github.com/en/rest/meta/meta
📖
Documentation
https://docs.github.com/en/rest/actions
📖
Documentation
https://docs.github.com/en/rest/branches
📖
Documentation
https://docs.github.com/en/rest/code-scanning
📖
Documentation
https://docs.github.com/en/rest/collaborators
📖
Documentation
https://docs.github.com/en/rest/dependabot
📖
Documentation
https://docs.github.com/en/rest/webhooks
📖
Documentation
https://docs.github.com/en/rest/pulls
📖
Documentation
https://docs.github.com/en/rest/git/tags
📖
Documentation
https://docs.github.com/en/rest/repos/autolinks
📖
Documentation
https://docs.github.com/en/rest/collaborators/invitations

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/openapi/github-oauth-authorizations-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/asyncapi/github-webhooks-asyncapi.yml

Other Resources

🔗
Reference
https://docs.github.com/en/webhooks/webhook-events-and-payloads

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/github-oauth-authorizations-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

github-oauth-authorizations-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.1.4
  title: GitHub v3 REST OAUTH Authorizations API
  description: GitHub's v3 REST API.
  license:
    name: MIT
    url: https://spdx.org/licenses/MIT
  termsOfService: https://docs.github.com/articles/github-terms-of-service
  contact:
    name: Support
    url: https://support.github.com/contact?tags=dotcom-rest-api
  x-github-plan: ghes
  x-github-release: 3.9
servers:
- url: '{protocol}://{hostname}/api/v3'
  variables:
    hostname:
      description: Self-hosted Enterprise Server hostname
      default: HOSTNAME
    protocol:
      description: Self-hosted Enterprise Server protocol
      default: http
tags:


# --- truncated at 32 KB (60 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/openapi/github-oauth-authorizations-api-openapi.yml