Home

Awesome

GitHub's REST API OpenAPI Description

This repository contains OpenAPI descriptions for GitHub's REST API.

What is OpenAPI?

From the OpenAPI Specification:

The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

Project Status

As of the 1.1.4 release, this description is considered stable and generally available.

The descriptions folder contains the 3.0 version of the description. The descriptions-next folder contains the 3.1 version of the description, and is subject to breaking changes on the main branch.

Description Formats

Each OpenAPI document is available in two formats: bundled and dereferenced.

Vendor Extensions

We use various vendor extensions for concepts that are harder to express with OpenAPI components and/or are specific to GitHub. For more information on the extensions used in these description, check out extensions.md

Limitations

Contributing

Because this description is used across GitHub's whole API development experience, we don't currently accept pull requests that directly modify the description. This repository is automatically kept up to date with the description used to validate GitHub API requests as well as powering contract tests. See CONTRIBUTING.md for more details.

If you've identified a mismatch between GitHub API's behavior and these descriptions, or found an issue with the format of a schema, please open an issue.

License

github/rest-api-description is licensed under the MIT license

Contact

You may contact opensource+rest-api-description@github.com with any questions related to this repository.