MEmem0
memories

POST /v2/memories/

Changed on

Get all memories.

Request

  • Base URL
    https://api.mem0.ai
  • URL
    https://api.mem0.ai/v2/memories/
  • Auth
    API key in header Authorization

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.

Response

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.

Changes

  • d8043b07769dRevision changes
    • breaking

      the response property / became nullable for the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      endpoint deprecated

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status