Sessions - Mirobody

Endpoint

DELETE /v1/sessions/{session_id}
Authorization: Bearer mb_live_*

Ends a session and cleans up what it scoped: records written with retention=session under this session_id are hard-deleted (rows physically removed), and any chat history threaded on it is removed from the API surface. deleted counts what was purged.

curl -X DELETE "https://mirobody-api.thetahealth.ai/v1/sessions/sess_abc123?user=alice" \
  -H "Authorization: Bearer $MIROBODY_API_KEY"

Pass the same user you used when writing the session’s data; omitting it targets your account’s default Subject.

Response:

{ "status": "ok", "session_id": "sess_abc123", "deleted": 2, "subject": "alice" }

Field	Description
`status`	`"ok"` on success.
`session_id`	The session that was ended.
`deleted`	Count of purged items (session-scoped data records + conversation rows). `0` simply means nothing was scoped to this session.
`subject`	The Subject the session belonged to.

How sessions work

A session_id is a cleanup scope with a name — one id that ties together the working data and conversation of one interaction:

Scopes retention=session data — records written via POST /v1/data (or POST /v1/extract with store=true) with retention: "session" must carry a session_id, and live only until the session is deleted (capped at 24h regardless).
Binds durable conversations on the Agent API — passing session_id to POST /v1/responses makes the conversation durable and resumable under that id. See State & memory.

import requests

BASE = "https://mirobody-api.thetahealth.ai/v1"
H = {"Authorization": "Bearer mb_live_..."}

# Write working data scoped to the session
requests.post(f"{BASE}/data", headers=H, json={
    "user": "alice",
    "retention": "session",
    "session_id": "sess_abc123",
    "records": [{"indicator": "systolic_bp", "value": 148, "unit": "mmHg",
                 "time": "2026-06-16T08:00:00Z"}],
})

# ... run agent turns with session_id="sess_abc123" ...

# When the interaction ends, purge everything it scoped:
requests.delete(f"{BASE}/sessions/sess_abc123", headers=H, params={"user": "alice"})

See retention for the full lifetime model.

​Endpoint

​How sessions work

Endpoint

How sessions work