API reference

Search

One endpoint covers three modes: find (ranked artifacts), answer (cited generation), and walk (graph traversal summary).

POST /v1/search

Submit a query.

Field	Type	Note
query	string	Natural-language question or keyword phrase.
mode	string	answer (default), find, walk.
scope.project_id	string	Restrict to a project.
scope.entity_types	string[]	For walk mode only.
limit	number	Max candidates retrieved. Default 12, max 50.
redact_acknowledged	boolean	Include the redactions array even when empty.

curl

curl -X POST https://api.mnemos.ai/v1/search \
  -H "Authorization: Bearer $MNEMOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "how do we close month-end revenue?",
    "mode": "answer",
    "scope": { "project_id": "prj_01HZX..." }
  }'

response

{
  "id": "qry_01HZX...",
  "answer": "Month-end close is owned by the RevOps team and runs in five steps...",
  "citations": [
    { "uri": "mnemos://sop/sop_01H...", "score": 0.91 },
    { "uri": "mnemos://artifact/art_01H...?range=2340-2502", "score": 0.78 }
  ],
  "redactions": [
    { "reason": "project_not_member", "count": 3 }
  ],
  "audit_id": "evt_01HZX..."
}

GET /v1/search/{id}

Fetch a previously executed query with its full lineage. Useful for audit replays.