v2

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-272589173.5 KB
Memories

Retrieve an engram

Retrieves detailed information about a specific engram by its ID.

This endpoint returns the engram's metadata, status, and system information. It does not return the engram's content - use the /engrams/{id}/download endpoint for that.

Users can only retrieve engrams they own or have access to through collections. Superusers can retrieve any engram.

get/v1/memories/{id}

Path parameters

idstring uuid required

The ID of the engram to retrieve.

The ID of the engram to retrieve.

Response

Successful Response

Example response

{
  "results": {
    "collection_ids": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "created_at": "2021-01-01T00:00:00",
    "document_type": "pdf",
    "engram_type": "document",
    "extraction_status": "pending",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "ingestion_attempt_number": 0,
    "ingestion_status": "pending",
    "metadata": {
      "title": "Sample Document"
    },
    "owner_id": "123e4567-e89b-12d3-a456-426614174000",
    "size_in_bytes": 123456,
    "title": "Sample Document",
    "total_tokens": 1000,
    "updated_at": "2021-01-01T00:00:00",
    "version": "1.0"
  }
}