GET
/
api
/
v2
/
memory
Get memories and buckets in a single request
curl --request GET \
  --url https://www.memoryplugin.com/api/v2/memory \
  --header 'Authorization: Bearer <token>'
{
  "memories": [
    {
      "text": "<string>",
      "metadata": {
        "text": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "bucketId": 123,
        "bucketName": "<string>"
      }
    }
  ],
  "buckets": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "memoryCount": 123
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

bucketId
integer

Optional bucket ID to filter memories

count
integer
default:10

Number of memories to retrieve

all
boolean

Fetch all memories

latest
boolean

Fetch latest memories

query
string

Search query for memories

source
string

Client source identifier (e.g., 'chatgpt' for ChatGPT requests)

skip
integer
default:0

Number of memories to skip for pagination. Zero-indexed: skip=0 starts from first memory, skip=10 skips first 10 memories and starts from 11th. Used primarily with token limiting to load additional memories beyond the initial response.

Required range: x >= 0

Response

200
application/json

Successful response with memories and buckets

The response is of type object.