Skip to main content
POST
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.

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.