Memories

Understand the memory objects returned by the Replay public API.

A memory is a recorded moment in Replay. Public API memory objects include timing metadata, processing status, and generated fields when processing is complete.

Memory object

Field	Type	Description
id	string	Unique memory ID. Use this with GET /v1/memories/{memory_id}.
name	string	User-visible memory name.
started_at	string	ISO timestamp for when the memory started.
ended_at	string	ISO timestamp for when the memory ended.
is_processing	boolean	Whether Replay is still processing transcript and summary data.
user_id	string	ID of the Replay user that owns the memory.
duration_seconds	integer	Length of the memory in seconds.
summary	object or null	Generated summary, available after processing.
transcript	string or null	Transcript text, available after processing.

Summary object

When present, summary contains:

Field	Type	Description
quick_summary	string	Short summary of the memory.
key_takeaways	string[]	Important points from the memory.

Processing state

If is_processing is true, generated fields can be null.

{
  "id": "mem_123",
  "is_processing": true,
  "summary": null,
  "transcript": null
}

Poll the memory detail endpoint later to read generated fields after processing completes.

Ordering

GET /v1/memories returns memories ordered by started_at with the newest memories first.