Verzeichnisse auflisten

GET /v1/directories · Berechtigung directories:read

Listet die SCIM-Verzeichnisse der Umgebung auf, die neuesten zuerst. Es gibt nur Vorwärtspaginierung; der Cursor ist an die Filter gebunden. Es werden keine Tokens, Token-Digests oder personenbezogenen Daten zurückgegeben; die offene Massen-Deprovisionierungssperre wird über GET /v1/directories/{directory_id} angezeigt.

Anfrage

Feld Typ Pflicht Beschreibung
organization_id Query nein Nur Verzeichnisse dieser Organisation (org_…).
type Query nein Nur Verzeichnisse dieses Typs (scim).
state Query nein Nur Verzeichnisse in diesem Status (inactive, active).
limit Query nein 1–100, Standard 20.
after Query nein Der Cursor aus list_metadata.after.

Es gibt keinen Request-Body.

Antwort

200 OK mit einer Seite von Verzeichnissen.

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

Fehler

HTTP code Wann
400 invalid_cursor Der Cursor ist ungültig oder gehört zu einem anderen Verzeichnis oder Filter.
422 validation_failed Ein Filter ist fehlerhaft oder doppelt, limit liegt außerhalb des Bereichs, oder before bzw. order wurde angegeben.
401 unauthenticated Die Anmeldeinformation fehlt, ist ungültig oder widerrufen.
403 insufficient_permissions Die Anmeldeinformation besitzt nicht die erforderliche Berechtigung.
429 rate_limited Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach der Zeit aus Retry-After.
503 service_unavailable Die Verzeichnissynchronisation ist vorübergehend nicht verfügbar oder in dieser Bereitstellung nicht konfiguriert; wiederholen Sie die Anfrage nach der Zeit aus Retry-After.

Beispiel

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