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.
{
"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
curl -i -X GET "https://api.eu.keenauth.com/v1/organization-defaults" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
keenauth organization-defaults get