Listar directorios

GET /v1/directories · permiso directories:read

Lista los directorios SCIM del entorno, del más reciente al más antiguo. Solo existe paginación hacia adelante; el cursor está ligado a los filtros. No se devuelven tokens, digests de tokens ni datos personales; la retención de desaprovisionamiento masivo abierta se muestra con GET /v1/directories/{directory_id}.

Solicitud

Campo	Tipo	Obligatorio	Descripción
`organization_id`	query	no	Solo los directorios de esta organización (`org_…`).
`type`	query	no	Solo los directorios de este tipo (`scim`).
`state`	query	no	Solo los directorios en este estado (`inactive`, `active`).
`limit`	query	no	De 1 a 100, predeterminado 20.
`after`	query	no	El cursor de `list_metadata.after`.

No hay cuerpo de solicitud.

Respuesta

200 OK con una página de directorios.

{
  "data": [
    {
      "id": "dir_01j9xm2n4p6q8r0s2t4v6w8y0z",
      "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "type": "scim",
      "name": "Okta",
      "state": "inactive",
      "base_url": "https://acme.eu.keenauth.app/scim/v2/dir_01j9xm2n4p6q8r0s2t4v6w8y0z",
      "created_at": "2026-10-19T09:31:00.123456Z",
      "last_request_at": null,
      "provisioning_mode": "user_store",
      "attribute_allowlist": [],
      "unverified_domain_action": "invite",
      "delete_action": "remove_membership",
      "on_delete_memberships": "keep",
      "mass_deprovision_guard": {"enabled": true, "percent": 10, "absolute_min": 25},
      "send_welcome_email": false
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Errores

HTTP	code	Cuándo
400	`invalid_cursor`	El cursor no es válido o pertenece a otro directorio o filtro.
422	`validation_failed`	Un filtro está mal formado o repetido, `limit` está fuera de rango, o se indicó `before` u `order`.
401	`unauthenticated`	La credencial falta, no es válida o fue 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 tiempo indicado en `Retry-After`.
503	`service_unavailable`	La sincronización de directorios no está disponible temporalmente o no está configurada en este despliegue; reintente después del tiempo indicado en `Retry-After`.

Ejemplo

curl -i "https://api.eu.keenauth.com/v1/directories?organization_id=org_01j9xk3m7q8r2s4t6v8w0y2z4a&limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"