This version of GitHub Enterprise was discontinued on 2022-06-03. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.
We've recently moved some of the REST API documentation. If you can't find what you're looking for, you might try the Actions REST API page.
GitHub Enterprise administration
Endpoint URLs
REST API endpoints—except Management Console API endpoints— are prefixed with the following URL:
http(s)://[hostname]/api/v3
Management Console API endpoints are only prefixed with a hostname:
http(s)://hostname/
Authentication
Your GitHub Enterprise Server installation's API endpoints accept the same authentication methods as the GitHub.com API. You can authenticate yourself with OAuth tokens (which can be created using the Authorizations API) or basic authentication.
OAuth tokens must have the site_admin OAuth scope when used with Enterprise-specific endpoints.
Enterprise administration API endpoints are only accessible to authenticated GitHub Enterprise Server site administrators, except for the Management Console API, which requires the Management Console password.
Version information
The current version of your enterprise is returned in the response header of every API:
X-GitHub-Enterprise-Version: enterprise-server@3.1.0
You can also read the current version by calling the meta endpoint.
- Users
- List public keys
- Delete a public key
- List personal access tokens
- Delete a personal access token
- Create a user
- Update the username for a user
- Delete a user
- Create an impersonation OAuth token
- Delete an impersonation OAuth token
- Promote a user to be a site administrator
- Demote a site administrator
- Suspend a user
- Unsuspend a user
