
# 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`.

```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
}
```

## 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

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

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