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

```json
{
  "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

```bash
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"}'
```