Skip to main content
This page collects operational details that apply across the Engramme API.

​
Rate Limits

Requests are subject to gateway and application-level limits. The public gateway currently enforces: If you receive 429 Too Many Requests, retry with exponential backoff. Response bodies can vary by which layer returns the limit. Application-level limits may return:

​
Request Limits

item_id may contain word characters plus -, _, =, !, and :.

​
Status Codes

​
Upload Conflicts

If you provide your own item_id, /v1/memorize may return 409 when the item is already being processed. Use generated IDs for simple uploads. Use stable unique item_id values when you want deduplication or idempotent behavior.

​
Async Processing

/v1/memorize returns after upload is accepted and processing has started. Memories may not be immediately available through /v1/memories/recall. If recall returns no results right after upload, retry after a short delay.