---
title: "Update Site Summary Inclusions"
method: PATCH
path: "/site-summaries/{summary_id}/inclusions"
tags: ["site summaries"]
---

# Update Site Summary Inclusions

`PATCH /site-summaries/{summary_id}/inclusions`

## 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/site-summaries/{summary_id}/inclusions`
- Auth: HTTP bearer

Tick one event into (or out of) this summary's customer e-mail.

`require_summary_write` (owner, monitoring manager, parent manager) for the
same reason the settings write carries it: this decides what a customer
reads, and a permission would also be held by any ordinary operator an owner
had granted it. A customer-side login is refused BY ROLE — they read their own
report, they do not edit it.

An event that is in neither of the sheet's lists is a 404 raised inside the
scoped resolution, so there is no id a caller can probe to learn that an
event exists in another tenant.

## Path parameters

- `summary_id` string, uuid, required

## Request body

- UpdateSiteSummaryInclusionsRequest
  - `event_id` string, required: Event id to include or exclude. Must appear in this summary's escalations or reviewed_non_escalated list, else 404.
  - `included` boolean, required: True ticks the event INTO the customer e-mail; false writes an explicit exclusion rather than deleting the key, so 'never considered' and 'deliberately removed' stay distinguishable.

## Response `200`

Successful Response

- UpdateSiteSummaryInclusionsResponse
  - `id` string, required: Summary UUID.
  - `site_id` string, required: Site UUID this summary belongs to.
  - `inclusions` string[], required: Event ids currently ticked INTO the customer e-mail, in insertion order. Escalations are always sent and are not listed here unless explicitly ticked.

## 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)