Episodes

Create episode event

Create a new event in an episode timeline

post/api/v1/episodes/events

Request

  • The document declares no server URL.
  • Auth: HTTP bearer

Headers

X-API-Keystring nullable

Request body

episode_idstring required

Parent episode ID

memory_idstring nullable

Associated memory ID (if event originated from memory write)

event_typestring required

Type: user_report, agent_action, tool_result, resolution, followup, note

event_tsstring date-time nullable

When the event occurred (defaults to now)

actor_typestring

Who/what created this event: user, agent, system

actor_idstring nullable

User/agent ID if applicable

contentstring nullable

Human-readable event description/message

payloadobject nullable

Structured event data (tool results, metadata, etc.)

Response

Successful Response

idstring required
organization_idstring required
episode_idstring required
memory_idstring nullable required
event_typestring required
event_tsstring date-time required
actor_typestring required
actor_idstring nullable required
contentstring nullable required
payloadobject nullable required
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 2 revisions of this API.