# 초대 취소

`POST /fapi/v1/organizations/{org_id}/invitations/{invitation_id}:revoke` · 환경의 로그인 호스트에서 호출

대기 중인 초대를 취소합니다. 응답은 취소된 초대이며, 주소는 삭제되었습니다(`email`은 `null`). 대기 상태가 아닌 초대(수락, 만료 또는 이미 취소됨)는 `422 invitation_invalid`를 반환합니다.

인증된 사용자의 `__Host-idp_session` 쿠키(정확히 일치하는 `Origin` 포함) 또는 자사 앱의 프런트 API 액세스 토큰(DPoP 증명과 함께 `Authorization: DPoP <token>`; [프런트 API 액세스 토큰](/docs/api/fapi/front-api-token) 참조)이 필요합니다. 사용자는 조직의 활성 구성원이면서 `idp_members:invite` 권한을 보유해야 합니다. 구성원이 아닌 사용자는 `404 not_found`를, 권한이 없는 구성원은 `403 insufficient_permissions`를 받습니다. 특권 역할이 포함된 초대는 관리자 역할을 보유한 구성원만 취소할 수 있습니다(`403 role_not_assignable`).

`@keenauth/js` 사용 시: `await keenauth.organizations.revokeInvitation(orgId, invitationId)`.

## 요청

헤더:

| 헤더 | 필수 | 설명 |
| --- | --- | --- |
| `Idp-Client` | 예 | SDK 식별자. |
| `Origin` | 쿠키 사용 시 예 | `https://<sign-in host>`. |

`org_id`: 조직 식별자(`org_…`). `invitation_id`: 초대 식별자(`inv_…`), 즉 [초대](/docs/api/fapi/organizations/invitations/create)의 `id`.

본문 없음.

## 응답

초대와 `ETag: "<version>"`를 포함한 `200 OK`를 반환합니다.

## 오류

| 상태 | 코드 | 발생 조건 |
| --- | --- | --- |
| 401 | `unauthenticated` | 유효한 세션 쿠키 또는 토큰이 없습니다. |
| 403 | `insufficient_permissions` | 사용자에게 조직의 `idp_members:invite` 권한이 없습니다. |
| 403 | `role_not_assignable` | 초대에 특권 역할이 포함되어 있으며 사용자가 관리자 역할을 보유하지 않았습니다. |
| 403 | `origin_not_allowed` | `Origin`이 일치하지 않습니다. |
| 404 | `not_found` | 해당 사용자에게 조직 또는 초대가 없습니다. 알 수 없거나, 형식이 잘못되었거나, 다른 사용자의 식별자도 같은 응답을 받습니다. |
| 409 | `organization_disabled` | 조직이 비활성화되었거나 삭제 대기 중입니다(`organization_pending_deletion`). |
| 422 | `invitation_invalid` | 초대가 대기 상태가 아닙니다. |
| 503 | `service_unavailable` | 일시적으로 사용할 수 없습니다. `Retry-After` 이후 다시 시도하십시오. |

## 예제

```bash
curl -X POST "https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a/invitations/inv_01jbz6x8kq3m2n4p5r6s7t8v9d:revoke" \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -b cookies.txt
```

```json
{
  "id": "inv_01jbz6x8kq3m2n4p5r6s7t8v9d",
  "email": null,
  "role_ids": ["rol_01jbz6x8kq3m2n4p5r6s7t8v9w"],
  "delivery": "email",
  "delivery_status": "sent",
  "status": "revoked",
  "send_count": 1,
  "last_sent_at": "2026-11-03T10:00:00Z",
  "expires_at": "2026-11-10T10:00:00Z",
  "accepted_user_id": null,
  "accepted_at": null,
  "revoked_at": "2026-11-03T11:00:00Z",
  "created_at": "2026-11-03T10:00:00Z",
  "updated_at": "2026-11-03T11:00:00Z",
  "version": 2
}
```

## 개인정보

이 엔드포인트는 개인정보(조직 구성원 자격과 초대)를 다룹니다. [KeenAuth API의 개인정보](/docs/policies/personal-data)에서 저장되는 항목, 보관 기간, 삭제 방법을 설명합니다. 어떤 필드에도 특수 범주의 개인정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.