---
title: "Patch Callout State"
method: PATCH
path: "/api/v1/viewer-callouts/{callout_id}"
tags: ["viewer-callouts"]
---

# Patch Callout State

`PATCH /api/v1/viewer-callouts/{callout_id}`

Acknowledge or dismiss a callout.

## Path parameters

- `callout_id` string, uuid, required

## Request body

- ViewerCalloutPatch — State transition request — acknowledge or dismiss a callout.
  - `state` 'acknowledged' | 'dismissed', required

## Response `200`

Successful Response

- ViewerCalloutRead — Full viewer callout response.
  - `id` string, uuid, required
  - `cad_file_version_id` string, uuid, required
  - `feature_id` string, nullable, required
  - `callout_type` string, required
  - `severity` string, required
  - `title` string, required
  - `body` string, nullable, required
  - `actions` CalloutAction[], nullable
    - `label` string, required
    - `action_type` string, required
    - `payload` object, nullable
  - `created_by` string, nullable, required
  - `related_message_id` string, uuid, nullable, required
  - `state` string, required
  - `acknowledged_at` string, date-time, nullable, required
  - `dismissed_at` string, date-time, nullable, required
  - `source_finding_id` string, nullable, required
  - `stakes` object, nullable
  - `intent_field` string, nullable, required
  - `answer_text` string, nullable, required
  - `answer_status` string, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/prototyping/apis/prototyping-io-api.md) · [All operations](https://skmtc.dev/prototyping/apis/prototyping-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prototyping/prototyping-io-api/revisions/f4a0079fbb57/schema)