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.

{
  "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

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

keenauth organization-defaults get