---
title: "Handle Search Request"
method: POST
path: "/query/document-search"
---

# Handle Search Request

`POST /query/document-search`

Simple search endpoint, does not create a new message or records in the DB

## Query parameters

- `disable_llm_chunk_filter` boolean

## Request body

- DocumentSearchRequest
  - `message` string, required
  - `search_type` 'keyword' | 'semantic' | 'hybrid', required — An enumeration.
  - `retrieval_options` RetrievalDetails, required
    - `run_search` 'always' | 'never' | 'auto' — An enumeration.
    - `real_time` boolean
    - `filters` BaseFilters
      - `source_type` DocumentSource[]
      - `document_set` string[]
      - `time_cutoff` string, date-time
      - `tags` Tag[]
        - `tag_key` string, required
        - `tag_value` string, required
    - `enable_auto_detect_filters` boolean
    - `offset` integer
    - `limit` integer
  - `recency_bias_multiplier` number
  - `skip_rerank` boolean

## Response `200`

Successful Response

- SearchResponse
  - `top_documents` SavedSearchDoc[], required
    - `document_id` string, required
    - `chunk_ind` integer, required
    - `semantic_identifier` string, required
    - `link` string
    - `blurb` string, required
    - `source_type` 'ingestion_api' | 'slack' | 'web' | 'google_drive' | 'gmail' | 'requesttracker' | 'github' | 'gitlab' | 'guru' | 'bookstack' | 'confluence' | 'discourse' | 'slab' | 'salesforce' | 'jira' | 'productboard' | 'file' | 'notion' | 'zulip' | 'linear' | 'hubspot' | 'document360' | 'gong' | 'google_sites' | 'zendesk' | 'loopio' | 'sharepoint' | 'teams' | 'freshdesk', required — An enumeration.
    - `boost` integer, required
    - `hidden` boolean, required
    - `metadata` object, required
    - `score` number
    - `match_highlights` string[], required
    - `updated_at` string, date-time
    - `primary_owners` string[]
    - `secondary_owners` string[]
    - `db_doc_id` integer, required
  - `llm_indices` integer[], required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/engineertheory/apis/recap-backend.md) · [All operations](https://skmtc.net/engineertheory/apis/recap-backend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/engineertheory/recap-backend/revisions/ea9db8f9a24d/schema)