Search

The unified search endpoint accepts a structured DSL and supports three search modes that can be combined:

• Full-text search (FTS) — keyword search across document content
• Vector search — semantic similarity search across content or metadata
• Metadata filters — exact/range filters on document fields

---

Endpoint

Method	Path	Description	Scope
POST	/apiv2/pub/search	Execute a search query	search

---

Quick examples

Simple text search

{
  "where": {
    "fts": { "field": "content", "query": "supply chain risk" }
  }
}

Metadata filter

{
  "where": {
    "and": [
      { "eq": { "field": "doc_type", "value": "Invoice" } },
      { "gte": { "field": "entry_date", "value": "2025-01-01" } }
    ]
  }
}

Combined FTS + metadata + highlights

{
  "where": {
    "and": [
      { "fts": { "field": "content", "query": "compliance audit" } },
      { "eq": { "field": "doc_status", "value": "Final" } }
    ]
  },
  "select": ["id", "description", "doc_type", "_score", "_highlights"],
  "options": { "include_highlights": true },
  "limit": 20
}

See the DSL Reference for the full specification.