メンバーシップを削除
DELETE /v1/organizations/{org_id}/memberships/{membership_id} · 権限 organizations:write
メンバーシップを削除します（理由は removed_by_admin）。組織の最後のアクティブな管理者は削除できません。If-Match は任意です。削除は organization_membership.deleted として監査されます。
リクエスト
| Field | Type | Required | Description |
|---|---|---|---|
org_id |
path | yes | 組織 ID（org_…）。 |
membership_id |
path | yes | メンバーシップ ID（mem_…）。 |
If-Match |
header | no | 現在の ETag。一致しない場合は 412。 |
リクエストボディはありません。
レスポンス
204 No Content を返します。
エラー
| HTTP | code | When |
|---|---|---|
| 404 | not_found |
このメンバーシップは、この組織に存在しません。 |
| 409 | last_org_admin |
このメンバーシップは、組織の最後のアクティブな管理者です。 |
| 412 | precondition_failed |
If-Match が現在のバージョンと一致しません。 |
| 401 | unauthenticated |
認証情報が指定されていないか、無効または取り消されています。 |
| 403 | insufficient_permissions |
認証情報に必要な権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After の期間を経てから再試行してください。 |
| 503 | service_unavailable |
依存先が一時的に利用できません。Retry-After の期間を経てから再試行してください。 |
例
curl -i -X DELETE "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/memberships/mem_01j9xn5p9s0t4v6w8x0y2z4a6c" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
個人データ
このエンドポイントは個人データ（組織のメンバーシップと招待）を扱います。KeenAuth API における個人データ では、保存される内容、保存期間、削除方法について説明しています。いかなるフィールドにも特別な種類の個人データ（健康、生体データ、宗教、政治的意見、性的指向）を送信しないでください。