scim_temporarily_unavailable
Developer and IT administrator messages for scim_temporarily_unavailable.
Since API version 1.0.
| Field | Value |
|---|---|
| Type | unavailable |
| Status | 503 |
| Surfaces | scim |
| Retryable | Yes |
What it means
Section titled “What it means”The SCIM endpoint cannot serve the request right now. The response carries a Retry-After header with the number of seconds to wait. A directory created moments ago also gets this answer, with Retry-After: 1, until its token is ready, usually within a second.
Likely causes
Section titled “Likely causes”- The directory and its bearer token were created a moment ago, and the identity provider’s first request arrived before the token was ready.
- The database is briefly unavailable or the directory’s data is moving to another region.
How to fix it
Section titled “How to fix it”For developers
Section titled “For developers”- Retry after the number of seconds in
Retry-After. Identity providers do this on their own. - In scripts or tests that create a directory and call it at once, retry this response instead of failing.
For IT administrators
Section titled “For IT administrators”- Nothing to change. Your identity provider retries automatically. If you pressed “Test connection” right after creating the directory, try it again.
Example
Section titled “Example”HTTP status 503 in the SCIM error format, for a brand-new directory:
HTTP/1.1 503 Service UnavailableContent-Type: application/scim+jsonRetry-After: 1
{ "schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"], "status": "503", "detail": "scim_temporarily_unavailable: this directory was just created; retry in a second"}Developer message
Section titled “Developer message”The database is unavailable or re-homing; retry after Retry-After
IT administrator message
Section titled “IT administrator message”Directory sync is briefly unavailable; your IdP will retry automatically
Translated IT administrator messages
Section titled “Translated IT administrator messages”The hosted portal shows these machine translations, which native speakers have not reviewed yet. Placeholders and identity provider console labels stay in English.
de: Die Verzeichnissynchronisierung ist kurzzeitig nicht verfügbar; Ihr IdP versucht es automatisch erneutes: La sincronización del directorio no está disponible momentáneamente; su IdP lo reintentará automáticamentefr: La synchronisation d’annuaire est brièvement indisponible ; votre IdP réessaiera automatiquementja: ディレクトリ同期が一時的に利用できません。IdP が自動的に再試行しますpt-BR: A sincronização de diretório está temporariamente indisponível; seu IdP tentará novamente automaticamente
Security invariants: 11b.