OPopal
agent-activity

Get the agent kill switch

Changed on

Prototype (AG-297). Returns whether agent tool calls are currently being denied for this organization, and the activation that is in force or that last was.

active is evaluated against the clock on every read, so an activation past its expires_at reads as inactive without anything having swept it.

get/agent-kill-switch

Request

  • Base URL
    https://api.opal.dev/v1
  • Auth
    HTTP bearer

Response

The current state of the kill switch.

activeboolean required

Whether agent tool calls are being denied right now. This is the field to read; it already accounts for expiry.

activated_atstring date-time

When the latest activation was turned on. Absent if it never has been.

activated_by_user_idstring uuid

The admin who turned it on. Absent when that user has since been hard-deleted - the activation record outlives them deliberately.

expires_atstring date-time

When the latest activation stops denying on its own. In the past for an activation that already ran out.

deactivated_atstring date-time

When the latest activation was turned off before its expiry, either by an admin or by being superseded. Absent when it ended at expires_at, or has not ended.

reasonstring

The admin's stated reason. Not an internal note - it is shown to the developer whose tool call is denied, in their own terminal.

Changes