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

# Freeze and unfreeze

> Control a card while keeping its actual status visible.

## Request

Use a key with `cards:write` and a card ID from your company's card list.

```bash theme={null}
curl -X PATCH "$PLANE_API_BASE/api/v1/cards/CARD_ID" \
  -H "Authorization: Bearer $PLANE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"status":"frozen"}'
```

To unfreeze, send `{"status":"active"}` to the same endpoint.

## Confirm status

Read the card list again and display the confirmed status. Keep the previous status visible with a pending indicator if a provider result is unresolved. A network error alone does not prove that the requested change failed.

These controls do not cancel a card or withdraw its balance. Card cancellation is not part of the current public API. Live controls require production access and a supported provider integration.