# What changed in @octokit/rest

> 190 changes in @octokit/rest 17 to 22 from its official release notes, upgrade guides and advisories: 76 breaking, 32 deprecations, 1 security, 79 new APIs and options. Each one cited. Sources checked 2026-10-23. HTML: https://unstale.sh/npm/@octokit/rest/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @octokit/rest 22

### Breaking changes

- Deprecated Copilot usage metrics endpoints were removed. (22.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v22.0.0)
- Support for NodeJS v18 was dropped. (22.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v22.0.0)
- Deprecated Projects endpoints were removed. (22.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v22.0.0)

## @octokit/rest 21

### Breaking changes

- The package is now ESM, changing how developers import and use it. (21.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v21.0.0)

## @octokit/rest 20

### Breaking changes

- Support for NodeJS v14 and v16 was dropped. (20.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v20.0.0)
- The agent option was removed from octokit.request(). (20.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v20.0.0)
- Preview support for the REST API was removed. (20.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v20.0.0)

## @octokit/rest 19

### Breaking changes

- Support for NodeJS v10 and v12 was dropped, so applications using this release need a newer NodeJS version. (19.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v19.0.0)

## @octokit/rest 18

### Breaking changes

- Renamed from `octokit.actions.createOrUpdateSecretForRepo()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- The parameter was renamed from `name` to `secret_name`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.actions.createRegistrationToken()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.actions.createRemoveToken()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.actions.deleteSecretFromRepo()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- The parameter was renamed from `name` to `secret_name`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.actions.removeSelfHostedRunner()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.actions.downloadWorkflowJobLogs()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.actions.listWorkflowJobLogs()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.actions.listWorkflowRunLogs()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.actions.getWorkflowJob()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.actions.getPublicKey()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.actions.getSecret()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- The parameter was renamed from `name` to `secret_name`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.actions.getSelfHostedRunner()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.actions.listSecretsForRepo()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.actions.listDownloadsForSelfHostedRunnerApplication()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.actions.listRepoWorkflowRuns()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.activity.checkStarringRepo()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.activity.listFeeds()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.activity.getThreadSubscription()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.activity.listEventsForUser()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.activity.listNotifications()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.activity.listEventsForOrg()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.activity.listPublicEventsForOrg()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.activity.listNotificationsForRepo()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.activity.markAsRead()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.activity.markNotificationsAsReadForRepo()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.activity.starRepo()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed method for unstarring a repository for the authenticated user. (17.0.0, 18.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/), [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.apps.createInstallationToken()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.apps.checkAccountIsAssociatedWithAny()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.apps.checkAccountIsAssociatedWithAnyStubbed()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.apps.listAccountsUserOrOrgOnPlan()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.apps.listAccountsUserOrOrgOnPlanStubbed()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.apps.listRepos()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.apps.listMarketplacePurchasesForAuthenticatedUser()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.apps.listMarketplacePurchasesForAuthenticatedUserStubbed()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- Renamed from `octokit.apps.revokeInstallationToken()`. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- No longer accepts an array as its first argument; pass plugins as multiple arguments instead. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- The deprecated API has been removed. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- The deprecated API has been removed. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- The deprecated API has been removed. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)
- The deprecated API has been removed. (18.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v18.0.0)

## @octokit/rest 17

### Breaking changes

- All deprecated methods and options have been removed; use replacement methods or octokit.request where specified. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Endpoint parameters are no longer validated on the client; the notes recommend TypeScript or its definitions in JavaScript. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Node 8 is no longer supported. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- The constructor must be invoked with new; calling Octokit() throws a TypeError. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Replaced by octokit.apps.checkToken. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Replaced by octokit.apps.resetToken. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Replaced by octokit.apps.deleteToken. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Replaced by octokit.apps.deleteAuthorization. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- The parameter formerly named current_name is now name, and name is now new_name. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Removed; use octokit.request with POST /authorizations instead. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Removed; use octokit.request with DELETE /authorizations/:authorization_id instead. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Removed; use octokit.request with DELETE /applications/grants/:grant_id instead. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Removed; use octokit.request with GET /authorizations/:authorization_id instead. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Removed; use octokit.request with GET /applications/grants/:grant_id instead. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Removed; use octokit.request with PUT /authorizations/clients/:client_id instead. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Removed; use octokit.request with PUT /authorizations/clients/:client_id/:fingerprint instead. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Removed; use octokit.request with GET /authorizations instead. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Removed; use octokit.request with GET /applications/grants instead. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Removed; use octokit.request with PATCH /authorizations/:authorization_id instead. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Always returns an array, including when the response is a single object. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Removed; use octokit.request with POST /repos/:owner/:repo/pulls instead. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- The endpoint registration method has been removed; use request.defaults and assign the resulting methods or return them from a plugin. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Removed; use octokit.request with GET /repos/:owner/:repo/commits/:ref instead. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Plugins must return an object to extend the Octokit instance, which is required for TypeScript support. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)

### Security

- Checks OAuth token validity without exceeding normal rate limits for failed login attempts. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)

### Deprecations

- This method is deprecated and has been renamed to gists.listForUser. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- This method is deprecated and renamed to apps.listSubscriptionsForAuthenticatedUser. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- This method is deprecated and renamed to apps.listSubscriptionsForAuthenticatedUserStubbed. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated in favor of activity.listNotificationsForAuthenticatedUser. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated in favor of activity.listRepoNotificationsForAuthenticatedUser. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated in favor of activity.listPublicOrgEvents. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated in favor of activity.markNotificationsAsRead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated in favor of activity.markRepoNotificationsAsRead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated in favor of actions.createRegistrationTokenForRepo. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated in favor of actions.createRemoveTokenForRepo. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Use this renamed method to force removal of a self-hosted runner from a repository. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Use this renamed method to get a redirect URL for downloading workflow job logs. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Use this renamed method to get a redirect URL for downloading workflow run logs. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated in favor of actions.getSelfHostedRunnerForRepo. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated in favor of actions.listRunnerApplicationsForRepo. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- This method is deprecated; use actions.downloadWorkflowJobLogs instead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- This method is deprecated; use actions.downloadWorkflowRunLogs instead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- This method is deprecated; use actions.deleteSelfHostedRunnerFromRepo instead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- This method is deprecated; use activity.checkRepoIsStarredByAuthenticatedUser instead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- This method is deprecated; use activity.getThreadSubscriptionForAuthenticatedUser instead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- This method is deprecated; use activity.listOrgEventsForAuthenticatedUser instead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- This method is deprecated; use activity.listEventsForAuthenticatedUser instead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- This method is deprecated; use activity.getFeeds instead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated; use octokit.activity.unstarRepoForAuthenticatedUser instead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated; use octokit.apps.getSubscriptionPlanForAccount instead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated; use octokit.apps.getSubscriptionPlanForAccountStubbed instead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated; use octokit.apps.listAccountsForPlan instead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated; use octokit.apps.listAccountsForPlanStubbed instead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Use this method to list all codes of conduct; it is the replacement for listConductCodes. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- This method is deprecated and has been renamed to codesOfConduct.getAllCodesOfConduct. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- octokit.registerEndpoints() is deprecated; register custom methods by assigning defaults from octokit.request, and plugins should return an object instead. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deprecated in favor of activity.starRepoForAuthenticatedUser. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)

### New APIs and options

- Creates a check run for a commit, supporting output annotations, images, and requested actions. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Manually creates a check suite when automatic creation has been disabled. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a single check run by its ID. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a single check suite by its ID. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists repositories the authenticated user can access for an installation, including each repository’s permissions. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists installations; this endpoint requires a JWT. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists installations of the GitHub App that the authenticated user has permission to access. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists all plans that are part of a GitHub Marketplace listing. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists all plans that are part of a GitHub Marketplace listing using the stubbed endpoint. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists repositories that an installation can access; this endpoint requires an installation access token. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists active subscriptions for the authenticated user. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists active subscriptions for the authenticated user using the stubbed endpoint. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Creates or updates a repository secret using an encrypted value. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Creates a registration token for an organization’s self-hosted runners. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Creates a registration token for repository self-hosted runners. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Creates a removal token for an organization’s self-hosted runners. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Creates a removal token for repository self-hosted runners. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deletes an artifact for a workflow run. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deletes a repository secret by name. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Forces removal of a self-hosted runner from an organization. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Forces removal of a self-hosted runner from a repository. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deletes all logs for a workflow run. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a redirect URL to download an artifact archive; the URL expires after one minute. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a redirect URL to download workflow job logs; the link expires after one minute. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a redirect URL to download workflow run logs; the link expires after one minute. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a specific artifact for a workflow run. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets the public key required to encrypt repository secrets. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a repository secret without revealing its encrypted value. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a specific self-hosted runner for an organization. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a specific self-hosted runner for a repository. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a specific workflow by ID or workflow file name. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a specific job in a workflow run. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a specific workflow run. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists all artifacts for a repository. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists jobs for a workflow run, with parameters to narrow the results. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists workflow runs for a repository, with optional parameters to narrow results. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists the workflows in a repository. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists downloadable runner application binaries for an organization. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists downloadable runner application binaries for a repository. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists repository secrets without revealing their encrypted values. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists all self-hosted runners for an organization. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists all self-hosted runners for a repository. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists artifacts for a workflow run. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists workflow runs for a workflow, with optional parameters to narrow results. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Re-runs a workflow run using its ID. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Checks whether a repository is starred by the authenticated user. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Deletes a repository subscription to stop watching the repository. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Mutes future notifications for a conversation until you comment on the thread or are mentioned. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists timeline feeds available to the authenticated user. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a repository subscription. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a thread. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Checks whether the authenticated user is subscribed to a thread. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists events for the authenticated user; private events are visible when authenticated as that user. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists events on the authenticated user's organization dashboard. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Adds a single repository to an installation; the authenticated user must have admin access to the repository. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Creates an attachment under a content reference URL in an issue or pull request body or comment. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Completes the handshake for the GitHub App Manifest flow and retrieves the app details. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Creates an installation access token; repository_ids can restrict the token to specific repositories. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Revokes an OAuth application grant for a specific user and deletes that user's associated OAuth tokens. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Uninstalls a GitHub App from a user, organization, or business account. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Revokes a single token for an OAuth application. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Returns the GitHub App associated with the authentication credentials. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets a GitHub App by its URL-friendly name. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets an installation using a JWT. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Finds an organization's installation information for an authenticated GitHub App. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Finds a repository's installation information for an authenticated GitHub App. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets the subscription plan associated with a user or organization account. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Gets stubbed subscription plan information for a user or organization account. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Finds a user's installation information for an authenticated GitHub App. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists user and organization accounts associated with a plan, including free plans. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Lists repository and organization accounts associated with a plan, including free plans. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Adds an async method that returns the currently used authentication based on the configured authStrategy. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- The REST library now provides a graphql method alongside request. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- The method now accepts owner, repo, and release_id URL parameters; passing url still works but is not recommended. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- Removes a repository from an installation; the authenticated user must have admin access to the repository. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Resets a valid OAuth token without end-user involvement; applications must save the response’s token property because changes take effect immediately. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Revokes the installation token in use, which must be replaced before other endpoints requiring it can be used. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Suspends a GitHub App installation, blocking access to the account’s resources; the feature is in beta and requires opt-in. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)
- Removes a GitHub App installation suspension. (17.0.0) — [upgrade guide](https://octokit.github.io/rest.js/v17/)

### Behavior and default changes

- URL parameters, including options.base and options.head for compareCommits, are automatically encoded; callers no longer need encodeURIComponent(). (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)
- The header now identifies the package as octokit-rest.js rather than octokit.js. (17.0.0) — [release notes](https://github.com/octokit/rest.js/releases/tag/v17.0.0)