Skip to main content

Materialize

Trigger materialization backfill for filter indexes. Rebuilds the materialized field value index used by filter queries after bulk ingestion.

Trigger a rebuild of the materialized field value index. The materialized index pre-computes extracted field values for every document, enabling sub-second filter queries even on large workspaces. Run this endpoint after bulk document ingestion or schema changes to ensure filter results are current.

Materialization can be resource-intensive on large workspaces. Avoid calling this endpoint during peak usage. For incremental ingestion, the index updates automatically per document.
POST/filter/materialize

Response

Response fields

processedintegerNumber of document field values materialized during the backfill.

Response

{
  "processed": 1842
}

Errors

Error responses

401unauthorizedMissing or invalid API key.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

In a typical bulk-ingestion workflow, call POST /v1/extract for each file, wait for all document.extraction.completed webhooks, then trigger POST /filter/materialize once. After the backfill completes, all filter and omnisearch endpoints will reflect the newly ingested data.

Related

Filter Documents