Skip to content

Service Unavailable

URI: https://docs.ankatech.co/errors/service-unavailable
HTTP Status: 503 Service Unavailable

When you see this

The service is temporarily unable to handle your request due to maintenance, overload, or dependency failures.

Common Causes

  • The service is undergoing scheduled maintenance or updates.
  • A required backend service or dependency is unreachable or down.
  • The system is experiencing high load and cannot process additional requests.
  • Database connections are exhausted or unavailable.
  • A tenant activation could not keep a waiting member's link revocable, or could not issue its invitation, because the token registry could not be reached. The tenant stays PROVISIONING, no member was mailed, and the retry issues every link. The response carries Retry-After.
  • External service dependencies (authentication, licensing, etc.) are not responding.
  • A keystore import or preview found the cryptographic service at its limit of concurrent keystore loads, in all or for the tenant, on the instance that answered. The response carries a Retry-After of 1 to 60 seconds, and nothing was imported.

How to Resolve

  1. Wait a few moments and retry your request - the issue may be temporary.
  2. Check the service status page if available for maintenance notifications.
  3. If the error persists, implement exponential backoff in your retry logic.
  4. Verify that all required services and dependencies are operational.
  5. Contact support if the service remains unavailable for an extended period.

The service typically returns a Retry-After header when possible. Check this header to determine when to retry your request.