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

# Use emergency controls

> Pause or resume individual MicroVault operations.

Emergency controls let you stop one class of vault activity without disabling unrelated operations.

| Operation         | Effect while paused                           |
| ----------------- | --------------------------------------------- |
| `subscriptions`   | Blocks new base-asset subscriptions.          |
| `redemptions`     | Blocks new instant and requested redemptions. |
| `share_transfers` | Blocks transfers between shareholder wallets. |
| `source_entries`  | Blocks moving base assets into yield sources. |
| `source_exits`    | Blocks initiating exits from yield sources.   |

Claims for completed requested redemptions remain available because the underlying obligation already exists.

## Prerequisites

* An active `VAULT_ID`
* The operation that should be paused or resumed
* `uuidgen` for the idempotency key

## 1. Read the current controls

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -sS "$GROUND_API/v2/microvaults/vaults/$VAULT_ID/pause-status" \
  -H "$AUTH" | jq
```

Each response field is `true` when that capability is paused.

## 2. Pause one operation

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -sS -X PUT "$GROUND_API/v2/microvaults/vaults/$VAULT_ID/pause" \
  -H "$AUTH" -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"operation":"subscriptions","paused":true}' | jq
```

The response contains a task for the onchain control change. Other operations retain their current settings.

## 3. Resume the operation

Submit the same operation with `paused: false` and a new idempotency key.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -sS -X PUT "$GROUND_API/v2/microvaults/vaults/$VAULT_ID/pause" \
  -H "$AUTH" -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"operation":"subscriptions","paused":false}' | jq
```

## Confirm the control

After the task confirms, fetch `pause-status` again and verify the selected field. Treat the previous setting as active until the onchain update is confirmed.
