Skip to main content
POST
Ask Memory
Use this API to ask a natural-language question over your Memory. The answer is grounded in your judgments and ingested knowledge, and comes with citations and a confidence score. When retrieval finds no relevant context, answer is an empty string with confidence: 0 rather than an invented answer; treat that as “Memory has nothing to say about this yet.”

Endpoint

POST https://api.velt.dev/v2/memory/ask

Headers

string
required
Your API key.
string
required

Body

Params

object
required

Example Requests

Ask a policy question

Response

answer is the grounded answer (an empty string when there is no grounding context). citations are the records the model reports it drew on. They are returned as-is and are not verified against the retrieved set, so treat a recordId as a hint and handle the case where it does not resolve. confidence is 0 when the answer is empty. recordsSearched is the number of judgment records put in front of the model.

Success Response

Failure Response

On a validation error, details.issues lists every failing field, not just the one in message.