API Overview

Base URL

https://api.memorykit.io/v1

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer ctx_your_api_key_here

Response format

All responses return JSON. Successful responses use standard HTTP status codes:

Status	Description
`200`	Success
`201`	Created
`202`	Accepted (async processing)
`204`	No content (successful delete)

Error format

{
  "error": {
    "code": "invalid_request",
    "message": "The 'content' field is required.",
    "status": 400
  }
}

Rate limits

Rate limits are applied per API key. Current limits depend on your plan. Rate limit headers are included in every response:

Header	Description
`X-RateLimit-Limit`	Maximum requests per window
`X-RateLimit-Remaining`	Remaining requests in current window
`X-RateLimit-Reset`	Unix timestamp when the window resets

Pagination

List endpoints use cursor-based pagination:

const page1 = await mk.memories.list({ limit: 20 });
// page1.data — Memory[]
// page1.has_more — boolean
// page1.cursor — string (pass to next request)
 
const page2 = await mk.memories.list({ limit: 20, cursor: page1.cursor });