Skip to main content
POST
Grounded clinical answer with citations

Authorizations

Authorization
string
header
required

Locus API key — paste the raw lsk_… value (no 'Bearer ' prefix).

Body

application/json
query
string
required

Free-text clinical question in French.

Minimum string length: 1
Example:

"Quelle antibioprophylaxie pour une chirurgie colorectale ?"

source_ids
integer[] | null

Optional allow-list of source ids to restrict retrieval. Omit (the default) to search all sources.

Example:

Response

Successful Response

query
string
required

Echo of the submitted question.

answer
string
required

Concise answer grounded ONLY in the retrieved sources. If the knowledge base does not cover the question, a fixed 'not found' sentence.

sources
AnswerSource · object[]
required

Citations actually used — deduplicated by recommendation.

reformulated_question
string | null

The question restated clearly by the model.

steps
Step · object[]

The agentic pipeline as input→output steps (search → rerank → answer). Display-only; for UIs that 'show the reasoning'. Safe to ignore.

evidence
EvidenceSource · object[]

The sources that grounded the answer, as structured stacks (metadata + their excerpt units), grouped by recommendation. Richer than sources (the deduped citation line). Display-only.

tokens_in
integer | null

Prompt tokens billed.

tokens_out
integer | null

Completion tokens billed.