Errors

Standard shape

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Invalid JSON body",
    "details": {}
  }
}

Common codes

• UNAUTHORIZED (401): missing/invalid key
• FORBIDDEN (403): missing scope or cross-project access
• NOT_FOUND (404): resource not found in project boundary
• BAD_REQUEST (400): malformed input
• INTERNAL_ERROR (500): unexpected backend failure
• UPSTREAM_ERROR (500): provider/auth lookup failure
• ENTITLEMENT_VIOLATION (403): plan-gated action blocked
• AGENT_LIMIT_EXCEEDED (403): project over agent quota
• ALWAYS_ON_NOT_ALLOWED (403): always-on not enabled in plan