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 access-token; OIDC exchange failed |
| 403 | BYO requires Pro; Git quota abuse on paid plans |
| 404 | Unknown repo, token, webhook, or bucket |
| 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 |
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.