Errors

Ugrat uses conventional HTTP response codes to indicate the success or failure of a request. Error responses share the same envelope:

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "rate limit exceeded",
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

request_id identifies the request in our logs — include it when contacting support. Validation errors additionally carry a fields array with a stable machine-readable code per field (and optional meta, e.g. the maximum length):

{
  "success": false,
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "request validation failed",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "fields": [
      { "field": "recipient", "code": "invalid_phone" },
      { "field": "body", "code": "too_long", "meta": { "max": 800 } }
    ]
  }
}