---
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

---

[API](https://skmtc.net/onyx-dot-app/apis/agents-api.md) · [All operations](https://skmtc.net/onyx-dot-app/apis/agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onyx-dot-app/agents-api/versions/ea131344b29e/schema)