
# Recupera le impostazioni predefinite dell'organizzazione

`GET /v1/organization-defaults` · autorizzazione `organizations:read`

Restituisce le impostazioni predefinite che ogni organizzazione di questo ambiente utilizza: il ruolo di amministratore dell'organizzazione, il ruolo assegnato ai nuovi membri, il limite di appartenenze per utente, per quanto tempo restano valide le inviti, il periodo di attesa prima che una cancellazione self-service dell'organizzazione venga eseguita, cosa succede ai membri quando un'organizzazione viene eliminata, e gli interruttori per i ruoli personalizzati dell'organizzazione e per la cancellazione self-service. C'è un record per ambiente, creato insieme all'ambiente. La risposta contiene un header `ETag` da inviare come `If-Match` quando lo aggiorni.

## Richiesta

| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|

Nessun corpo della richiesta.

## Risposta

`200 OK` con le impostazioni predefinite e l'header `ETag`.

```json
{
  "org_admin_role_id": "rol_01j9xs0a2b4c6d8e0f2g4h6j8k",
  "default_member_role_id": "rol_01j9xs0a2b4c6d8e0f2g4h6j8m",
  "max_memberships_per_user": 200,
  "invitation_ttl_days": 7,
  "org_self_service_deletion_grace_days": 14,
  "on_org_delete_members": "detach",
  "org_custom_roles_enabled": false,
  "org_self_delete_enabled": false,
  "updated_at": "2026-11-03T09:30:00.123456Z",
  "version": 1
}
```

## Errori

| HTTP | code | Quando |
|---|---|---|
| 401 | `unauthenticated` | La credenziale manca, non è valida o è stata revocata. |
| 403 | `insufficient_permissions` | La credenziale non ha l'autorizzazione richiesta. |
| 429 | `rate_limited` | È stato superato il rate limit; riprova dopo il periodo indicato in `Retry-After`. |
| 503 | `service_unavailable` | Una dipendenza non è temporaneamente disponibile; riprova dopo il periodo indicato in `Retry-After`. |

## Esempio

```bash
curl -i -X GET "https://api.eu.keenauth.com/v1/organization-defaults" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

```bash
keenauth organization-defaults get
```
