Mnemos AI
API reference

Chat

A stateful conversational surface for the Mnemos platform. Each thread retains turn history, citations, and a tool-call trace.

POST /v1/chat/threads

Create a new conversation thread.

curl
curl -X POST https://api.mnemos.ai/v1/chat/threads \
  -H "Authorization: Bearer $MNEMOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Onboarding research for Aria",
    "scope": { "project_id": "prj_01HZX..." }
  }'

POST /v1/chat/threads/{id}/messages

Add a user message and receive the assistant's response. Streaming SSE supported via Accept: text/event-stream.

curl
curl -X POST https://api.mnemos.ai/v1/chat/threads/thr_01HZX.../messages \
  -H "Authorization: Bearer $MNEMOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Who owns month-end close, and what would break if they left?"
  }'
response
{
  "id": "msg_01HZX...",
  "role": "assistant",
  "content": "RevOps lead Priya Anand owns month-end close...",
  "citations": [ { "uri": "mnemos://sop/sop_01H..." } ],
  "tool_calls": [
    { "name": "graph.traverse", "input": { "start": "ent_priya", "depth": 2 } }
  ],
  "redactions": []
}

GET /v1/chat/threads/{id}

Retrieve a thread and all its messages.

DELETE /v1/chat/threads/{id}

Delete a thread. Tool-call audit entries are retained per the workspace audit policy.

One question, no thread

For one-shot questions, use POST /v1/search in answer mode. Reserve /chat for genuinely multi-turn flows where conversational state matters.