NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #2239 most downloaded on npm
GitHub REST API client for Node.js
Last release 10 months ago
31 Oct 2025
Release timing varies
gaps range from 2 weeks to 5 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
302 releases · first in 2018
routes: remove invalid enum values for "Create/Update a Check Run"
client.emojis.get() (117765a)client.meta.get() (2f52065)client.repos.createDeploymentStatus() (5d33654)author.email and author.name validation to client.repos.createFile / .updateFile() (358b8e6)committer.email and committer.name validation to client.repos.createFile / .updateFile() (c4987f4)One column per quarter.
remove obsolete mapTo: input for .users.addEmails()
client.apps.createFromManifest({code}) – see https://git.io/fx3wp
## 15.12.1 (2018-09-27) ### Bug Fixes * #1033: add preview header for client.checks.rerequestSuite (1c09d26), closes #1033
always send octokit/rest.js version in user-agent header
## 15.11.4 (2018-09-17) ### Bug Fixes * typescript: nullable params
typescript: meta property in typings templates was replaced with headers.
typescript: add namespace to return types
routes: adapt Installation Access Token route
# 15.10.0 (2018-08-16) ### Features * typescript: response types
archived_state enums, name no longer required for check run update
## 15.9.5 (2018-08-01) ### Bug Fixes * #950: mark deprecated properties as optional in typescript typings (bbb066b), closes #950
## 15.9.4 (2018-06-30) ### Bug Fixes * lambda compatibility
archive and archived_state parameter definitions
team_id parameter renamed to team_ids for client.repos.transfer(). team_id is now deprecated.
"actions" parameter for .checks.{create,update}() is an array
.aps.find{Org,Repo,User}Installation
don’t require "id" for webhook APIs (27f334f), closes #911
### Bug Fixes * restore compatibility with v4
don’t log same deprecation message twice
repository_id parameter is required for .search.labels() (b7e3add)actions{} parameter added to .checks.create() and .checks.update() (79925a1)response.headers (7ec8a03)response.status (5bf104c)response.meta is now response.headersoctokit.issues.updateLabel(): oldname is now current_nameid paramters have been renamed to <resource>_id. See the full list at https://github.com/octokit/rest.js/commit/c62b2bcb2c4f66d93ecff1563df7f7d8e8431788.projects.getUserPermissionLevel()
.orgs.createInvitation() (8a3399e).orgs.getInvitationTeams() (6d6371b).projects.addCollaborator() (578fb52).projects.getCollaborators() (f92029e).projects.getUserPermissionLevel() (4c90f3d).projects.removeCollaborator() (852899f).reactions.createForTeamDiscussion() (028eaab).reactions.createForTeamDiscussionComment() (f11fc3d).reactions.getForTeamDiscussion() (1287395).reactions.getForTeamDiscussionComment() (de62fed).repos.addProtectedBranchRequiredSignatures() (261e8c6).repos.getProtectedBranchRequiredSignatures() (29623d5).repos.removeProtectedBranchRequiredSignatures() (a34ebb4).repos.transfer() (9116866).search.labels() (236e401).search.topics() (9274f9e).users.getContextForUser() (c273788)## 15.6.2 (2018-05-22) ### Bug Fixes * pagination with preview header
adds "machine-man" preview header when authenticated as installation
.checks.createSuite() and .checks.requestSuites()
typescript definitions for "app" authentication
authentication type "app". "integration" is now deprecated
validate: default to empty member array if optional parent parameter is not set
checks APIs (c7a68ed) see https://blog.github.com/2018-05-07-introducing-checks-api/
handle deprecation and aliasing of method names
This release has a lot of changes to lib/routes.json. The old and new routes.json are attached to this release so you can use your favorite JSON Diff tool to compare them (like [jsondiff](http://tlrobinson.net/projects/javascript-fun/jsondiff/ by Tom Robinson)
encoding param not required for gitdata.createBlob() (2a4e15e)body param with assignees (4554d58)user_id parameter from createInstallationToken & getInstallationRepositories (861b733)handle empty responses to HEAD requests
## 15.2.6 (2018-03-29) ### Bug Fixes * throw on 304
octokit.apps.getInstallations() does not throw TypeError
typescript: update types to reflect client option changes
typescript: agent client option is optional
### Bug Fixes * proxy without setting baseUrl
clarify deprecation warning for protocol, bost, port and pathPrefix
protocol, bost, port and pathPrefix (ab9ce13)### Features * options.baseUrl (#807) (96b9fc6) ### Deprecations Client options - options.headers - options.port - options.pathPrefix - options.host
### Bug Fixes * set error.headers if present
remove obsolete github.search.email() API
### Bug Fixes * remove milestone from issue
do not alter options passed to endpoint
package: -@gr2m/node-fetch, +node-fetch@^2.1.1
307 redirects & ArrayBuffer support for request body #780
inline is-array-buffer for webpack compatibility
octokit.orgs.createTeam({parent_team_id})
accept case-insensitive custom headers (e01e1a7),
options.agent for advanced request options in Node
handle binary response correctly
add missing params to pullRequest.createComment: commit_id, path, position
set options.title as required for octokit.pullRequests.create(options)
_(v15.0.0 was published by accident and unpublished shortly after, sorry)_
(v15.0.0 was published by accident and unpublished shortly after, sorry)
octokit.issues.deleteLabel() returned an empty string for {data}. They now correctly return undefinedinclude stacktraces for each type of error
typescript: ReposUploadAssetParams.file type definition
## 14.0.7 (2018-01-28) ### Bug Fixes * date parsing
correctly upload asset if file is Buffer/ArrayBuffer
typescript definition regression
## 14.0.4 (2018-01-19) ### Bug Fixes * pagination passes headers
typescript definition syntax errors
travis: build flow & typescript definitions before semantic-release
Your coding agent can read these notes before it upgrades. Set up the MCP server →