Invalid Installation State

invalid-installation-state · 401

The token that ties a GitHub install to the person who started it was refused, so nothing was linked.

The token is signed for the user and the workspace that started the connect flow, and lasts 10 minutes.

This type adds no members to the ones every error carries.

Common causes

  • More than 10 minutes passed between starting the connect flow and finishing it on GitHub.
  • The flow was finished by another user, or in another workspace, than the one that started it.
  • The token was changed or put together by hand.

How to fix the call

  • Start the connect flow again from the console and finish it in one go.
  • Don't build the callback by hand: the token can't be guessed.
  • This one needs the user: an agent can't finish a GitHub install alone.

Example response

json
{
  "type": "invalid-installation-state",
  "title": "Invalid Installation State",
  "detail": "The GitHub install session is invalid or has expired. Restart the connect flow.",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/git/installations/claim",
  "method": "POST",
  "instance": "POST /v1/git/installations/claim",
  "status": 401,
  "docs": "https://ghaym.me/docs/errors/invalid-installation-state"
}