Pause Agent
POST /api/v1/dogfood/agents/{role}/pause
Pause a C-suite agent on the caller’s tenant.
CEO/Chairman-only. Emits DOGFOOD_AGENT_PAUSED and writes an
audit row. Idempotent on already-paused roles.
Args:
role: One of the 8 C-suite roles.
body: :class:PauseRequest with actor_user_id and optional
reason.
user: Authenticated :class:UserContext (chairman-gated).
service: Injected :class:DogfoodAgentControlService.
Returns:
:class:PauseResponse with paused state + correlation event id.
Raises: HTTPException: 403 if user is not chairman; 400 if role is unknown or the tenant is not in dogfood_live_mode.
Authorizations
Parameters
Path Parameters
Request Body required
Body for POST /api/v1/dogfood/agents/{role}/pause.
Attributes:
actor_user_id: User id of the CEO/Chairman issuing the pause.
Required for audit trail and the
DOGFOOD_AGENT_PAUSED event payload.
reason: Optional human-readable explanation captured in the
audit entry. Not displayed publicly.
Responses
200
Successful Response
Response returned by the pause endpoint.
Attributes:
role: Agent role that was paused (one of the 8 C-suite roles).
paused: Always True on success.
paused_at: UTC timestamp when the pause was recorded.
event_id: Correlation id shared with the
DOGFOOD_AGENT_PAUSED bus event.
object
422
Validation Error