---
title: "Changes to List user messages"
method: GET
path: "/v1/users/{user_id}/messages"
---

# Changes to List user messages

`GET /v1/users/{user_id}/messages`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 30 revisions.

- **2025-12-08** `b4f3f8094215` — 2 info
- **2025-10-27** `40ca41599f57` — 2 info
- **2025-10-07** `fe051300804a` — 1 info
- **2025-08-27** `de67f68640a0` — 9 info
- **2025-07-10** `592610bb4a05` — 1 info
- **2025-05-29** `46f457b0a700` — 1 breaking, 1 info
- **2025-05-21** `a552e94c4d04` — 3 info

## Changes

- **2025-12-08** `b4f3f8094215` — 2 info
  - added the optional property `items/items/source/workflow_recipient_run_id` to the response with the `200` status
  - added the optional property `items/items/source/workflow_run_id` to the response with the `200` status
- **2025-10-27** `40ca41599f57` — 2 info
  - added the optional property `items/items/channel` to the response with the `200` status
  - response property `items/items/channel_id` deprecated
- **2025-10-07** `fe051300804a` — 1 info
  - added the optional property `items/items/source/type` to the response with the `200` status
- **2025-08-27** `de67f68640a0` — 9 info
  - the response property `items/items/__typename` became required for the status `200`
  - the response property `items/items/channel_id` became required for the status `200`
  - the response property `items/items/engagement_statuses` became required for the status `200`
  - the response property `items/items/id` became required for the status `200`
  - the response property `items/items/inserted_at` became required for the status `200`
  - the response property `items/items/recipient` became required for the status `200`
  - the response property `items/items/source` became required for the status `200`
  - the response property `items/items/status` became required for the status `200`
  - the response property `items/items/updated_at` became required for the status `200`
- **2025-07-10** `592610bb4a05` — 1 info
  - added the optional property `items/items/source/step_ref` to the response with the `200` status
- **2025-05-29** `46f457b0a700` — 1 breaking, 1 info
  - removed the required property `entries` from the response with the `200` status
  - added the required property `items` to the response with the `200` status
- **2025-05-21** `a552e94c4d04` — 3 info
  - added the enum value `unarchived` to the property `items/` of the `query` request parameter `engagement_status[]`
  - added the enum value `unread` to the property `items/` of the `query` request parameter `engagement_status[]`
  - added the enum value `unseen` to the property `items/` of the `query` request parameter `engagement_status[]`

---

[Operation](https://skmtc.dev/knocklabs/apis/knock-api/docs/v1/users/:user_id/messages/get.md) · [API](https://skmtc.dev/knocklabs/apis/knock-api.md) · [Page](https://skmtc.dev/knocklabs/apis/knock-api/changes/v1/users/:user_id/messages/get)