---
title: "Get session messages"
method: GET
path: "/ocs/v2.php/apps/assistant/chat/messages"
tags: ["chat_api"]
---

# Get session messages

`GET /ocs/v2.php/apps/assistant/chat/messages`

Get chat messages for the session without the system message

## Query parameters

- `sessionId` integer, required
- `limit` integer
- `cursor` integer
- `filterByRole` string

## Headers

- `OCS-APIRequest` boolean, required

## Response `200`

The message list has been successfully obtained

- ChatMessage[]
  - `id` integer, required
  - `session_id` integer, required
  - `role` string, required
  - `content` string, required
  - `timestamp` integer, required
  - `attachments` object[], required
    - `type` string, required
    - `fileId` integer, required
  - `ocp_task_id` integer, required
  - `sources` string, required

## Other responses

- `401` — Not logged in
- `404` — The session was not found
- `500`

## Changes

> 51 revisions in range; 1 could not be searched.

- **2026-06-09** `f3fde4dfbf8c` — 1 info
  - added the new optional `query` request parameter `filterByRole`
- **2026-06-02** `4482cc378685` — 1 warning
  - deleted the `query` request parameter `filterByRole`
- **2026-06-01** `6aeeb18b7888` — 1 info
  - added the new optional `query` request parameter `filterByRole`
- **2026-05-26** `590d6c61e9f1` — 1 warning
  - deleted the `query` request parameter `hideUserMessages`
- **2026-05-21** `1a62b3d5740b` — 1 info
  - added the new optional `query` request parameter `hideUserMessages`

[Full history](https://skmtc.dev/nextcloud/apis/assistant/changes/ocs/v2.php/apps/assistant/chat/messages/get.md)

---

[API](https://skmtc.dev/nextcloud/apis/assistant.md) · [All operations](https://skmtc.dev/nextcloud/apis/assistant/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nextcloud/assistant/revisions/9146d4951875/schema)