ReferenceError Codes
Error Codes
All SilentAuth API errors return a JSON body with a code and message field. Use the code for programmatic handling and the message for debugging.
Error Response Shape
{
"error": {
"code": "intent_expired",
"message": "Intent int_xK9mNpQ2 expired at 2024-01-15T11:30:00Z",
"request_id": "req_abc123"
}
}| Code | Status | Description |
|---|---|---|
| intent_not_found | 404 | The specified intent ID does not exist in your project. |
| intent_expired | 410 | The intent has passed its expiry time and can no longer be approved. |
| intent_already_resolved | 409 | The intent has already been approved, denied, or cancelled. |
| permit_invalid | 400 | The permit token is malformed, has an invalid signature, or has been tampered with. |
| permit_expired | 401 | The permit token has passed its expiry time. |
| permit_already_used | 409 | A single-use permit has already been consumed. |
| policy_violation | 403 | The intent violates one or more project policy rules and was automatically rejected. |
| unauthorized | 401 | The API key is missing, invalid, or does not have access to this project. |
| forbidden | 403 | Your plan does not support this feature or you lack the required role. |
| rate_limited | 429 | You have exceeded the request rate limit. See the Rate Limits page. |
| project_not_found | 404 | The specified project ID does not exist or you do not have access. |
| approver_not_found | 422 | One or more specified approvers do not exist in this project. |
| webhook_signature_invalid | 400 | The webhook signature header does not match the expected HMAC. |
| internal_error | 500 | An unexpected error occurred. Retry with exponential backoff. Contact support if it persists. |