GET /memories

Returns the memories rendered as a markdown index (one line per memory, carrying its id, path, and description) plus the same entries structured, each with every field except `content`. Read the index, then fetch the ids whose content you want.

curl "https://api.ellipsis.dev/v1/memories" \
  -H "Authorization: Bearer $ELLIPSIS_API_KEY"

{
  "index": "string",
  "memories": [
    {
      "content_sha256": "string",
      "created_at": "2026-01-01T00:00:00Z",
      "created_by": {
        "id": "string",
        "type": "agent_session"
      },
      "description": "string",
      "id": "string",
      "path": "string",
      "updated_at": "2026-01-01T00:00:00Z",
      "updated_by": {
        "id": "string",
        "type": "agent_session"
      }
    }
  ]
}

import os

from ellipsis import Ellipsis

client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])

result = client.memories.list()
print(result)

{
  "index": "string",
  "memories": [
    {
      "content_sha256": "string",
      "created_at": "2026-01-01T00:00:00Z",
      "created_by": {
        "id": "string",
        "type": "agent_session"
      },
      "description": "string",
      "id": "string",
      "path": "string",
      "updated_at": "2026-01-01T00:00:00Z",
      "updated_by": {
        "id": "string",
        "type": "agent_session"
      }
    }
  ]
}

import { Ellipsis } from '@ellipsis-dev/sdk';

const client = new Ellipsis({
  apiKey: process.env.ELLIPSIS_API_TOKEN!,
});

const result = await client.memories.list();
console.log(result);

{
  "index": "string",
  "memories": [
    {
      "content_sha256": "string",
      "created_at": "2026-01-01T00:00:00Z",
      "created_by": {
        "id": "string",
        "type": "agent_session"
      },
      "description": "string",
      "id": "string",
      "path": "string",
      "updated_at": "2026-01-01T00:00:00Z",
      "updated_by": {
        "id": "string",
        "type": "agent_session"
      }
    }
  ]
}

No request body.

{
  "properties": {
    "index": {
      "type": "string"
    },
    "memories": {
      "items": {
        "properties": {
          "content_sha256": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "properties": {
              "id": {
                "type": "string"
              },
              "type": {
                "enum": [
                  "agent_session",
                  "api_key",
                  "user"
                ],
                "type": "string"
              }
            },
            "required": [
              "type",
              "id"
            ],
            "type": "object"
          },
          "description": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "updated_by": {
            "properties": {
              "id": {
                "type": "string"
              },
              "type": {
                "enum": [
                  "agent_session",
                  "api_key",
                  "user"
                ],
                "type": "string"
              }
            },
            "required": [
              "type",
              "id"
            ],
            "type": "object"
          }
        },
        "required": [
          "id",
          "path",
          "description",
          "content_sha256",
          "created_by",
          "updated_by",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "index",
    "memories"
  ],
  "type": "object"
}

Request

Responses

On this page