Replacing the GitHub Apps "Creating an installation access token" endpoint

We are announcing the deprecation plan of the previously deprecated "Create an installation access token" endpoint: POST /installations/:installation_id/access_tokens.

The supported replacement endpoint is named consistently with other GitHub Apps API endpoints and has been available since 2018.

Deprecation Timeline

Brownouts

During a brownout, calls to the old version of this endpoint will temporarily fail. The goal is to trigger alerts (assuming there are any) on our customers' services to help find unmigrated endpoint calls.

The brownouts are scheduled for:

  • August 1 2020

    • From 7:00 AM UTC - 10:00 AM UTC
    • From 4:00 PM UTC - 7:00 PM UTC
  • September 1 2020

    • From 7:00 AM UTC - 10:00 AM UTC
    • From 4:00 PM UTC - 7:00 PM UTC

Removal Date

The legacy "Create an installation access token" endpoint will be disabled at the earliest on October 1 2020.

Changes to make

Replace all uses of the deprecated endpoint for creating an installation token for a GitHub App with the new endpoint:

POST /app/installations/:installation_id/access_tokens

If you have any questions or feedback, please let us know!