Use emergency controls

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

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

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.

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.

Getting Started

Vault Lifecycle

Operations

Resources

Use emergency controls

Prerequisites

1. Read the current controls

2. Pause one operation

3. Resume the operation

Confirm the control

​Prerequisites

​1. Read the current controls

​2. Pause one operation

​3. Resume the operation

​Confirm the control

Prerequisites

1. Read the current controls

2. Pause one operation

3. Resume the operation

Confirm the control