POST /v2/memories — mem0-api-docs

Get all memories.

Request body

fieldsstring[]

A list of field names to include in the response. If not provided, all fields will be returned.

pageinteger

Page number for pagination. Default: 1

page_sizeinteger

Number of items per page. Default: 100

org_idstring nullable

The unique identifier of the organization associated with the memory.

project_idstring nullable

The unique identifier of the project associated with the memory.

Successfully retrieved memories.

idstring uuid required

Unique memory identifier.

memorystring required

The extracted memory fact.

user_idstring nullable

User the memory is scoped to.

agent_idstring nullable

Agent the memory is scoped to.

app_idstring nullable

App the memory is scoped to.

session_idstring nullable

Run/session the memory is scoped to. Note: this endpoint returns this field as session_id, matching POST /v3/memories/.

metadataobject nullable

Additional metadata associated with the memory

categoriesstring[] nullable

created_atstring date-time required

Timestamp of when the memory was created.

updated_atstring date-time required

Timestamp of when the memory was last updated.

expiration_datestring date nullable

The date when the memory will expire. Format: YYYY-MM-DD.

structured_attributesobject nullable

System-derived temporal breakdown of the memory's creation time (e.g. year, month, day_of_week).

replaced_bystring nullable

ID of the memory that superseded this one, if any.

synthesizedboolean

Whether this memory was synthesized rather than directly extracted.