---
title: "Record that a central-staff viewer opened this queued alarm"
method: POST
path: "/events/{event_id}/viewed"
tags: ["events"]
---

# Record that a central-staff viewer opened this queued alarm

`POST /events/{event_id}/viewed`

## 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/events/{event_id}/viewed`
- Auth: HTTP bearer

Called when an alarm's review page opens. Stamps the FIRST open only and never overwrites it; every later call answers with the original viewer. Feeds the "By site" queue's "+N NEW" badge and its wait clock, which count from the oldest clip nobody has opened. Owners and monitoring managers count as viewers (unlike claims). Advisory: nothing here gates a disposition. Customer-side callers stamp nothing and receive null. Requires `review_label_alarms` and tenant scope (out of scope is 403, unknown is 404).

## Path parameters

- `event_id` string, required

## Response `200`

Successful Response

- MarkViewedResponse
  - `first_viewed` FirstViewed, required
    - `operator_id` string, required: The first central-staff viewer to open the alarm
    - `operator_name` string, nullable: Their display name; null if the operator no longer exists
    - `viewed_at` string, required: When that first open happened (ISO 8601, UTC)

## 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/00252d8227c1?raw)