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.
All pages
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.
- 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.
- 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.
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"
}