Identity Service Unavailable

auth-directory-unavailable · 503

The API couldn't ask the identity service about this account, so the call needing the answer changed nothing.

The call needed something only the identity service knows: the phone check every launch, deploy and wake makes, or the API key behind a database tunnel. detail says whether waiting helps.

This type adds no members to the ones every error carries.

Common causes

  • The identity service is unreachable or failed to answer.
  • This deployment of the API can't ask the identity service at all. detail then says retrying will not change that.

How to fix the call

  • When detail says to try again shortly, retry after a wait, with a growing delay.
  • When detail says retrying will not change that, stop and tell the user to contact support.
  • Don't send the user to verify their phone again: this answer says nothing about whether they have.

Example response

json
{
  "type": "auth-directory-unavailable",
  "title": "Identity Service Unavailable",
  "detail": "The identity service could not be reached, so this account's verification state is unknown. Nothing has changed; try again shortly.",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments",
  "method": "POST",
  "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments",
  "status": 503,
  "docs": "https://ghaym.me/docs/errors/auth-directory-unavailable"
}