Skip to main content
POST
Execute a SemQL semantic search query

Authorizations

Authorization
string
header
required

API key bearer token. Obtain from the Noetive dashboard. Pass as: Authorization: Bearer <api-key>.

Body

application/json
query
string
required

Raw SemQL text submitted by the client. Subject to the SemQL query limits — see the "SemQL query limits" section in the API description.

namespace
string
required

Target namespace alias — a registered name (e.g. articles) or the well-known global alias. Required; there is no default. Every request is validated against the namespace's configured model and dimensions; a mismatch returns 400 invalid_request.

Pass the alias, not the ns_... identifier shown in the dashboard — a raw identifier is rejected with 400 invalid_request.

Maximum string length: 64
Pattern: ^[A-Za-z0-9_-]+$
model
string
required

Embedding model name. Required; there is no default. Must match the model configured on the namespace, or the request fails with 400 model_not_provisioned.

dimensions
integer
required

Embedding vector dimensionality. Required; there is no default. Must match the dimensionality configured on the namespace for model, or the request fails with 400 model_not_provisioned.

Required range: 1 <= x <= 4096
limit
integer

Maximum number of results to return. Takes precedence over the SemQL LIMIT n clause; when both are omitted, 100 results are returned.

Values above 1000 are clamped to 1000, not rejected — the request succeeds and returns at most 1000 results. A client that treats a successful response as "everything matched" will silently miss results. Narrow the WINDOW or tighten the query instead of raising the limit.

Required range: x >= 1

Response

Ranked search results

results
object[]

Ranked list of matched documents.