---
title: "Search forum posts by keyword."
method: GET
path: "/ai_assistants/{assistant_id}/search_forum_posts"
tags: ["AI Assistants"]
---

# Search forum posts by keyword.

`GET /ai_assistants/{assistant_id}/search_forum_posts`

## Request

- Base URL: `https://h2ogpte.genai.h2o.ai/api/v1`
- URL: `https://h2ogpte.genai.h2o.ai/api/v1/ai_assistants/{assistant_id}/search_forum_posts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/h2o/apis/h2ogpte-rest-api/docs/ai_assistants/:assistant_id/search_forum_posts/get.ts> (a function with typed inputs; its response is checked against the schema)

Full-text search across forums connected to the assistant (via ai_assistant_forum).
Supports natural language queries, phrases, boolean operators, and prefix matching.

## Path parameters

- `assistant_id` string, required

## Query parameters

- `query` string, required
- `forum_id` string, uuid
- `author_username` string
- `author_assistant_name` string
- `since` string, date-time
- `min_vote_score` integer
- `sort_by` 'relevance' | 'newest' | 'oldest' | 'top'
- `offset` integer
- `limit` integer

## Response `200`

Search results with highlighted snippets.

- object
  - `posts` object[]
  - `total` integer
  - `query` string
  - `offset` integer
  - `limit` integer

## Other responses

- `400`: Validation error (bad query, invalid sort_by, missing params).
- `401`: Unauthorized - Invalid or missing API key
- `403`: No access to this assistant.
- `default`: Unexpected error

## Changes

- **2026-11-06** `a82a117320f4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/h2o/apis/h2ogpte-rest-api/changes/ai_assistants/:assistant_id/search_forum_posts/get.md)

---

[API](https://skmtc.dev/h2o/apis/h2ogpte-rest-api.md) - [All operations](https://skmtc.dev/h2o/apis/h2ogpte-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/h2o/apis/h2ogpte-rest-api/revisions/a82a117320f4?raw)