# Patrol

URL: https://docs.hanzo.ai/docs/cli/patrol

> The `hanzo patrol` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/patrol) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/patrol) · [SDKs](https://docs.hanzo.ai/docs/sdks)

Stands watch over an estate: sites, units, tours, keys, cameras, and the incidents that interrupt them.

[API reference →](https://docs.hanzo.ai/docs/openapi/patrol)

```bash
hanzo patrol key list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command                 | What it does                                                                                                                                                            |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo patrol alarm`    | Takes one activation.                                                                                                                                                   |
| `hanzo patrol feed`     | Watch the live feed                                                                                                                                                     |
| `hanzo patrol snapshot` | Returns the whole picture in one read: sites, units with their position trails, today's tours and checkpoints, the key register, the recent feed and the open incident. |
| `hanzo patrol tour`     | Lists patrol rounds with their checkpoints — the proof-of-presence record.                                                                                              |

### Camera

| Command                                          | What it does                                       |
| ------------------------------------------------ | -------------------------------------------------- |
| `hanzo patrol camera list`                       | Lists the cameras a caller may OPEN.               |
| `hanzo patrol camera stream get <name> <ticket>` | Redeems a minted ticket for what opens the camera. |
| `hanzo patrol camera stream list <name>`         | Mints a short-lived way in to one camera.          |

### Event

| Command                     | What it does                                                        |
| --------------------------- | ------------------------------------------------------------------- |
| `hanzo patrol event create` | Writes one feed row by hand and pushes it to every screen watching. |
| `hanzo patrol event get`    | Lists the feed, newest first.                                       |

### Incident

| Command                             | What it does                                                                                                                                                                                                         |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo patrol incident create`      | Records a response by hand, in state received and carrying the site's tier and SLA.                                                                                                                                  |
| `hanzo patrol incident get <name>`  | Returns one response whole: the incident, every act performed on it, and the SLA clocks those acts settled.                                                                                                          |
| `hanzo patrol incident list`        | Lists responses.                                                                                                                                                                                                     |
| `hanzo patrol incident step <name>` | Performs one act on an incident: it stamps the act's time, moves the state, appends the act to the trail, and runs what the act sets in motion — a unit assigned, a site secured, a report filed, a controller told. |

### Key

| Command                        | What it does                                                                                 |
| ------------------------------ | -------------------------------------------------------------------------------------------- |
| `hanzo patrol key get <name>`  | Returns one key set from the register.                                                       |
| `hanzo patrol key list`        | Lists the key register.                                                                      |
| `hanzo patrol key move <name>` | Records a key set leaving, returning, or being counted, and moves the register row to match. |

### Note

| Command                    | What it does                                           |
| -------------------------- | ------------------------------------------------------ |
| `hanzo patrol note create` | Records an internal remark, stamped with who wrote it. |
| `hanzo patrol note get`    | Lists internal remarks.                                |

### Point

| Command                             | What it does                                                                                                          |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `hanzo patrol point confirm <name>` | Records presence at a checkpoint: who confirmed it, the method, where they stood, and the photo key if one was taken. |

### Report

| Command                          | What it does                                                                                       |
| -------------------------------- | -------------------------------------------------------------------------------------------------- |
| `hanzo patrol report create`     | Composes and files a report from one estate read, so the same figures read the same a month later. |
| `hanzo patrol report get <name>` | Download a filed report                                                                            |

### Site

| Command                        | What it does                                                                                                              |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| `hanzo patrol site get <name>` | Returns one site whole: the register row plus the panel's zones and the standing hazards, which ride inside the document. |
| `hanzo patrol site list`       | Lists the estate.                                                                                                         |
| `hanzo patrol site set <name>` | Changes a site's contract and brief fields.                                                                               |

### Tenant

| Command                         | What it does                                                                          |
| ------------------------------- | ------------------------------------------------------------------------------------- |
| `hanzo patrol tenant get <org>` | Returns one org's public face — brand, company, operations, features and terminology. |

### Unit

| Command                          | What it does                                                                  |
| -------------------------------- | ----------------------------------------------------------------------------- |
| `hanzo patrol unit fix <name>`   | Records where a unit is.                                                      |
| `hanzo patrol unit list`         | Lists the fleet with each unit's position trail, which is what the map draws. |
| `hanzo patrol unit near`         | Answers which units can reach a site soonest.                                 |
| `hanzo patrol unit state <name>` | Moves a unit between states — on shift, on a break, off, or in trouble.       |
