logoshorty

HTTP 503

service_unavailable — Shorty API error

Service unavailable (HTTP 503): when the Shorty API returns the service_unavailable error, why, and how to fix it.

Open in ClaudeOpen in ChatGPT
CodeHTTP statusType URI
service_unavailable503https://aishorty.com/docs/api/errors/service_unavailable

When it happens

A known upstream dependency (the GPU transcription service or the summary queue) could not start the requested job right now. A deliberate, mapped unavailability — not an unexpected crash.

Example response

{
  "type": "https://aishorty.com/docs/api/errors/service_unavailable",
  "title": "Service unavailable",
  "status": 503,
  "detail": "The transcription service is temporarily unavailable.",
  "instance": "urn:request:req_01J9Z8ABCDEFGH0123456789",
  "code": "service_unavailable",
  "request_id": "req_01J9Z8ABCDEFGH0123456789"
}

How to fix it

Retry with backoff; this is transient. The SDK retries 503s automatically.

Related errors