Installation Not Found

installation-not-found · 404

Neither GitHub nor this workspace knows the GitHub App installation the request named.

One that is in another workspace answers this same 404, never a 403, so it can't be told apart from one that doesn't exist. resourceId repeats the identifier the API looked up. On a claim, resourceId is GitHub's number for the installation, and GitHub didn't recognise it.

Besides the members every error carries, this type adds resourceType and resourceId.

Common causes

  • The identifier is wrong: a typo, a cut-off id, or one copied from another workspace.
  • The GitHub App installation was deleted between the call that listed it and this one.
  • The call ran in another workspace than the one that holds it: a call runs in the workspace its X-Ghaym-Workspace header names, or a stream's ?workspace=<id> when the header is absent.
  • The app was removed on GitHub before the claim finished.

How to fix the call

  • Read resourceId and compare it with the value you meant to send.
  • List them again with ghaym cloud git installations and take the identifier from that answer, not from a cached or typed value.
  • If the identifier is right and recent, send X-Ghaym-Workspace with the workspace that holds it.
  • Don't retry unchanged: the same call answers the same 404 for as long as nothing changes.
  • Install the app again from the address ghaym cloud git install prints.

Example response

json
{
  "type": "installation-not-found",
  "title": "Installation Not Found",
  "detail": "GitHub does not recognize this installation for the Ghaym Cloud app.",
  "resourceType": "Installation",
  "resourceId": "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": 404,
  "docs": "https://ghaym.me/docs/errors/installation-not-found"
}