# scim_temporarily_unavailable

<!-- Generated by scripts/generate.ts. Do not edit. -->

<!-- Source: core commit `f70874a3916ad5b24a8619246cbae6cc8bc24d27`. -->

<div data-pagefind-ignore>

Since API version `1.0`.

| Field     | Value         |
| --------- | ------------- |
| Type      | `unavailable` |
| Status    | 503           |
| Surfaces  | `scim`        |
| Retryable | Yes           |

</div>

## 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

- 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

### 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

- Nothing to change. Your identity provider retries automatically. If you pressed "Test connection" right after creating the directory, try it again.

## Example

HTTP status 503 in the SCIM error format, for a brand-new directory:

```http
HTTP/1.1 503 Service Unavailable
Content-Type: application/scim+json
Retry-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

The database is unavailable or re-homing; retry after `Retry-After`

## IT administrator message

Directory sync is briefly unavailable; your IdP will retry automatically

## 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`: <span lang="de" data-pagefind-ignore>Die Verzeichnissynchronisierung ist kurzzeitig nicht verfügbar; Ihr IdP versucht es automatisch erneut</span>
- `es`: <span lang="es" data-pagefind-ignore>La sincronización del directorio no está disponible momentáneamente; su IdP lo reintentará automáticamente</span>
- `fr`: <span lang="fr" data-pagefind-ignore>La synchronisation d'annuaire est brièvement indisponible ; votre IdP réessaiera automatiquement</span>
- `ja`: <span lang="ja" data-pagefind-ignore>ディレクトリ同期が一時的に利用できません。IdP が自動的に再試行します</span>
- `pt-BR`: <span lang="pt-BR" data-pagefind-ignore>A sincronização de diretório está temporariamente indisponível; seu IdP tentará novamente automaticamente</span>

Security invariants: 11b.
