---
title: "Search Chats"
method: GET
path: "/chat/search"
tags: ["public"]
---

# Search Chats

`GET /chat/search`

Search for chat sessions based on the provided query.
If no query is provided, returns recent chat sessions.

## Query parameters

- `query` string, nullable
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- ChatSearchResponse
  - `groups` ChatSessionGroup[], required
    - `title` string, required
    - `chats` ChatSessionSummary[], required
      - `id` string, uuid, required
      - `name` string, nullable
      - `persona_id` integer, nullable
      - `time_created` string, date-time, required
      - `shared_status` 'public' | 'private', required
      - `current_alternate_model` string, nullable
      - `current_temperature_override` number, nullable
  - `has_more` boolean, required
  - `next_page` integer, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-01-06** `2d941ea53eb3` — 1 warning, 3 info
  - removed the optional property `groups/items/chats/items/folder_id` from the response with the `200` status
  - api tag `public` added
  - the response property `groups` became required for the status `200`
  - the response property `has_more` became required for the status `200`
- **2025-08-21** `9321c45d93b5` — 2 breaking, 2 info
  - the response property `groups` became optional for the status `200`
  - the response property `has_more` became optional for the status `200`
  - api tag `public` removed
  - added the optional property `groups/items/chats/items/folder_id` to the response with the `200` status

[Change history](https://skmtc.dev/onyx-dot-app/apis/onyx-api/changes/chat/search/get.md)

---

[API](https://skmtc.dev/onyx-dot-app/apis/onyx-api.md) · [All operations](https://skmtc.dev/onyx-dot-app/apis/onyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/onyx-dot-app/onyx-api/revisions/2980a9073ffe/schema)