API ReferenceEpisodes
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)
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
mindspace_ids?array<string>
limit?integer
Default
20offset?integer
Default
0Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/episodes?limit=20&offset=0"{ "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" } ], "has_more": true, "limit": 0, "offset": 0, "total": 0}{ "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" } ] }}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. GET
Previous Page
Ingest a message into an agent's episodic memory. Owner = end-user token subject, or a service user's supplied agent_id. POST
Next Page