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.
x-api-key<token>
In: header
Path Parameters
idstring
The unique identifier of the memory to retrieve
Query Parameters
includeContent?boolean
Whether to include the original content in the response (defaults to false)
includeProcessingHistory?boolean
Whether to include background job processing history in the response (defaults to false)
Response Body
curl -X GET "http://localhost:8080/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",
"metadata": "{\"source\": \"document\", \"author\": \"John Doe\"}",
"createdAt": "1672531200000",
"updatedAt": "1672531200000",
"createdById": "550e8400-e29b-41d4-a716-446655440002",
"updatedById": "550e8400-e29b-41d4-a716-446655440002",
"chunkingConfig": {
"none": {},
"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