Repository Not Found

repository-not-found · 404

The repository the request named is not one the API can reach through GitHub.

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. Here resourceId is the repository as owner/repo, and detail says which check failed: no connected installation covers it, or GitHub answered that it doesn't exist.

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 repository 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.
  • No GitHub App installation in this workspace covers the repository: the app wasn't given access to it.
  • The repository was renamed, moved or deleted on GitHub.

How to fix the call

  • Read resourceId and compare it with the value you meant to send.
  • List them again 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.
  • If the repository is right, give the app access to it on GitHub, then send the same call again.
  • List what this workspace can reach with ghaym cloud git installations.

Example response

json
{
  "type": "repository-not-found",
  "title": "Repository Not Found",
  "detail": "GitHub repository 'acme/storefront' is not available through your connected GitHub installations.",
  "resourceType": "Repository",
  "resourceId": "acme/storefront",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/git/branches",
  "method": "GET",
  "instance": "GET /v1/git/branches",
  "status": 404,
  "docs": "https://ghaym.me/docs/errors/repository-not-found"
}