Skip to main content
POST
Search Judgments
Use this API to run a semantic vector search over past judgments: the enriched records of your team’s review decisions. Optional filters and retrieval-mode overrides let you narrow by decision, reviewer, content type, recency, or a single comment thread. This is distinct from Search Knowledge Base, which searches the content of your ingested files.

Endpoint

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

Headers

x-velt-api-key
string
required
Your API key.
x-velt-auth-token
string
required

Body

Params

data
object
required

Example Requests

Search rejected decisions

Read one comment thread chronologically

Last week’s activity (recency-true mode)

Response

Each result includes the reasoning, decision, confidence, who decided (actionUser), and a similarity score (1.0 for the annotation and recency shortcut paths). totalInScope reports how many judgments were in scope; searchLatencyMs reports the search time. An agent block is present when the decision came from an AI agent.

Success Response

Failure Response