# @github/openapi > OpenAPI schema for GitHub's REST API Latest version **5.7.2** (published 2020-10-16) · MIT license · 0 weekly downloads > **Deprecated.** This package is deprecated. ## Install ```sh npm install @github/openapi pnpm add @github/openapi yarn add @github/openapi bun add @github/openapi ``` ## Health **Score 10/100 (F)** — status: deprecated. Negative: deprecated. ## Facts | | | |---|---| | Version | 5.7.2 | | Published | 2020-10-16 | | First published | 2020-01-09 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | CommonJS | | Node | >=12 | | Dependencies | 8 | | Unpacked size | 57.4 MB | | Known vulnerabilities | 0 (+1 in 1 direct dependencies) | | Install scripts | no | | Author | Roman Hotsiy | | Maintainers | colebemis, anuraag016, zeke, lgarron, emilybrick, emplums, dgraham, jonrohan, broccolini, mislav, mdo, muan, primer-css, keithamus, mschoening, koddsson | | Keywords | openapi, github | ## Links - npm: https://www.npmjs.com/package/@github/openapi - Repository: https://github.com/github/openapi - Homepage: https://github.com/github/openapi#readme - Issues: https://github.com/github/openapi/issues - npm.io page: https://npm.io/package/@github/openapi ## Dependencies (8) - [ajv](https://npm.io/package/ajv.md) ^6.10.2 - [got](https://npm.io/package/got.md) ^10.2.2 - [chalk](https://npm.io/package/chalk.md) ^2.4.2 - [is-url](https://npm.io/package/is-url.md) ^1.2.4 - [lodash](https://npm.io/package/lodash.md) ^4.17.15 - [js-yaml](https://npm.io/package/js-yaml.md) ^3.13.1 - [json-merge-patch](https://npm.io/package/json-merge-patch.md) ^0.2.3 - [@redocly/openapi-cli](https://npm.io/package/@redocly/openapi-cli.md) ^1.0.0-beta.3 ## Recent versions - 5.7.2 (latest) — 2020-10-16 - 5.7.1 — 2020-09-10 - 5.7.0 — 2020-09-09 - 5.6.3 — 2020-09-09 - 5.6.2 — 2020-09-09 - 5.6.1 — 2020-09-03 - 5.6.0 — 2020-08-20 - 5.5.0 — 2020-08-07 - 5.4.2 — 2020-08-06 - 5.4.1 — 2020-08-05 - 5.4.0 — 2020-08-05 - 5.3.0 — 2020-07-31 - 5.2.0 — 2020-07-29 - 5.1.0 — 2020-07-24 - 5.0.3 — 2020-07-23 - … 73 more at https://npm.io/package/@github/openapi/versions ## README # This project is no longer maintained! The official OpenAPI descriptions for GitHub's REST API are now available at [github.com/github/rest-api-description](https://github.com/github/rest-api-description). Have a nice day! --- --- --- --- --- --- --- # @github/openapi This project houses the official OpenAPI definitions for [GitHub's REST API](https://developer.github.com/v3), including the `api.github.com` API and all currently supported GitHub Enterprise versions of the REST API. 👋 Here to use the OpenAPI schema? See [Downloads](#downloads) 👋 Here to contribute? See [CONTRIBUTING.md](CONTRIBUTING.md) ## Contents - [What is OpenAPI?](#what-is-openapi) - [Who's using this?](#whos-using-this) - [Projects status](#project-status) - [Downloads](#downloads) - [Usage](#usage) - [Contributors ✨](#contributors-%E2%9C%A8) ## What is OpenAPI? [OpenAPI](https://swagger.io/specification/) (formerly Swagger) is an extension of [JSON Schema](https://json-schema.org/) that defines a standard, language-agnostic interface to RESTful APIs which allows both humans and computers to discover and understand the capabilities of an HTTP web service. OpenAPI schemas are contracts that are useful both for API authors and API consumers. They can be used to produce API documentation, generate API clients (SDKs), run automated tests, validate API payloads, etc. ## Who's using this? These definitions are used to generate GitHub's REST API reference documentation at [docs.github.com/rest/reference](https://docs.github.com/rest/reference). These definitions will also soon be used to generate the [JavaScript](https://github.com/octokit/plugin-rest-endpoint-methods.js) and [Ruby](https://github.com/octokit/octokit.rb) Octokit client libraries. (This is a work in progress.) ## Project status This project is under active development and is rapidly evolving. To borrow from [Slack's OpenAPI README](https://github.com/slackapi/slack-api-specs): > We use a combination of internal metadata, custom scripting, and old fashioned writing-by-hand to produce these specifications. They don't always tell the whole truth and are subject to author and operator error. They are really useful though. We use semantic versioning and [conventional commit messages](https://www.conventionalcommits.org/en/v1.0.0/) to ensure we're tracking breaking changes and releasing new major versions as necessary, but we cannot always be sure how changes might affect downstream consumers. If you are using these definitions, please be aware that they will change over time. ## Downloads ✋ Before using these OpenAPI definitions, please read the [project status](#project-status). You can download the latest [`api.github.com-deref.json`](https://unpkg.com/browse/@github/openapi@latest/dist/api.github.com-deref.json) from unpkg.com or [view all versions](https://unpkg.com/@github/openapi/dist/) of the schema. If you're using Node.js, you can download and install the [`@github/openapi`](https://npm.im/@github/openapi) package using npm: ```sh npm install @github/openapi ``` ## Usage After installing the npm package, the raw schema files can be required directly: ```js const schema = require('@github/openapi/dist/api.github.com.json') ``` The package also exports a single object called `schemas` that includes referenced and dereferenced variants of the schema for api.github.com and GitHub Enterprise: ```js const { schemas } = require('@github/openapi') // { // 'api.github.com-deref': {...}, // 'api.github.com': {...}, // 'ghe-2.18-deref': {...}, // 'ghe-2.18': {...}, // 'ghe-2.19-deref': {...}, // 'ghe-2.19': {...}, // 'ghe-2.20-deref': {...}, // 'ghe-2.20': {...},, // 'ghe-2.21-deref': {...}, // 'ghe-2.21': {...} // } ``` ## Contributors ✨ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

Roman Hotsiy
💻 📖 🤔 👀 💡
Gregor Martynus
💻 🖋 📖 🤔 👀
Zeke Sikelianos
🤔 👀
Sarah Schneider
👀
Marc-Andre Giroux
🤔
Keith Cirkel
🚇
Rachael Sewell
📖 👀

Chiedo John
📖
Adam Altman
📖 👀
Martin Lopes
📖
Lucas Costi
📖
jmarlena
📖
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome! --- _Source: https://npm.io/package/@github/openapi · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._