---
title: "Mark guide as seen"
method: PUT
path: "/v1/users/{user_id}/guides/messages/seen"
tags: ["Guides", "Users"]
---

# Mark guide as seen

`PUT /v1/users/{user_id}/guides/messages/seen`

Records that a guide has been seen by a user, triggering any associated seen events.

## Path parameters

- `user_id` string, required

## Request body

- GuideActionRequest — A request to trigger a guide action.
  - `channel_id` string, uuid, required — The unique identifier for the channel.
  - `content` object — The content of the guide.
  - `data` object — The data of the guide.
  - `guide_id` string, uuid, required — The unique identifier for the guide.
  - `guide_key` string, required — The key of the guide.
  - `guide_step_ref` string, required — The step reference of the guide.
  - `is_final` boolean — Whether the guide is final.
  - `metadata` object — The metadata of the guide.
  - `tenant` string, nullable — The tenant ID of the guide.

## Response `200`

OK

- GuideActionResponse — A response for a guide action.
  - `status` string, required — The status of a guide's action.

## Changes

- **2025-09-22** `136d5581336a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/knocklabs/apis/knock-api/changes/v1/users/:user_id/guides/messages/seen/put.md)

---

[API](https://skmtc.dev/knocklabs/apis/knock-api.md) · [All operations](https://skmtc.dev/knocklabs/apis/knock-api/llms.txt) · [OpenAPI document](https://skmtc.dev/knocklabs/apis/knock-api/revisions/7e6c3d2d08fa?raw)