GoodMemGoodMem
ReferenceAPIREST APIMemories

Get a memory by ID

Retrieves a single memory by its ID.

PERMISSION CLARIFICATION: With READ_MEMORY_OWN permission, access is granted if you own the parent space OR if the parent space is public (public_read=true). With READ_MEMORY_ANY permission, you can access any memory regardless of ownership. This is a read-only operation with no side effects and is safe to retry. Returns NOT_FOUND if the memory or its parent space does not exist.

GET
/v1/memories/{id}

Authorization

Path Parameters

idstring

The UUID of the memory to retrieve

Query Parameters

includeContent?boolean

Whether to include the original content in the response (defaults to false). The snake_case alias include_content is also accepted.

Defaultfalse
includeProcessingHistory?boolean

Whether to include background job processing history in the response (defaults to false). The snake_case alias include_processing_history is also accepted.

Defaultfalse

Response Body

curl -X GET "https://loading/v1/memories/550e8400-e29b-41d4-a716-446655440000?includeContent=false&includeProcessingHistory=false"
{
  "memoryId": "550e8400-e29b-41d4-a716-446655440000",
  "spaceId": "550e8400-e29b-41d4-a716-446655440001",
  "originalContent": "VGhpcyBpcyBiYXNlNjQgYmluYXJ5Lg==",
  "originalContentLength": 0,
  "originalContentSha256": "9f2c8c5a9d740eb56d...",
  "originalContentRef": "s3://my-bucket/document.pdf",
  "contentType": "text/plain",
  "processingStatus": "COMPLETED",
  "pageImageStatus": "COMPLETED",
  "pageImageCount": 12,
  "metadata": {
    "source": "document",
    "author": "John Doe"
  },
  "createdAt": 1672531200000,
  "updatedAt": 1672531200000,
  "createdById": "550e8400-e29b-41d4-a716-446655440002",
  "updatedById": "550e8400-e29b-41d4-a716-446655440002",
  "chunkingConfig": {
    "none": null,
    "recursive": {
      "chunkSize": 1000,
      "chunkOverlap": 200,
      "separators": [
        "\n\n",
        "\n",
        ".",
        " "
      ],
      "keepStrategy": "KEEP_END",
      "separatorIsRegex": false,
      "lengthMeasurement": "CHARACTER_COUNT"
    },
    "sentence": {
      "maxChunkSize": 1000,
      "minChunkSize": 100,
      "enableLanguageDetection": true,
      "lengthMeasurement": "CHARACTER_COUNT"
    }
  },
  "processingHistory": {
    "latestJob": {
      "jobId": 42,
      "jobType": "document_processor",
      "status": "BACKGROUND_JOB_RUNNING",
      "attempts": 1,
      "maxAttempts": 5,
      "runAt": 1714713600000,
      "leaseUntil": 1714713660000,
      "lockedBy": "worker-1",
      "lastError": "Transient network failure",
      "updatedAt": 1714713615000
    },
    "attempts": [
      {
        "attemptId": 101,
        "jobId": 42,
        "startedAt": 1714713605000,
        "finishedAt": 1714713612000,
        "ok": true,
        "workerId": "worker-1",
        "statusMessage": "Uploading chunk 3/10",
        "progressCurrent": 3,
        "progressTotal": 10,
        "progressUnit": "chunks",
        "progressUpdatedAt": 1714713609000,
        "errorMessage": "S3 upload timed out",
        "errorStacktrace": "string"
      }
    ]
  }
}
Empty
Empty
Empty
Empty

Delete a memory

Previous Page

Download memory content

Next Page