Skip to main content
POST
Unified search

Authorizations

X-API-Key
string
header
required

Memic API key. Every key is bound to exactly one environment — get one from the Memic dashboard under API Keys.

Body

application/json

Request model for semantic search.

query
string
required

The search query text

Required string length: 1 - 1000
Example:

"What are the key findings in the cybersecurity report?"

project_id
string<uuid> | null

Optional project ID to limit search scope

file_ids
string<uuid>[] | null

Optional list of file IDs to limit search scope

environment_slug
string | null

Optional environment slug to filter search ('staging' or 'production')

top_k
integer
default:10

Number of results to return (max 50)

Required range: 1 <= x <= 50
min_score
number
default:0.7

Minimum similarity score threshold (0.0 to 1.0)

Required range: 0 <= x <= 1
include_metadata
boolean
default:true

Whether to include file and chunk metadata in results

connector_id
string<uuid> | null

Optional: Force query to use a specific connector

force_route
enum<string> | null

Optional: Force query routing (structured, semantic, or hybrid)

Available options:
structured,
semantic,
hybrid
metadata_filters
MetadataFilters · object | null

Metadata filters for vector search (reference_id, page_number, etc.). Used in lookup-based search where SQL returns filter values.

Response

Successful Response

Response model for semantic search.

query
string
required

Original search query

total_results
integer
required

Total number of results returned

search_time_ms
number
required

Search execution time in milliseconds

namespace
string
required

Organization namespace used for search

filters_applied
Filters Applied · object
required

Filters applied to the search

results
SearchResults · object

All search results by type

routing
RoutingInfo · object | null

Query routing information