Skip to main content

​
Base URL

All API requests should be made to: 
https://memorymachines-core-api-mvp-gateway-6v1lw71z.uc.gateway.dev

​
Authentication

Include your API key in the x-api-key header: 
curl -H "x-api-key: your_api_key_here" ...
See Authentication for details.

​
Endpoints

​
Memorize

MethodEndpointDescription
POST/v1/memorizeUpload a document

​
Memories

MethodEndpointDescription
POST/v1/memories/askAsk with AI response
POST/v1/memories/recallRecall raw memories
POST/v1/memories/feedbackRate a memory

​
Health

MethodEndpointDescription
GET/v1/healthHealth check

​
Request Format

Most endpoints accept multipart/form-data: 
curl -X POST https://memorymachines-core-api-mvp-gateway-6v1lw71z.uc.gateway.dev/v1/memorize \
  -H "x-api-key: YOUR_API_KEY" \
  -F "file=@document.txt" \
  -F "user_name=John Doe"

​
Response Format

All responses are JSON: 
{
  "status": "success",
  "user_id": "user_abc123",
  "item_id": "document-123"
}

​
Error Handling

Errors return appropriate HTTP status codes with a JSON body: 
{
  "detail": "Error message here"
}
StatusMeaning
400Bad Request - Invalid parameters
401Unauthorized - Invalid API key
403Forbidden - Access denied
404Not Found - Resource doesn’t exist
409Conflict - Duplicate item ID
429Too Many Requests - Rate limited
500Server Error - Something went wrong

​
Rate Limits

LimitValue
Requests per minute1,000
Max file size10 MB
Max query length1,000 characters
When rate limited, wait 60 seconds before retrying.

​
SDKs

Python SDK

Install with pip install memorymachines
Or use any HTTP client directly (cURL, fetch, requests, etc.).