Skip to main content
GET
/
api
/
memory
Query or retrieve memories.
curl --request GET \
  --url https://www.memoryplugin.com/api/memory \
  --header 'Authorization: Bearer <token>'
[
  "<string>"
]

Documentation Index

Fetch the complete documentation index at: https://help.memoryplugin.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Image Memories

Responses may include image memories alongside text memories. Image memories include additional fields:
  • content_type: "image" — identifies this as an image memory
  • image_url — a signed URL to view the image (expires after 4 hours)
  • image_description — AI-generated description of the image content

​
Example Response

{
  "data": [
    {
      "id": "user-id-uuid",
      "text": "User prefers dark mode in all applications",
      "content_type": "text",
      "metadata": {
        "text": "User prefers dark mode in all applications",
        "createdAt": "2026-04-01T10:00:00Z",
        "bucketId": 65,
        "bucketName": "General"
      }
    },
    {
      "id": "user-id-uuid-2",
      "text": "A whiteboard diagram showing the auth flow with three microservices.",
      "content_type": "image",
      "image_url": "https://memoryplugin.com/storage/v1/object/sign/memory-images/...",
      "image_description": "A whiteboard diagram showing the auth flow with three microservices.",
      "metadata": {
        "text": "A whiteboard diagram showing the auth flow with three microservices.",
        "createdAt": "2026-04-06T10:30:00Z",
        "bucketId": 65,
        "bucketName": "General"
      }
    }
  ],
  "count": 2
}
Image URLs are temporary signed URLs that expire after 4 hours. If you need to access an image after the URL has expired, make another API request to get a fresh URL.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
query
string

Search query for memories. You will receive the 5 most relevant memories.

​
all
boolean

Fetch all memories

​
latest
boolean

Fetch latest memories

​
count
integer
default:10

Number of memories to retrieve, use with latest=true to limit the number of memories retrieved

​
v
number
default:2

API version - current is 2

​
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

Successful response