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

# Identity kill switch APIs

> Pause credential minting and revoke all minted credentials for incident response.

Use kill-switch endpoints during security incidents.

## POST `/v1/identity/kill-switch/minting`

Pause or resume minting.

<CodeGroup>
  ```bash curl theme={null}
  curl -sS -X POST "https://api.clawb.ai/api/v1/identity/kill-switch/minting" \
    -H "Content-Type: application/json" \
    -H "X-Clawb-Api-Key: ck_live_replace_me" \
    -d '{"paused": true, "reason": "incident INC-123"}'
  ```

  ```python Python SDK theme={null}
  # Pause all minting in this workspace.
  provider.identity_kill_switch_minting(paused=True, reason="incident INC-123")

  # Resume after remediation.
  provider.identity_kill_switch_minting(paused=False, reason="incident closed")
  ```
</CodeGroup>

### Example response

<CodeGroup>
  ```json JSON theme={null}
  {
    "ok": true,
    "minting_paused": true,
    "reason": "incident INC-123"
  }
  ```
</CodeGroup>

## POST `/v1/identity/kill-switch/revoke-all`

Sets a workspace cutoff timestamp so existing minted credentials are treated as revoked.

<CodeGroup>
  ```bash curl theme={null}
  curl -sS -X POST "https://api.clawb.ai/api/v1/identity/kill-switch/revoke-all" \
    -H "Content-Type: application/json" \
    -H "X-Clawb-Api-Key: ck_live_replace_me" \
    -d '{"reason":"key compromise"}'
  ```

  ```python Python SDK theme={null}
  provider.identity_kill_switch_revoke_all(reason="key compromise")
  ```
</CodeGroup>

### Example response

<CodeGroup>
  ```json JSON theme={null}
  {
    "ok": true,
    "all_credentials_revoked_at": "2026-02-28T00:00:00Z",
    "reason": "key compromise"
  }
  ```
</CodeGroup>

## GET `/v1/identity/kill-switch/status`

<CodeGroup>
  ```bash curl theme={null}
  curl -sS "https://api.clawb.ai/api/v1/identity/kill-switch/status" \
    -H "X-Clawb-Api-Key: ck_live_replace_me"
  ```

  ```python Python SDK theme={null}
  status = provider.identity_kill_switch_status()
  print(status)
  # {
  #   "ok": True,
  #   "minting_paused": False,
  #   "all_credentials_revoked_at": None
  # }
  ```
</CodeGroup>

### Example response

<CodeGroup>
  ```json JSON theme={null}
  {
    "ok": true,
    "minting_paused": false,
    "all_credentials_revoked_at": null
  }
  ```
</CodeGroup>

## Incident sequence

1. Pause minting.
2. Revoke all credentials.
3. Rotate keys and fix root cause.
4. Verify status.
5. Resume minting only after validation.