
# Récupérer les valeurs par défaut des organisations

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

Renvoie les valeurs par défaut qu'utilisent toutes les organisations de cet environnement : le rôle d'administrateur de l'organisation, le rôle attribué aux nouveaux membres, la limite d'adhésions par utilisateur, la durée de validité des invitations, le délai de carence avant l'exécution d'une suppression d'organisation en libre-service, le sort des membres lorsqu'une organisation est supprimée, ainsi que les interrupteurs des rôles personnalisés d'organisation et de la suppression d'organisation en libre-service. Il existe un enregistrement par environnement, créé avec celui-ci. La réponse contient un en-tête `ETag` à envoyer dans `If-Match` lors de la mise à jour.

## Requête

| Champ | Type | Obligatoire | Description |
|---|---|---|---|

Aucun corps de requête.

## Réponse

`200 OK` avec les valeurs par défaut et l'en-tête `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
}
```

## Erreurs

| HTTP | code | Quand |
|---|---|---|
| 401 | `unauthenticated` | Le justificatif est absent, invalide ou révoqué. |
| 403 | `insufficient_permissions` | Le justificatif ne possède pas l'autorisation requise. |
| 429 | `rate_limited` | La limite de débit a été dépassée ; réessayez après la durée indiquée par `Retry-After`. |
| 503 | `service_unavailable` | Une dépendance est temporairement indisponible ; réessayez après la durée indiquée par `Retry-After`. |

## Exemple

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

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