Skip to main content
POST
/
v1
/
memorize
curl -X POST https://memorymachines-gateway-prod-btf57kda.uc.gateway.dev/v1/memorize \
  -H "x-api-key: $ENGRAMME_API_KEY" \
  -F "file=@meeting-notes.txt" \
  -F "user_name=John Doe" \
  -F "item_id=meeting-2025-01-15" \
  -F "source_type=text"

{
  "status": "success",
  "user_id": "user_abc123",
  "item_id": "meeting-2025-01-15",
  "workflow_execution": "projects/engramme/locations/us-central1/workflows/realtime-memory-pipeline/executions/exec-abc123"
}

Documentation Index

Fetch the complete documentation index at: https://docs.engramme.com/llms.txt

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

Upload a document for memory extraction. The response confirms that processing has started; memories may take a short time to become recallable.
​
file
file
required
The document file to upload. Text files are limited to 10MB. PDFs are limited to 20MB.
​
user_name
string
required
Your name for generating first-person memory narratives.
​
item_id
string
Optional unique identifier for this document. Auto-generated if not provided. May contain word characters plus -, _, =, !, and :. Max 500 characters.
​
source_type
string
Document type hint for extraction and access control. See Source Types.
curl -X POST https://memorymachines-gateway-prod-btf57kda.uc.gateway.dev/v1/memorize \
  -H "x-api-key: $ENGRAMME_API_KEY" \
  -F "file=@meeting-notes.txt" \
  -F "user_name=John Doe" \
  -F "item_id=meeting-2025-01-15" \
  -F "source_type=text"

{
  "status": "success",
  "user_id": "user_abc123",
  "item_id": "meeting-2025-01-15",
  "workflow_execution": "projects/engramme/locations/us-central1/workflows/realtime-memory-pipeline/executions/exec-abc123"
}

​
Processing

workflow_execution is a backend processing reference. Most clients do not need to call it directly. If you provide an item_id, the API may return 409 while the same item is currently being processed. Use stable unique IDs when you want deduplication; omit item_id for simple uploads.