---
title: "Set Site Agent Mode"
method: PUT
path: "/sites/{site_id}/agent-mode"
tags: ["sites"]
---

# Set Site Agent Mode

`PUT /sites/{site_id}/agent-mode`

## Request

- Base URL: `https://api.verdun.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.verdun.ai/sites/{site_id}/agent-mode`
- Auth: HTTP bearer

## Path parameters

- `site_id` string, required

## Request body

- SetSiteAgentModeRequest: Bulk arm/shadow every camera at a site in one call (site-admin-only), instead of toggling agent_mode camera by camera. Arming only touches cameras whose incident intelligence is on; ii-off cameras cannot be armed and are left in shadow and reported back, rather than failing the whole operation.
  - `enabled` boolean, required: True arms every ii-enabled camera at the site (agent mode); False sets all cameras to shadow.

## Response `200`

Successful Response

- SetSiteAgentModeResponse
  - `site_id` string, uuid, required: The site that was flipped.
  - `enabled` boolean, required: The requested target mode (True = armed).
  - `total` integer, required: Cameras at the site.
  - `updated` integer, required: Cameras whose agent_mode actually changed.
  - `skipped_ii_off` integer, required: Cameras that could not be armed because incident intelligence is off (arming only).
  - `cameras` SiteAgentModeCameraResult[], required: Per-camera outcome, so the client can reflect the new armed state on every row.
    - `id` string, uuid, required: Camera row id.
    - `camera_label` string, nullable: Human label.
    - `agent_mode` boolean, required: The camera's agent_mode after this call.
    - `ii_enabled` boolean, required: Whether incident intelligence is on for this camera.
    - `skipped_ii_off` boolean: True when arming was requested but the camera has ii disabled, so it stayed in shadow.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verdun/apis/verdun-api.md) - [All operations](https://skmtc.dev/verdun/apis/verdun-api/llms.txt) - [OpenAPI document](https://skmtc.dev/verdun/apis/verdun-api/revisions/35a2a6ebedda?raw)