# cancel entitlement

`POST https://api.suger.cloud/org/{orgId}/entitlement/{entitlementId}/cancel`

Cancel the active subscription. Azure cancels immediately (no body); AWS submits a cancellation request and requires a JSON body with reasonCode.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |
| `entitlementId` | path | string | yes | Entitlement ID |

## Request Body

Optional.

Content-Type: `application/json` · Schema: `EntitlementCancellationRequestInput`

## Responses

### 200 — the canceled Entitlement

Content-Type: `application/json` · Schema: `WorkloadEntitlement`

### 400 — Bad request error

Content-Type: `application/json`

### 404 — Not found

Content-Type: `application/json`

### 500 — Internal server error

Content-Type: `application/json`

---

Interactive API reference: https://doc.suger.io/api/