# 組織内でアプリケーションを割り当て

`POST /v1/organizations/{org_id}/applications/{application_id}/assignments` · 権限 `organizations:write`

アプリケーションを組織内のメンバーシップまたはディレクトリグループに割り当てます。`assigned_only` モードのアプリケーションでは、組織サインインに、ユーザーのメンバーシップまたはユーザーのディレクトリグループのいずれかが割り当てられていることが追加で必要です。アプリケーションは先に組織内で有効化されている必要があります。ディレクトリグループは SCIM から取得されます。グループを削除すると、そのグループの割り当ても削除されます。`Idempotency-Key` は任意です。

## リクエスト

| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
| `org_id` | path | はい | 組織 ID (`org_…`)。 |
| `application_id` | path | はい | アプリケーション ID (`app_…`)。 |
| `target_type` | string | はい | `membership` または `directory_group`。 |
| `target_id` | string | はい | ターゲット ID。プレフィックスは `target_type` と一致している必要があります(`mem_…` または `dsg_…`)。 |

## レスポンス

`201 Created` と割り当てを返します。

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

## エラー

| HTTP | code | 発生条件 |
|---|---|---|
| 404 | `not_found` | この組織内に、組織、アプリケーション、またはターゲットが存在しません。 |
| 409 | `application_not_enabled` | アプリケーションが組織内で有効化されていません。 |
| 409 | `conflict` | ターゲットはすでに割り当て済みです。 |
| 409 | `organization_pending_deletion` | 組織が削除保留中です。 |
| 422 | `validation_failed` | `target_type` または `target_id` がないか、無効です。 |
| 401 | `unauthenticated` | 認証情報が未指定、無効、または失効しています。 |
| 403 | `insufficient_permissions` | 認証情報に必要な権限がありません。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` の期間が経過してから再試行してください。 |
| 503 | `service_unavailable` | 依存先が一時的に利用できません。`Retry-After` の期間が経過してから再試行してください。 |

## 例

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