---
title: "Changes to List messages"
method: GET
path: "/v1/objects/{collection}/{id}/messages"
---

# Changes to List messages

`GET /v1/objects/{collection}/{id}/messages`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 64 revisions.

- **2026-10-20** `3f095ce88c5d`: 1 info
- **2026-07-28** `1e590485c902`: 1 breaking, 3 info
- **2026-07-14** `de4604427056`: 4 warning, 5 info
- **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

- **2026-10-20** `3f095ce88c5d`: 1 info
  - added the optional property `items/items/source/branch_path` to the response with the `200` status
- **2026-07-28** `1e590485c902`: 1 breaking, 3 info
  - the response property `items/items/recipient_snapshot/email` became nullable for the status `200`
  - added the optional property `items/items/recipient_snapshot/channel_id` to the response with the `200` status
  - added the optional property `items/items/recipient_snapshot/user_id` to the response with the `200` status
  - added the optional property `items/items/recipient_snapshot/via_incoming_webhook` to the response with the `200` status
- **2026-07-14** `de4604427056`: 4 warning, 5 info
  - deleted the `query` request parameter `engagement_status[]`
  - deleted the `query` request parameter `message_ids[]`
  - deleted the `query` request parameter `status[]`
  - deleted the `query` request parameter `workflow_categories[]`
  - added the new optional `query` request parameter `engagement_status`
  - added the new optional `query` request parameter `message_ids`
  - added the new optional `query` request parameter `status`
  - added the new optional `query` request parameter `workflow_categories`
  - added the optional property `items/items/recipient_snapshot` to the response with the `200` status
- **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/objects/:collection/:id/messages/get.md) · [API](https://skmtc.dev/knocklabs/apis/knock-api.md) · [Page](https://skmtc.dev/knocklabs/apis/knock-api/changes/v1/objects/:collection/:id/messages/get)