Weise eine Anwendung in einer Organisation zu

POST /v1/organizations/{org_id}/applications/{application_id}/assignments · Berechtigung organizations:write

Weist die Anwendung einer Mitgliedschaft oder einer Verzeichnisgruppe der Organisation zu. Für eine Anwendung im Modus assigned_only erfordert die Anmeldung über die Organisation zusätzlich, dass die Mitgliedschaft des Benutzers oder eine seiner Verzeichnisgruppen zugewiesen ist. Die Anwendung muss zuvor in der Organisation aktiviert sein. Verzeichnisgruppen stammen aus SCIM; das Löschen einer Gruppe löscht ihre Zuweisungen. Idempotency-Key ist optional.

Anfrage

Parameter In Erforderlich Beschreibung
org_id path ja Organisations-ID (org_…).
application_id path ja Anwendungs-ID (app_…).
target_type string ja membership oder directory_group.
target_id string ja Ziel-ID; ihr Präfix muss zu target_type passen (mem_… oder dsg_…).

Antwort

201 Created mit der Zuweisung.

{
  "id": "aas_01j9xq6r0t1v5w7x9y1z3a5b7d",
  "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "application_id": "app_01j9xm4n8r9s3t5v7w9x1y3z5b",
  "target_type": "membership",
  "target_id": "mem_01j9xn5p9s0t4v6w8x0y2z4a6c",
  "created_at": "2026-10-12T09:31:00.123456Z"
}

Fehler

HTTP code Wann
404 not_found Die Organisation, Anwendung oder das Ziel existiert nicht in dieser Organisation.
409 application_not_enabled Die Anwendung ist in der Organisation nicht aktiviert.
409 conflict Das Ziel ist bereits zugewiesen.
409 organization_pending_deletion Die Organisation hat eine ausstehende Löschung.
422 validation_failed target_type oder target_id fehlt oder ist ungültig.
401 unauthenticated Der Berechtigungsnachweis fehlt, ist ungültig oder widerrufen.
403 insufficient_permissions Der Berechtigungsnachweis hat nicht die erforderliche Berechtigung.
429 rate_limited Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach dem Zeitraum Retry-After.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach dem Zeitraum Retry-After.

Beispiel

curl -i -X POST "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/applications/app_01j9xm4n8r9s3t5v7w9x1y3z5b/assignments" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target_type":"membership","target_id":"mem_01j9xn5p9s0t4v6w8x0y2z4a6c"}'