> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yativo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Freeze / Unfreeze Card

> Temporarily freeze or unfreeze a virtual card

Freeze or unfreeze a virtual card. A frozen card declines all transactions until it is unfrozen.

```
PUT https://api.yativo.com/api/v1/customer/virtual/cards/update/{card_id}
```

<Note>
  Requires an `Idempotency-Key` header.
</Note>

## Path Parameters

<ParamField path="card_id" type="string" required>
  The virtual card ID.
</ParamField>

## Request Body

<ParamField body="action" type="string" required>
  `"freeze"` to block the card, or `"unfreeze"` to re-enable it.
</ParamField>

<RequestExample>
  ```bash Freeze theme={null}
  curl -X PUT 'https://api.yativo.com/api/v1/customer/virtual/cards/update/card_01HX9KZMB3F7VNQP8R2WDGT4E5' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -H 'Idempotency-Key: freeze-card-001' \
    -d '{ "action": "freeze" }'
  ```

  ```bash Unfreeze theme={null}
  curl -X PUT 'https://api.yativo.com/api/v1/customer/virtual/cards/update/card_01HX9KZMB3F7VNQP8R2WDGT4E5' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -H 'Idempotency-Key: freeze-card-001' \
    -d '{ "action": "unfreeze" }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "action": { ... }
  }
  ```
</ResponseExample>