REST API

Memax REST API reference. All endpoints, request/response formats, and authentication.

The Memax API is a REST API served at https://api.memaxlabs.com. All endpoints are under the /v1/ prefix.

Base URL

https://api.memaxlabs.com/v1

All API requests require authentication via Bearer token:

curl -H "Authorization: Bearer mk_your_api_key" \
  https://api.memaxlabs.com/v1/memories

See Authentication for details on obtaining and managing API keys.

All responses follow a standard envelope:

{
  "data": { ... }
}

Errors return:

{
  "error": {
    "code": "not_found",
    "message": "Memory not found"
  }
}

List endpoints support cursor-based pagination:

GET /v1/memories?limit=20&cursor=eyJpZCI6Im1lbV8...

Response includes pagination info:

{
  "data": {
    "memories": [...],
    "next_cursor": "eyJpZCI6Im1lbV8...",
    "has_more": true
  }
}

Rate limit headers are included in every response:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 298
X-RateLimit-Reset: 1704067200

For TypeScript projects, use the memax-sdk client library instead of raw HTTP calls. It handles authentication, pagination, and error handling.