Memory

Get All Memories

get

Retrieve all memories for a user based on the provided identifier. Returns a paginated list of memory chunks with their content, metadata, and scores.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Responses

200

Memories retrieved successfully

application/json

422

Validation Error

application/json

500

Internal server error

application/json

503

Memory features are not available

application/json

get

/memories

HTTPcURLJavaScriptPython

GET /memories HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "memories": [
    {
      "id": "003634aa-c99c-4617-8f8d-e76aca07511b",
      "content": "User Prefers pizza and Italian food",
      "metadata": {
        "user_id": "user_123",
        "created_at": "2025-09-10T09:05:16.915036-07:00"
      },
      "score": 0.5
    }
  ]
}

Delete Memories

delete

Delete multiple memories by their IDs. Only memories belonging to the authenticated user can be deleted.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Body

application/json

Request model for deleting memories.

Attributes: memory_ids (list[str]): List of memory IDs to delete.

memory_idsstring[] · min: 1Required

List of memory IDs to delete

Responses

204

Memories deletion completed

400

Invalid request - empty memory IDs list

application/json

422

Validation Error

application/json

500

Internal server error

application/json

503

Memory features are not available

application/json

delete

/memories

HTTPcURLJavaScriptPython

DELETE /memories HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "memory_ids": [
    "text"
  ]
}

No content

Delete All Memories for User

delete

Delete all memories for a specific user. This operation will permanently remove all memories associated with the provided user ID.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Responses

204

All memories deleted successfully

400

Invalid request - user_id is required

application/json

404

No memories found for the specified user

application/json

422

Validation Error

application/json

500

Internal server error

application/json

503

Memory features are not available

application/json

delete

/memories/all

HTTPcURLJavaScriptPython

DELETE /memories/all HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Update Memory Content

put

Update the content of a specific memory by its ID.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Path parameters

memory_idstringRequired

The unique identifier of the memory to update

Body

application/x-www-form-urlencoded

contentstring · min: 1 · max: 500Required

Updated content for the memory

Responses

200

Memory updated successfully or failed to update

application/json

422

Validation Error

application/json

500

Internal server error

application/json

503

Memory features are not available

application/json

put

/memories/{memory_id}

HTTPcURLJavaScriptPython

PUT /memories/{memory_id} HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 18

"content='text'"

{
  "success": true,
  "message": "Memory updated successfully"
}