API reference

Sessions

A session is a single interview, ingestion, or recording-upload run. It produces a transcript and a set of candidate extractions.

The session object

session

{
  "id":                 "ses_01HZX...",
  "workspace_id":       "ws_01HZX...",
  "project_id":         "prj_01HZX...",
  "template":           "operational_workflow",
  "title":              "Month-end revenue close",
  "interviewee_email":  "aria@acme.com",
  "status":             "completed",
  "duration_seconds":   1380,
  "started_at":         "2026-05-18T14:00:00Z",
  "completed_at":       "2026-05-18T14:23:00Z",
  "transcript_uri":     "mnemos://artifact/art_01H...",
  "extraction": {
    "sop_candidates":    14,
    "entity_candidates":  9,
    "risk_signals":       2
  }
}

POST /v1/sessions

Start a new session.

Field	Type	Note
template	string	operational_workflow, system_ownership, customer_playbook, decision_retrospective, onboarding_handoff, open_exploration.
title	string	Human-readable session label.
project_id	string	Required when the workspace has more than one project.
interviewee_email	string	Email of the person being interviewed.
scheduled_for	string	ISO 8601. Optional. If omitted, the session is started immediately.
upload_url	string	If provided, ingests a pre-existing recording or transcript instead of starting a live call.

curl

curl -X POST https://api.mnemos.ai/v1/sessions \
  -H "Authorization: Bearer $MNEMOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "operational_workflow",
    "title": "Month-end revenue close",
    "interviewee_email": "aria@acme.com",
    "project_id": "prj_01HZX..."
  }'

GET /v1/sessions/{id}

Retrieve a session and its current state.

curl

curl https://api.mnemos.ai/v1/sessions/ses_01HZX... \
  -H "Authorization: Bearer $MNEMOS_API_KEY"

GET /v1/sessions/{id}/transcript

Stream the transcript. Returns a server-sent events stream while the session is live, or the complete document once completed.

POST /v1/sessions/{id}/cancel

Cancel an in-progress session. Partial transcripts are retained but extraction is not run.