v18.0.0
Upgrade guide
Install the latest v17 version (17.11.2
as of this writing). Run your tests and address all deprecation messages. Once all deprecations have been addressed, the upgrade to v18 should be easy. The only changes are removals of previously deprecated APIs.
BREAKING CHANGES
Octokit.plugin()
no longer accepts an array as first argument. Pass multiple arguments instead, e.g.Octokit.plugin(plugin1, plugin2)
- deprecated
octokit.reactions.deleteLegacy()
has been removed - deprecated
octokit.repos.getDownloads()
has been removed - deprecated
octokit.repos.listDownloads()
has been removed - deprecated
octokit.repos.deleteDownloads()
has been removed octokit.actions.createOrUpdateRepoSecret()
: parametername
has been renamed tosecret_name
octokit.actions.createOrUpdateSecretForRepo()
has been renamed tooctokit.actions.createOrUpdateRepoSecret()
octokit.actions.createOrUpdateRepoSecret()
: parametername
has been renamed tosecret_name
octokit.actions.createRegistrationToken()
has been renamed tooctokit.actions.createRegistrationTokenForRepo()
octokit.actions.createRemoveToken()
has been renamed tooctokit.actions.createRemoveTokenForRepo()
octokit.actions.deleteRepoSecret()
: parametername
has been renamed tosecret_name
octokit.actions.deleteSecretFromRepo()
has been renamed tooctokit.actions.deleteRepoSecret()
octokit.actions.deleteRepoSecret()
: parametername
has been renamed tosecret_name
octokit.actions.downloadWorkflowJobLogs()
has been renamed tooctokit.actions.downloadJobLogsForWorkflowRun()
octokit.actions.getPublicKey()
has been renamed tooctokit.actions.getRepoPublicKey()
octokit.actions.getRepoSecret()
: parametername
has been renamed tosecret_name
octokit.actions.getSecret()
has been renamed tooctokit.actions.getRepoSecret()
octokit.actions.getRepoSecret()
: parametername
has been renamed tosecret_name
octokit.actions.getSelfHostedRunner()
has been renamed tooctokit.actions.getSelfHostedRunnerForRepo()
octokit.actions.getWorkflowJob()
has been renamed tooctokit.actions.getJobForWorkflowRun()
octokit.actions.listDownloadsForSelfHostedRunnerApplication()
has been renamed tooctokit.actions.listRunnerApplicationsForRepo()
octokit.actions.listRepoWorkflowRuns()
has been renamed tooctokit.actions.listWorkflowRunsForRepo()
octokit.actions.listSecretsForRepo()
has been renamed tooctokit.actions.listRepoSecrets()
octokit.actions.listWorkflowJobLogs()
has been renamed tooctokit.actions.downloadWorkflowJobLogs()
octokit.actions.listWorkflowRunLogs()
has been renamed tooctokit.actions.downloadWorkflowRunLogs()
octokit.actions.removeSelfHostedRunner()
has been renamed tooctokit.actions.deleteSelfHostedRunnerFromRepo()
octokit.activity.checkStarringRepo()
has been renamed tooctokit.activity.checkRepoIsStarredByAuthenticatedUser()
octokit.activity.getThreadSubscription()
has been renamed tooctokit.activity.getThreadSubscriptionForAuthenticatedUser()
octokit.activity.listEventsForOrg()
has been renamed tooctokit.activity.listOrgEventsForAuthenticatedUser()
octokit.activity.listEventsForUser()
has been renamed tooctokit.activity.listEventsForAuthenticatedUser()
octokit.activity.listFeeds()
has been renamed tooctokit.activity.getFeeds()
octokit.activity.listNotifications()
has been renamed tooctokit.activity.listNotificationsForAuthenticatedUser()
octokit.activity.listNotificationsForRepo()
has been renamed tooctokit.activity.listRepoNotificationsForAuthenticatedUser()
octokit.activity.listPublicEventsForOrg()
has been renamed tooctokit.activity.listPublicOrgEvents()
octokit.activity.markAsRead()
has been renamed tooctokit.activity.markNotificationsAsRead()
octokit.activity.markNotificationsAsReadForRepo()
has been renamed tooctokit.activity.markRepoNotificationsAsRead()
octokit.activity.starRepo()
has been renamed tooctokit.activity.starRepoForAuthenticatedUser()
octokit.activity.unstarRepo()
has been renamed tooctokit.activity.unstarRepoForAuthenticatedUser()
octokit.apps.checkAccountIsAssociatedWithAny()
has been renamed tooctokit.apps.getSubscriptionPlanForAccount()
octokit.apps.checkAccountIsAssociatedWithAnyStubbed()
has been renamed tooctokit.apps.getSubscriptionPlanForAccountStubbed()
octokit.apps.createInstallationToken()
has been renamed tooctokit.apps.createInstallationAccessToken()
octokit.apps.listAccountsUserOrOrgOnPlan()
has been renamed tooctokit.apps.listAccountsForPlan()
octokit.apps.listAccountsUserOrOrgOnPlanStubbed()
has been renamed tooctokit.apps.listAccountsForPlanStubbed()
octokit.apps.listMarketplacePurchasesForAuthenticatedUser()
has been renamed tooctokit.apps.listSubscriptionsForAuthenticatedUser()
octokit.apps.listMarketplacePurchasesForAuthenticatedUserStubbed()
has been renamed tooctokit.apps.listSubscriptionsForAuthenticatedUserStubbed()
octokit.apps.listRepos()
has been renamed tooctokit.apps.listReposAccessibleToInstallation()
octokit.apps.revokeInstallationToken()
has been renamed tooctokit.apps.revokeInstallationAccessToken()
octokit.codesOfConduct.listConductCodes()
has been renamed tooctokit.codesOfConduct.getAllCodesOfConduct()
octokit.gists.listPublicForUser()
has been renamed tooctokit.gists.listForUser()
octokit.gitignore.listTemplates()
has been renamed tooctokit.gitignore.getAllTemplates()
octokit.interactions.addOrUpdateRestrictionsForOrg()
has been renamed tooctokit.interactions.setRestrictionsForOrg()
octokit.interactions.addOrUpdateRestrictionsForRepo()
has been renamed tooctokit.interactions.setRestrictionsForRepo()
octokit.issues.checkAssignee()
has been renamed tooctokit.issues.checkUserCanBeAssigned()
octokit.issues.listMilestonesForRepo()
has been renamed tooctokit.issues.listMilestones()
octokit.issues.removeLabels()
has been renamed tooctokit.issues.removeAllLabels()
octokit.issues.replaceAllLabels()
has been renamed tooctokit.issues.setLabels()
octokit.issues.replaceLabels()
has been renamed tooctokit.issues.replaceAllLabels()
octokit.licenses.listCommonlyUsed()
has been renamed tooctokit.licenses.getAllCommonlyUsed()
octokit.migrations.getImportProgress()
has been renamed tooctokit.migrations.getImportStatus()
octokit.orgs.addOrUpdateMembership()
has been renamed tooctokit.orgs.setMembershipForUser()
octokit.orgs.checkMembership()
has been renamed tooctokit.orgs.checkMembershipForUser()
octokit.orgs.checkPublicMembership()
has been renamed tooctokit.orgs.checkPublicMembershipForUser()
octokit.orgs.concealMembership()
has been renamed tooctokit.orgs.removePublicMembershipForAuthenticatedUser()
octokit.orgs.createHook()
has been renamed tooctokit.orgs.createWebhook()
octokit.orgs.deleteHook()
has been renamed tooctokit.orgs.deleteWebhook()
octokit.orgs.getHook()
has been renamed tooctokit.orgs.getWebhook()
octokit.orgs.getMembership()
has been renamed tooctokit.orgs.getMembershipForUser()
octokit.orgs.listHooks()
has been renamed tooctokit.orgs.listWebhooks()
octokit.orgs.listInstallations()
has been renamed tooctokit.orgs.listAppInstallations()
octokit.orgs.listMemberships()
has been renamed tooctokit.orgs.listMembershipsForAuthenticatedUser()
octokit.orgs.pingHook()
has been renamed tooctokit.orgs.pingWebhook()
octokit.orgs.publicizeMembership()
has been renamed tooctokit.orgs.setPublicMembershipForAuthenticatedUser()
octokit.orgs.removeMembership()
has been renamed tooctokit.orgs.removeMembershipForUser()
octokit.orgs.updateHook()
has been renamed tooctokit.orgs.updateWebhook()
octokit.orgs.updateMembership()
has been renamed tooctokit.orgs.updateMembershipForAuthenticatedUser()
octokit.projects.reviewUserPermissionLevel()
has been renamed tooctokit.projects.getPermissionForUser()
octokit.pulls.createComment()
has been renamed tooctokit.pulls.createReviewComment()
octokit.pulls.createReviewCommentReply()
has been renamed tooctokit.pulls.createReplyForReviewComment()
octokit.pulls.createReviewRequest()
has been renamed tooctokit.pulls.requestReviewers()
octokit.pulls.deleteComment()
has been renamed tooctokit.pulls.deleteReviewComment()
octokit.pulls.deleteReviewRequest()
has been renamed tooctokit.pulls.removeRequestedReviewers()
octokit.pulls.getComment()
has been renamed tooctokit.pulls.getReviewComment()
octokit.pulls.getCommentsForReview()
has been renamed tooctokit.pulls.listCommentsForReview()
octokit.pulls.listComments()
has been renamed tooctokit.pulls.listReviewComments()
octokit.pulls.listCommentsForRepo()
has been renamed tooctokit.pulls.listReviewCommentsForRepo()
octokit.pulls.listReviewRequests()
has been renamed tooctokit.pulls.listRequestedReviewers()
octokit.pulls.updateComment()
has been renamed tooctokit.pulls.updateReviewComment()
octokit.reactions.delete()
has been renamed tooctokit.reactions.deleteLegacy()
octokit.repos.addDeployKey()
has been renamed tooctokit.repos.createDeployKey()
octokit.repos.addProtectedBranchAdminEnforcement()
has been renamed tooctokit.repos.setAdminBranchProtection()
octokit.repos.addProtectedBranchAppRestrictions()
has been renamed tooctokit.repos.addAppAccessRestrictions()
octokit.repos.addProtectedBranchRequiredSignatures()
has been renamed tooctokit.repos.createCommitSignatureProtection()
octokit.repos.addProtectedBranchRequiredStatusChecksContexts()
has been renamed tooctokit.repos.addStatusCheckContexts()
octokit.repos.addProtectedBranchTeamRestrictions()
has been renamed tooctokit.repos.addTeamAccessRestrictions()
octokit.repos.addProtectedBranchUserRestrictions()
has been renamed tooctokit.repos.addUserAccessRestrictions()
octokit.repos.createHook()
has been renamed tooctokit.repos.createWebhook()
octokit.repos.createOrUpdateFile()
has been renamed tooctokit.repos.createOrUpdateFileContents()
octokit.repos.createStatus()
has been renamed tooctokit.repos.createCommitStatus()
octokit.repos.deleteHook()
has been renamed tooctokit.repos.deleteWebhook()
octokit.repos.disablePagesSite()
has been renamed tooctokit.repos.deletePagesSite()
octokit.repos.enablePagesSite()
has been renamed tooctokit.repos.createPagesSite()
octokit.repos.getArchiveLink()
has been renamed tooctokit.repos.downloadArchive()
octokit.repos.getContents()
has been renamed tooctokit.repos.getContent()
octokit.repos.getHook()
has been renamed tooctokit.repos.getWebhook()
octokit.repos.getProtectedBranchAdminEnforcement()
has been renamed tooctokit.repos.getAdminBranchProtection()
octokit.repos.getProtectedBranchPullRequestReviewEnforcement()
has been renamed tooctokit.repos.getPullRequestReviewProtection()
octokit.repos.getProtectedBranchRequiredSignatures()
has been renamed tooctokit.repos.getCommitSignatureProtection()
octokit.repos.getProtectedBranchRequiredStatusChecks()
has been renamed tooctokit.repos.getStatusChecksProtection()
octokit.repos.getProtectedBranchRestrictions()
has been renamed tooctokit.repos.getAccessRestrictions()
octokit.repos.list()
has been renamed tooctokit.repos.listForAuthenticatedUser()
octokit.repos.listAssetsForRelease()
has been renamed tooctokit.repos.listReleaseAssets()
octokit.repos.listCommitComments()
has been renamed tooctokit.repos.listCommitCommentsForRepo()
octokit.repos.listHooks()
has been renamed tooctokit.repos.listWebhooks()
octokit.repos.listProtectedBranchRequiredStatusChecksContexts()
has been renamed tooctokit.repos.getAllStatusCheckContexts()
octokit.repos.listStatusesForRef()
has been renamed tooctokit.repos.listCommitStatusesForRef()
octokit.repos.listTopics()
has been renamed tooctokit.repos.getAllTopics()
octokit.repos.pingHook()
has been renamed tooctokit.repos.pingWebhook()
octokit.repos.removeBranchProtection()
has been renamed tooctokit.repos.deleteBranchProtection()
octokit.repos.removeDeployKey()
has been renamed tooctokit.repos.deleteDeployKey()
octokit.repos.removeProtectedBranchAdminEnforcement()
has been renamed tooctokit.repos.deleteAdminBranchProtection()
octokit.repos.removeProtectedBranchAppRestrictions()
has been renamed tooctokit.repos.removeAppAccessRestrictions()
octokit.repos.removeProtectedBranchPullRequestReviewEnforcement()
has been renamed tooctokit.repos.deletePullRequestReviewProtection()
octokit.repos.removeProtectedBranchRequiredSignatures()
has been renamed tooctokit.repos.deleteCommitSignatureProtection()
octokit.repos.removeProtectedBranchRequiredStatusChecks()
has been renamed tooctokit.repos.removeStatusChecksProtection()
octokit.repos.removeProtectedBranchRequiredStatusChecksContexts()
has been renamed tooctokit.repos.removeStatusCheckContexts()
octokit.repos.removeProtectedBranchRestrictions()
has been renamed tooctokit.repos.deleteAccessRestrictions()
octokit.repos.removeProtectedBranchTeamRestrictions()
has been renamed tooctokit.repos.removeTeamAccessRestrictions()
octokit.repos.removeProtectedBranchUserRestrictions()
has been renamed tooctokit.repos.removeUserAccessRestrictions()
octokit.repos.replaceProtectedBranchAppRestrictions()
has been renamed tooctokit.repos.setAppAccessRestrictions()
octokit.repos.replaceProtectedBranchRequiredStatusChecksContexts()
has been renamed tooctokit.repos.setStatusCheckContexts()
octokit.repos.replaceProtectedBranchTeamRestrictions()
has been renamed tooctokit.repos.setTeamAccessRestrictions()
octokit.repos.replaceProtectedBranchUserRestrictions()
has been renamed tooctokit.repos.setUserAccessRestrictions()
octokit.repos.replaceTopics()
has been renamed tooctokit.repos.replaceAllTopics()
octokit.repos.requestPageBuild()
has been renamed tooctokit.repos.requestPagesBuild()
octokit.repos.retrieveCommunityProfileMetrics()
has been renamed tooctokit.repos.getCommunityProfileMetrics()
octokit.repos.testPushHook()
has been renamed tooctokit.repos.testPushWebhook()
octokit.repos.updateHook()
has been renamed tooctokit.repos.updateWebhook()
octokit.repos.updateProtectedBranchPullRequestReviewEnforcement()
has been renamed tooctokit.repos.updatePullRequestReviewProtection()
octokit.repos.updateProtectedBranchRequiredStatusChecks()
has been renamed tooctokit.repos.updateStatusChecksProtection()
octokit.teams.addOrUpdateMembershipInOrg()
has been renamed tooctokit.teams.addOrUpdateMembershipForUserInOrg()
octokit.teams.addOrUpdateProjectInOrg()
has been renamed tooctokit.teams.addOrUpdateProjectPermissionsInOrg()
octokit.teams.addOrUpdateRepoInOrg()
has been renamed tooctokit.teams.addOrUpdateRepoPermissionsInOrg()
octokit.teams.checkManagesRepoInOrg()
has been renamed tooctokit.teams.checkPermissionsForRepoInOrg()
octokit.teams.getMembershipInOrg()
has been renamed tooctokit.teams.getMembershipForUserInOrg()
octokit.teams.removeMembershipInOrg()
has been renamed tooctokit.teams.removeMembershipForUserInOrg()
octokit.teams.reviewProjectInOrg()
has been renamed tooctokit.teams.checkPermissionsForProjectInOrg()
octokit.users.addEmails()
has been renamed tooctokit.users.addEmailsForAuthenticated()
octokit.users.checkFollowing()
has been renamed tooctokit.users.checkPersonIsFollowedByAuthenticated()
octokit.users.createGpgKey()
has been renamed tooctokit.users.createGpgKeyForAuthenticated()
octokit.users.createPublicKey()
has been renamed tooctokit.users.createPublicSshKeyForAuthenticated()
octokit.users.deleteEmails()
has been renamed tooctokit.users.deleteEmailsForAuthenticated()
octokit.users.deleteGpgKey()
has been renamed tooctokit.users.deleteGpgKeyForAuthenticated()
octokit.users.deletePublicKey()
has been renamed tooctokit.users.deletePublicSshKeyForAuthenticated()
octokit.users.getGpgKey()
has been renamed tooctokit.users.getGpgKeyForAuthenticated()
octokit.users.getPublicKey()
has been renamed tooctokit.users.getPublicSshKeyForAuthenticated()
octokit.users.listBlocked()
has been renamed tooctokit.users.listBlockedByAuthenticated()
octokit.users.listEmails()
has been renamed tooctokit.users.listEmailsForAuthenticated()
octokit.users.listFollowingForAuthenticatedUser()
has been renamed tooctokit.users.listFollowedByAuthenticated()
octokit.users.listGpgKeys()
has been renamed tooctokit.users.listGpgKeysForAuthenticated()
octokit.users.listPublicEmails()
has been renamed tooctokit.users.listPublicEmailsForAuthenticatedUser()
octokit.users.listPublicKeys()
has been renamed tooctokit.users.listPublicSshKeysForAuthenticated()
octokit.users.togglePrimaryEmailVisibility()
has been renamed tooctokit.users.setPrimaryEmailVisibilityForAuthenticated()