Search

Run semantic search across your connected knowledge base.

The search endpoint retrieves documents semantically relevant to a query. It is part of the public API and can be called directly without creating a chat session.

This endpoint searches chat session history, not the document index. To search your connected documents and knowledge sources, use the chat API with a search-enabled agent. The admin search endpoint (POST /api/admin/search) provides direct document search for administrative use.

---

Search chat sessions

GET /api/chat/search

Searches through the authenticated user’s chat sessions by query text, grouped by time period.

Query parameters

query · string

The search query. If omitted, returns the most recent sessions.

page · integer · default: "1"

Page number (1-indexed).

page_size · integer · default: "10"

Number of results per page.

Response

groups · array

Sessions grouped by recency.

Show group fields

title · string

Label for this time group: Today, Yesterday, This Week, This Month, or Older.

chats · array

Sessions in this group.

Show chat summary fields

id · string (UUID)

Session identifier.

name · string

Session name or description.

persona_id · integer

Agent used in the session.

time_created · string (ISO 8601)

When the session was created.

shared_status · string

Sharing state: private or public.

current_alternate_model · string

Override model in use, if any.

current_temperature_override · number

Temperature override, if set.

has_more · boolean

Whether more results are available on the next page.

next_page · integer

The next page number if has_more is true, otherwise null.

curl

curl "https://cloud.hadiq.io/api/chat/search?query=vacation+policy&page=1&page_size=10" \
  -H "Authorization: Bearer hadiqk-..."

---

Admin document search

POST /api/admin/search

Searches the document index directly. Requires admin or curator role.

Request body

query · string · required

The search query string.

filters · object · required

Search filters.

Show filter fields

source_type · array

Restrict to specific connector source types (e.g. ["confluence", "slack"]).

document_set · array

Restrict to specific document set names.

time_cutoff · string (ISO 8601)

Only return documents updated after this timestamp.

tags · array

Filter by document tags.

Response

documents · array

Matching documents ordered by relevance.

Show document fields

document_id · string

Unique document identifier.

semantic_identifier · string

Human-readable title shown in the UI.

link · string

URL to the source document, if available.

source_type · string

Connector source type (e.g. confluence, slack).

score · number

Relevance score for ranking.

blurb · string

Short excerpt of matching content.

curl

curl -X POST https://cloud.hadiq.io/api/admin/search \
  -H "Authorization: Bearer haidqk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "onboarding checklist",
    "filters": {
      "source_type": ["confluence", "google_drive"]
    }
  }'

---

Error codes

Status	Cause
401	Missing or invalid API key.
403	Insufficient role for admin search endpoint.