Obtener los valores predeterminados de la organización

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

Devuelve los valores predeterminados que usan todas las organizaciones de este entorno: el rol de administrador de la organización, el rol que reciben los nuevos miembros, el límite de membresías por usuario, durante cuánto tiempo son válidas las invitaciones, el periodo de espera antes de que se ejecute una eliminación de organización por autoservicio, qué ocurre con los miembros cuando se elimina una organización, y los interruptores de roles personalizados de organización y de eliminación de organización por autoservicio. Hay un registro por entorno, creado junto con el entorno. La respuesta incluye un encabezado ETag que debe enviar como If-Match al actualizarlo.

Solicitud

Campo	Tipo	Obligatorio	Descripción

Sin cuerpo de solicitud.

Respuesta

200 OK con los valores predeterminados y el encabezado 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
}

Errores

HTTP	code	Cuándo
401	`unauthenticated`	La credencial falta, no es válida o ha sido revocada.
403	`insufficient_permissions`	La credencial no tiene el permiso requerido.
429	`rate_limited`	Se superó el límite de frecuencia; reintente después del periodo indicado en `Retry-After`.
503	`service_unavailable`	Una dependencia no está disponible temporalmente; reintente después del periodo indicado en `Retry-After`.

Ejemplo

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

keenauth organization-defaults get