# Cancelar Item
`PATCH /v1/subscriptions/:subscriptionId`
**Área:** Assinaturas

**Scopes necessários:** `subscriptions/write`

Remove um **item** da assinatura sem cancelar a assinatura inteira.

Envie apenas `old.itemId` — **não informe** o campo `new`. A ausência de `new` indica cancelamento de item.

Case de uso:

_Como SaaS, quero remover um add-on da assinatura do cliente mantendo o plano principal ativo._

### Path parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `subscriptionId` | **sim** | ID da assinatura (ex: sub_xxx) - required |

### Request body

```json
{
  "old": {
    "itemId": "item_xxx"
  }
}
```

### Campos do body

**Obrigatórios:** `old`, `old.itemId`

| Campo | Descrição |
|---|---|
| `old` |  |
| `old.itemId` | ID do item a remover |

### Resposta 200 — 200

```json
{
  "success": true,
  "type": "ITEM_CANCELED",
  "itemId": "item_xxx"
}
```

### Resposta 400 — 400

```json
{
    "error": {
        "message": "old.itemId é obrigatório",
        "code": "MISSING_ITEM_ID",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}
```

### Resposta 404 — 404

```json
{
    "error": {
        "message": "Item não encontrado",
        "code": "ITEM_NOT_FOUND",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/patch-cancelar-item
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json