API ReferenceEpisodes
List episodes in a date window, newest first, tenant-scoped with optional agent_id lens. Dates are YYYY-MM-DD, inclusive. Use this rather than /search when the question is about time: search ranks by relevance and cannot filter on it.
Authorization
BearerAuth AuthorizationBearer <token>
MagickMind API key (mm_...) or user JWT, sent as Authorization: Bearer <token>. /v1/chat/completions accepts an API key only. JWTs (not mm_ keys) may alternatively be passed as a ?token= query parameter.
In: header
Query Parameters
agent_id?string
date_start*string
date_end*string
mindspace_id?string
participant_id?string
limit?integer
Range
1 <= value <= 200Default
50Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/episodes/range?date_start=string&date_end=string&limit=50"{ "data": [ { "entities": [ "string" ], "id": "string", "mindspace_id": "string", "participant_ids": [ "string" ], "subtopics": [ "string" ], "summarized_conversation": "string", "topic": "string", "what_to_avoid": "string", "what_worked": "string" } ]}{ "error": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "request_id": "string", "errors": [ { "field": "string", "message": "string" } ] }}{ "error": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "request_id": "string", "errors": [ { "field": "string", "message": "string" } ] }}Get all graph edges (related + chronological) among a mindspace's episodes, tenant-scoped (optional agent_id lens: an agent's id, or __neutral__ for the space's unowned memory) GET
Previous Page
List episodes, tenant-scoped (optional agent_id lens: an agent's id, or __neutral__ for the space's unowned memory; forced to self under an end-user token) GET
Next Page