Skip to content

Errors

Most errors look like:

{ "detail": "Repo not found" }

Validation errors may use FastAPI’s array-of-objects detail (loc, msg, type).

Status Typical cause
401 Missing or unknown Bearer token; OIDC exchange failed
403 BYO requires Pro; Git or contents transfer quota; contents file larger than 64 MiB
404 Unknown repo, token, webhook, bucket, contents path, or ref
409 Repository name already used
422 Quota, bad name, unverified bucket, IAM/S3 verify failure, webhook URL
429 Auth session or OIDC exchange rate limit
500 Unexpected, including some cold-cache BYO layer misses

GET /v1/repos/{user}/{repo}/commits and GET /v1/repos/{user}/{repo}/contents on a repo with no commits are 404 No commit found in the repository. GET /v1/repos/{user}/{repo}/branches on the same empty repo is 200 {"branches":[],"default_branch":"master"}.

Git HTTP uses Basic WWW-Authenticate and may surface a 401/403/500 to git as remote: ... plus a generic fatal line. Check the API error log for BYO, and token grants for 401.