Installation Not Held

installation-not-held · 403

The GitHub account signed in can't reach the installation named, so the API linked nothing.

Only installations the user's own GitHub account reaches can be linked. The answer is the same whether or not the installation exists, so it reveals nothing about anyone else's.

Besides the members every error carries, this type adds installationId.

Common causes

  • The installation belongs to a GitHub account or organisation the user isn't in.
  • The installation_id in GitHub's return link was changed by hand.

How to fix the call

  • Start the connect flow again and pick an installation from the list it offers.
  • If the repositories belong to an organisation, ask its owner to give the user access, or to install the app.

Example response

json
{
  "type": "installation-not-held",
  "title": "Installation Not Held",
  "detail": "Your GitHub account does not have access to that installation.",
  "installationId": "48210377",
  "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": 403,
  "docs": "https://ghaym.me/docs/errors/installation-not-held"
}