Standardwerte der Organisation abrufen

GET /v1/organization-defaults · Berechtigung organizations:read

Gibt die Standardwerte zurück, die jede Organisation in dieser Umgebung verwendet: die Administratorrolle der Organisation, die Rolle, die neue Mitglieder erhalten, das Mitgliedschaftslimit pro Benutzer, wie lange Einladungen gültig bleiben, die Wartezeit, bevor eine selbstbediente Löschung der Organisation ausgeführt wird, was mit Mitgliedern geschieht, wenn eine Organisation gelöscht wird, sowie die Schalter für benutzerdefinierte Organisationsrollen und die selbstbediente Löschung von Organisationen. Es gibt einen Datensatz pro Umgebung, der mit der Umgebung erstellt wird. Die Antwort enthält einen ETag-Header, den Sie beim Aktualisieren als If-Match senden.

Anfrage

Feld	Typ	Erforderlich	Beschreibung

Kein Request-Body.

Antwort

200 OK mit den Standardwerten und dem ETag-Header.

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

Fehler

HTTP	code	Wann
401	`unauthenticated`	Die Anmeldeinformation fehlt, ist ungültig oder wurde widerrufen.
403	`insufficient_permissions`	Die Anmeldeinformation besitzt die erforderliche Berechtigung nicht.
429	`rate_limited`	Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach der Zeitspanne aus `Retry-After`.
503	`service_unavailable`	Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach der Zeitspanne aus `Retry-After`.

Beispiel

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

keenauth organization-defaults get