https://github.com/octokit/openapi-webhooks
https://github.com/octokit/openapi-webhooks
Last synced: 7 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/octokit/openapi-webhooks
- Owner: octokit
- License: mit
- Created: 2022-10-25T21:54:10.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-06-18T12:02:48.000Z (7 months ago)
- Last Synced: 2025-06-18T13:19:56.058Z (7 months ago)
- Language: TypeScript
- Size: 77.6 MB
- Stars: 2
- Watchers: 3
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# openapi
> GitHub's official Webhooks OpenAPI spec with Octokit extensions
[](https://www.npmjs.com/package/@octokit/openapi-webhooks)
Amends webhooks from [GitHub's official OpenAPI specification](https://github.com/github/rest-api-description/) with an `x-octokit` extension that includes the following keys
- `changes`: see change files in [changes/](changes/)
## Download
Download from https://unpkg.com/browse/@octokit/openapi-webhooks/generated/
## Node Usage
```js
const { schemas } = require("@octokit/openapi-webhooks");
const version = schemas["api.github.com"].info.version;
const paths = Object.keys(schemas["api.github.com"].paths).sort();
```
## GitHub Actions usage
1. Install [Octokit Release Notifier app](https://github.com/apps/octokit-release-notifier/)
2. Create a new workflow file:
```yml
name: Update OpenAPI
on:
repository_dispatch:
types: [octokit/openapi-webhooks release]
jobs:
published:
runs-on: ubuntu-latest
steps:
- run: "echo: 'new release: ${{ github.event.release.tag_name }}'"
```
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md)
## License
[MIT](LICENSE)