NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #845 most downloaded on npm
Generated TypeScript definitions based on GitHub's OpenAPI spec for api.github.com
Last release 1 months ago
29 Aug 2026
Release timing varies
gaps range from 2 weeks to 9 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
6 years old
162 releases · first in 2020
One column per quarter.
don't mark endpoints as unavailable in GHES 3.5 and GHAE which are in fact available
fix: mark assignees and request body as required in the DELETE /repos/{owner}/{repo}/issues/{issue_number}/assignees (i.e. remove assignees from an is
assignees and request body as required in the DELETE /repos/{owner}/{repo}/issues/{issue_number}/assignees (i.e. remove assignees from an issue) APIGET /repos/{owner}/{repo}/community/code_of_conduct APIselected_repository_ids for PUT /orgs/{org}/actions/secrets/{secret_name} AND PUT /orgs/{org}/dependabot/secrets/{secret_name} to be integers or stringsprebuild_availability enum values (blob, pool) for Codespaces machinesis_alphanumeric boolean response attribute to GET /repos/{owner}/{repo}/autolinks, POST /repos/{owner}/{repo}/autolinks and GET /repos/{owner}/{repo}/autolinks/{autolink_id}feat: PUT /enterprises/{enterprise}/actions/oidc/customization/issuer
PUT /enterprises/{enterprise}/actions/oidc/customization/issuerGET /orgs/{org_id}/codespacesPOST /orgs/{org}/members/{username}/codespaces/{codespace_name}/stopGET /orgs/{org}/actions/oidc/customization/subPUT /orgs/{org}/actions/oidc/customization/subDELETE /orgs/{org}/members/{username}/codespaces/{codespace_name}GET /repos/{owner}/{repo}/actions/cachesDELETE /repos/{owner}/{repo}/actions/cachesDELETE /repos/{owner}/{repo}/actions/caches/{cache_id}GET /repos/{owner}/{repo}/actions/oidc/customization/subPUT /repos/{owner}/{repo}/actions/oidc/customization/subretention_period_minutes request body parameter in POST /repos/{owner}/{repo}/codespaces , POST /repos/{owner}/{repo}/pulls/{pull_number}/codespaces and POST /user/codespacesPOST /repos/{owner}/{repo}/dependency-graph/snapshots as available on GitHub.com, not just GitHub Enterprise Cloudassignees request body parameter - and the request body more generally - as required in DELETE /repos/{owner}/{repo}/issues/{issue_number}/assigneesGET /repos/{owner}/{repo}/community/code_of_conduct APIadd new before and after parameters to GET /orgs/{org}/secret-scanning/alerts and GET /repos/{owner}/{repo}/secret-scanning/alerts
# 12.3.0 (2022-06-20) ### Features * GHES: v3.3, v3.4, v3.5
POST /repos/{owner}/{repo}/dependency-graph/snapshots, fix: description and example updates
`POST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun`: no longer deprecated
{GET,DELETE} /orgs/{org}/dependabot/secrets/{secret_name}/repositories/{repository_id}{GET,PATCH,DELETE} /orgs/{org}/teams/{team_slug}/external-groups{GET,POST,PUT,DELETE} /enterprises/{enterprise}/actions/runners/{runner_id}/labels"{GET,POST,PUT,DELETE} /orgs/{org}/actions/runners/{runner_id}/labels{GET,POST,PUT,DELETE} /repos/{owner}/{repo}/actions/runners/{runner_id}/labels{GET,POST} /repos/{owner}/{repo}/codespaces{GET,POST} /repos/{owner}/{repo}/tags/protection{GET,POST} /user/codespaces, GET /user/codespaces/secrets, GET /user/codespaces/secrets/public-key, {GET,PUT,DELETE} /user/codespaces/secrets/{secret_name}, {GET,PUT} /user/codespaces/secrets/{secret_name}/repositories, {PUT,DELETE} /user/codespaces/secrets/{secret_name}/repositories/{repository_id}, {GET,PATCH,DELETE} /user/codespaces/{codespace_name}, POST /user/codespaces/{codespace_name}/exports, GET /user/codespaces/{codespace_name}/exports/{export_id}, GET /user/codespaces/{codespace_name}/machines, POST /user/codespaces/{codespace_name}/start, POST /user/codespaces/{codespace_name}/stop{GET,PUT,DELETE} /orgs/{org}/dependabot/secrets/{secret_name}{GET,PUT,DELETE} /repos/{owner}/{repo}/codespaces/secrets/{secret_name}{GET,PUT,DELETE} /repos/{owner}/{repo}/dependabot/secrets/{secret_name}{GET,PUT} /orgs/{org}/actions/permissions/workflow{GET,PUT} /orgs/{org}/dependabot/secrets/{secret_name}/repositories{GET,PUT} /repos/{owner}/{repo}/actions/permissions/access{GET,PUT} /repos/{owner}/{repo}/actions/permissions/workflow/organizations/{organization_id}/custom_roles/orgs/{org}/actions/cache/usageDELETE /enterprises/{enterprise}/actions/runners/{runner_id}/labels/{name}DELETE /orgs/{org}/actions/runners/{runner_id}/labels/{name}DELETE /repos/{owner}/{repo}/actions/runners/{runner_id}/labels/{name}DELETE /repos/{owner}/{repo}/releases/{release_id}/reactions/{reaction_id}DELETE /repos/{owner}/{repo}/tags/protection/{tag_protection_id}GET /enterprise-installation/{enterprise_or_org}/server-statisticsGET /enterprises/{enterprise}/actions/cache/usageGET /enterprises/{enterprise}/actions/permissions/workflowGET /enterprises/{enterprise}/actions/runner-groups - visible-to-organization paramterGET /enterprises/{enterprise}/secret-scanning/alertsGET /enterprises/{enterprise}/settings/billing/advanced-securityGET /orgs/{org}/actions/cache/usage-by-repositoryGET /orgs/{org}/actions/runner-groups - new parameter: visible_to_repositoryGET /orgs/{org}/code-scanning/alertsGET /orgs/{org}/credential-authorizations - new parameters: per_page, page, loginGET /orgs/{org}/dependabot/secrets/public-keyGET /orgs/{org}/dependabot/secretsGET /orgs/{org}/external-group/{group_id}GET /orgs/{org}/external-groupsGET /orgs/{org}/secret-scanning/alerts - new parameters: sort, directionGET /orgs/{org}/settings/billing/advanced-securityGET /repos/{owner}/{repo}/codeowners/errorsGET /repos/{owner}/{repo}/codespaces/devcontainersGET /repos/{owner}/{repo}/codespaces/machinesGET /repos/{owner}/{repo}/codespaces/secrets/public-keyGET /repos/{owner}/{repo}/codespaces/secretsGET /repos/{owner}/{repo}/dependabot/secrets/public-keyGET /repos/{owner}/{repo}/dependabot/secretsGET /repos/{owner}/{repo}/dependency-graph/compare/{basehead}GET /repos/{owner}/{repo}/releases/{release_id}/reactionsGET /repos/{owner}/{repo}/secret-scanning/alerts/{alert_number}/locationsPATCH /orgs/{org}/actions/runner-groups/{runner_group_id} - new parameters: allows_public_repositories, restricted_to_workflows, selected_workflowsPATCH /orgs/{org} - new parameter: members_can_fork_private_repositoriesPOST /orgs/{org}/actions/runner-groups - new parameters: allows_public_repositories, restricted_to_workflows, selected_workflowsPOST /orgs/{org}/migrations - new parrameters: exclude_metadata, exclude_git_data, org_metadata_onlyPOST /orgs/{org}/repos - new parameter: use_squash_pr_title_as_defaultPOST /repos/{owner}/{repo}/actions/jobs/{job_id}/rerunPOST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun-failed-jobsPOST /repos/{owner}/{repo}/pulls/{pull_number}/codespacesPOST /user/migrations - new parrameters: exclude_metadata, exclude_git_data, org_metadata_onlyPUT /enterprises/{enterprise}/actions/permissions/workflowPUT /orgs/{org}/outside_collaborators/{username} - new parameter: asyncGET /repos/{owner}/{repo}/actions/cache/usageGET /repos/{owner}/{repo}/actions/runs: new parameter: check_suite_idGET /repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs: new parameter: check_suite_idGET /repos/{owner}/{repo}/code-scanning/alerts: new parameters: direction, sortGET /repos/{owner}/{repo}/environments: new parameters: per_page, pageGET /repos/{owner}/{repo}/secret-scanning/alerts: new parameters: direction, sortPATCH /repos/{owner}/{repo}/branches/{branch}/protection/required_pull_request_reviews: new parameters: dismissal_restrictions.apps, bypass_pull_request_allowancesPATCH /repos/{owner}/{repo}/branches/{branch}/protection/required_status_checks: new parameter: checksPATCH /repos/{owner}/{repo}/code-scanning/alerts/{alert_number}: new parameter: dismissed_commentPATCH /repos/{owner}/{repo}: secret_scanning_push_protection, use_squash_pr_title_as_defaultPOST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun: new parameter: enable_debug_loggingPOST /user/gpg_keys: new parameter: namePUT /repos/{owner}/{repo}/branches/{branch}/protection: new parameter: required_status_checks.checks, required_pull_request_reviews.{apps,bypass_pull_request_allowances}, block_creationscomponents.parametersrepository.{allow_update_branch,use_squash_pr_title_as_default,use_squash_pr_title_as_default}server-statisticsactions-default-workflow-permissionsactions-can-approve-pull-request-reviewsactions-get-default-workflow-permissionsactions-set-default-workflow-permissionsrunner-groups-enterprise.{workflow_restrictions_read_only,restricted_to_workflows,selected_workflows}runner-labelnullable-alert-updated-atminimal-repositoryactions-billing-usage.minutes_used_breakdown.{linux_4_core,linux_8_core,linux_16_core,linux_32_core,linux_64_core,windows_4_core,windows_8_core,windows_16_core,windows_32_core,windows_64_core,total}advanced-security-active-committers-useradvanced-security-active-committers-repositoryadvanced-security-active-committersissue.state_reasonissue.draftapi-overview.ssh-keysorganization-custom-repository-roleactions-cache-usage-by-repositoryrunner-groups-org.{workflow_restrictions_read_only,restricted_to_workflows,selected_workflows}code-scanning-alert-statealert-updated-atcode-scanning-alert-fixed-atcode-scanning-alert-dismissed-commentcode-scanning-alert-rulecode-scanning-organization-alert-itemscredential-authorization.authorized_credential_expires_atorganization-dependabot-secretdependabot-public-keyexternal-groupexternal-groupsmigration.org_metadata_onlynullable-minimal-repository.role_nameteam-repository.role_namerate-limit-overview.scimsecurity-and-analysisfull-repository.use_squash_pr_title_as_defaultartifact.workflow_runactions-workflow-access-to-repositoryreferenced_workflowworkflowrun.{path,referenced_workflows,actor,triggering_actor}protected-branch-required-status-checkprotected-branch-pull-request-review.{dismissal_restrictions.apps,bypass_pull_request_allowances}branch-protection.block_creationsstatus-check-policy.checksprotected-branch.{dismissal_restrictions.apps,bypass_pull_request_allowances,block_creations}check-suite.{rerequestable,runs_rerequestable}code-scanning-alert-rule-summary.tagscode-scanning-alert-items.{updated_at,fixed_at,dismissed_comment}code-scanning-sarifs-status.errorsnullable-codespace-machinecodespacecodespace-machinerepo-codespaces-secretcodespaces-public-keycollaborator.role_namenullable-collaboratordependabot-secretnullable-issuestate-change-issue-eventtimeline-issue-events can be of type state-change-issue-eventpage.build_typesecret-scanning-alert.{updated_at,secret_type_display_name}secret-scanning-location-committag-protectionissue-search-result-item.state_reasoncodespaces-secretgpg-key.{name,revoked}POST /app-manifests/{code}/conversions has no request bodyGET /projects/{project_id}/collaborators/{username}/permission: correct response type and examplePATCH /repos/{owner}/{repo}: visibility parameter cannot be set to visibilityPOST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun: no longer deprecatedDELETE /reactions/{reaction_id}POST /repos/{owner}/{repo}/content_references/{content_reference_id}/attachmentsremove GHES 3.0 and 3.1 schemas and types
GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/jobs
exclude-pull-requests component. exclude_pull_requests parameter added to action runs operations
GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_num}, GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_num}/logs, P
GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_num}, GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_num}/logs, POST /repos/{owner}/{repo}/releases/generate-notes, POST /repos/{owner}/{repo}/check-runs/{check_run_id}/rerequest. Graduate nebula, zzzax, switcheroo, baptiste previews. Removes defunkt /repos/{owner}/{repo}/actions/runs/{run_id}/retry endpoint. Renames operation IDs to normalize -authenticated-user suffix (#172) (ae60215)users/list-blocked-by-authenticated is now users/list-blocked-by-authenticated-userusers/set-primary-email-visibility-for-authenticated is now users/set-primary-email-visibility-for-authenticated-userusers/list-emails-for-authenticated is now users/list-emails-for-authenticated-userusers/add-email-for-authenticated is now users/add-email-for-authenticated-userusers/delete-email-for-authenticated is now users/delete-email-for-authenticated-userusers/list-followed-by-authenticated is now users/list-followed-by-authenticated-userusers/list-gpg-keys-for-authenticated is now users/list-gpg-keys-for-authenticated-userusers/create-gpg-key-for-authenticated is now users/create-gpg-key-for-authenticated-userusers/get-gpg-key-for-authenticated is now users/get-gpg-key-for-authenticated-userusers/delete-gpg-key-for-authenticated is now users/delete-gpg-key-for-authenticated-userapps/add-repo-to-installation is now apps/add-repo-to-installation-for-authenticated-userapps/remove-repo-from-installation is now apps/remove-repo-from-installation-for-authenticated-userusers/list-public-ssh-keys-for-authenticated is now users/list-public-ssh-keys-for-authenticated-userusers/create-public-ssh-key-for-authenticated is now users/create-public-ssh-key-for-authenticated-userusers/get-public-ssh-key-for-authenticated is now users/get-public-ssh-key-for-authenticated-userusers/delete-public-ssh-key-for-authenticated is now users/delete-public-ssh-key-for-authenticated-usermigrations/list-repos-for-user is now migrations/list-repos-for-authenticated-userusers/list-public-emails-for-authenticated is now users/list-public-emails-for-authenticated-userrepos/accept-invitation is now repos/accept-invitation-for-authenticated-userrepos/decline-invitation is now repos/decline-invitation-for-authenticated-user## 10.6.4 (2021-09-30) ### Bug Fixes * graduate surtur preview
POST /repos/{owner}/{repo}/community/code_of_conduct is GET /repos/{owner}/{repo}/community/code_of_conduct
previews graduated: ant-man, flash, scarlet-witch, squirrel-girl
## 10.6.1 (2021-09-27) ### Bug Fixes * luke-cage preview graduated
# 10.6.0 (2021-09-24) ### Features * graduate inertia preview
.protected_domain_state/.pending_domain_unverified_at keys for page component (GitHub Pages). Graduation of previews: london, lydian,wyandotte
POST /repos/{owner}/{repo}/actions/runs/{run_id}/retry, Deprecates POST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun. run_attempt/previous_attemp…
POST /repos/{owner}/{repo}/actions/runs/{run_id}/retry, Deprecates POST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun. run_attempt/previous_attemp…
add enum to status property in diff-entry component
## 10.2.1 (2021-09-14) ### Bug Fixes * bring back missing .d.ts files
allow_forking property for repository components
## 10.1.5 (2021-09-13) ### Bug Fixes * compenents fixes
debugging semantic-release error
Nothing published for this version
nullable-code-of-conduct-simple
added components
nullable-repositorynullable-minimal-repositorynullable-team-simplenullable-code-of-conduct-simplenullable-code-of-conduct-simplenullable-community-health-filenullable-git-usernullable-integrationnullable-license-simplenullable-milestonenullable-minimal-repositorynullable-repositorynullable-scoped-installationnullable-simple-commitnullable-simple-usernullable-team-simpleadd LICENSE file to published packages
POST /repos/{owner}/{repo}/merge-upstream
removes deprecated operations DELETE /applications/{client_id}/grants/{access_token}, {GET,POST,DELETE} /applications/{client_id}/tokens/{access_token…
DELETE /applications/{client_id}/grants/{access_token}, {GET,POST,DELETE} /applications/{client_id}/tokens/{access_token}These endpoints have now been sunset. See https://github.blog/changelog/2021-08-10-sunset-notice-oauth-application-api/
GET /orgs/{org}/packages (#142) (5547f9a)GET /user/packages (#142) (5547f9a)GET /user/{username}/packages (#142) (5547f9a)DELETE /users/{username}/packages/{package_type}/{package_name} (#142) (5547f9a)DELETE /users/{username}/packages/{package_type}/{package_name}/versions/{package_version_id} (#142) (5547f9a)POST /users/{username}/packages/{package_type}/{package_name}/versions/{package_version_id}/restore (#142) (5547f9a)# 9.7.0 (2021-08-11) ### Features * GHAE: autolinks endpoints
# 9.6.0 (2021-08-10) ### Features * GHAE types
permissions key in responses now consistently includes maintain and triage role
allow_auto_merge parameter when creating / updating a repository. Search: owner in repository items may no longer be null
{GET,POST} /repos/{owner}/{repo}/autolinks, {GET,DELETE} /repos/{owner}/{repo}/autolinks/{autolink_id}
mentions_count key in release response, mention repos alias for all when filtering issues
POST /repos/{owner}/{repo}/releases/{release_id}/assets: name query parameter is required. head.repo is nullable in pull-request schema
created parameter to actions/list-workflow-runs-for-repo and actions/list-workflow-runs operations
all component keys that had an underscore (_) in its name have been renamed and now are using a dash (-) instead
scarlet-witch preview graduated. Replace any types with unknown
removes security_severity_level property from components["schemas"]["code-scanning-alert-rule"]
GET /app/hook/deliveries/{delivery_id},
GET /app/hook/deliveries,GET /app/hook/deliveries/{delivery_id},POST /app/hook/deliveries/{delivery_id}/attempts,GET /orgs/{org}/hooks/{hook_id}/deliveries,GET /orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id},POST /orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}/attempts,GET /repos/{owner}/{repo}/hooks/{hook_id}/deliveries,GET /repos/{owner}/{repo}/hooks/{hook_id}/deliveries/{delivery_id},POST /repos/{owner}/{repo}/hooks/{hook_id}/deliveries/{delivery_id}/attempts.security_severity_level property in components["schemas"]["code-scanning-alert-rule"]
publish types.d.ts, not types.ts
publish types.d.ts, not types.ts
add README to new packages and correct repository URL
publish separate openapi-types packages for GHAE and GHES: @octokit/openapi-types-ghes-2.22, @octokit/openapi-types-ghes-3.0, @octokit/openapi-types-g
@octokit/openapi-types no longer exports any code, only types
@octokit/openapi-types no longer exports any code, only types.security_and_analysis.secret_scanning property in full-repository schema via @octokit/types v2.23.0
PATCH /repos/{owner}/{repo} - security_and_analysis.secret_scanning option
GET /search/labels & GET /search/topics pagination query parameters
lots and lots of type improvements
response types for pulls/request-reviewers, gists/update, repos/update-information-about-pages-site
response type for GET /orgs/{org}/actions/runner-groups/{runner_group_id}/repositories
has_advanced_security key for full-repository response schema
do not make parameters required that have a default property in the OpenAPI spec
fixes from https://github.com/drwpow/openapi-typescript/pull/612 & https://github.com/drwpow/openapi-typescript/pull/613
## 7.2.1 (2021-05-21) ### Bug Fixes * remove empty path objects
…GET /repos/{owner}/{repo}/compare/{basehead}. Deprecates GET /repos/{owner}/{repo}/compare/{base}...{head} and GET /repos/{owner}/{repo}/content_refer…
POST /repos/{owner}/{repo}/releases/{release_id}/reactions, POST /repos/{owner}/{repo}/content_references/{content_reference_id}/attachments, GET /repos/{owner}/{repo}/compare/{basehead}. Deprecates GET /repos/{owner}/{repo}/compare/{base}...{head} and GET /repos/{owner}/{repo}/content_references/{content_reference_id}/attachments via octokit/openapi v2.21.0 (#89) (f69efff)POST /repos/{owner}/{repo}/actions/runs/{run_id}/approve
audit-log/get-audit-log is now enterprise-admin/get-audit-log
Your coding agent can read these notes before it upgrades. Set up the MCP server →