# KillSwitchStatus

> The KillSwitchStatus object in the Guv API.

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `engaged` * | boolean |  |
| `agents_read_only` | boolean |  |
| `source` | `dns_txt`, `probe_flag`, `api`, `tripwire` or null |  |
| `reason` | string or null |  |
| `engaged_by` | [Actor](/docs/api/objects/actor/) or any or null |  |
| `engaged_at` | string (date-time) or null |  |
| `signature_valid` | boolean | The out-of-band flag's signature verified. |
| `checked_at` * | string (date-time) |  |

\* always present

## Example

```json
{
  "engaged": false,
  "agents_read_only": false,
  "source": "dns_txt",
  "reason": "string",
  "engaged_by": {
    "type": "agent",
    "id": "tok_01jbx2m9k7q4r8t5v6w3y0z1tk",
    "display": "Stewart Webb via agent claude-code-on-stewart-laptop",
    "via_agent": {
      "id": "tok_01jbx2m9k7q4r8t5v6w3y0z1tk",
      "name": "claude-code-on-stewart-laptop"
    },
    "on_behalf_of": {
      "id": "usr_01jbx2m9k7q4r8t5v6w3y0z1us",
      "display": "Stewart Webb"
    }
  },
  "engaged_at": "2026-10-22T13:05:00Z",
  "signature_valid": false,
  "checked_at": "2026-10-22T13:05:00Z"
}
```

## Used by

- [AI ops kill switch status](/docs/api/admin/#ai-ops-kill-switch-status)
- [Turn the kill switch on (agents become read-only, agent tokens revoked)](/docs/api/admin/#turn-the-kill-switch-on-agents-become-read-only-agent-tokens-revoked)
- [Turn the kill switch off (passkey required)](/docs/api/admin/#turn-the-kill-switch-off-passkey-required)