SERVICE_UNAVAILABLE

Summary

This error corresponds to the standard 503 Service Unavailable HTTP status code, indicating that the server is temporarily unable to handle the request.

Example Response

{
    "code": "SERVICE_UNAVAILABLE",
    "type": "https://docs.leyr.io/api/error-handling/service_unavailable",
    "title": "Service unavailable",
    "status": 503,
    "detail": "Service temporarily unavailable. This may be due to maintenance or high system load. Please retry your request after a brief delay.",
    "instance": "36b5909e-4391-4520-b303-84cbb80c4264"
}

Common Causes

  • Scheduled system maintenance is in progress
  • The server is experiencing unusually high load
  • A critical service dependency or Network connectivity between services is temporarily unavailable

Resolution Steps

To handle this error effectively:

  1. Retry your request after a brief delay, as the issue might be temporary. Implementing progressive retries (e.g. 1s, 5s, 15s, 30s, 1m) could be a good option in a long term, but we also don't expect this error to happen often.
  2. If the issue persists beyond several retry attempts, contact our support team at contact@leyr.io with the following information:
    • The instance ID from the error response
    • A description of what you were trying to achieve
Table of Contents