API Overview

Base URL

https://api.memorykit.io/v1

OpenAPI Specification

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer ctx_your_api_key_here

See Authentication for key management, scopes, and security practices.

Response format

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

Errors

All errors return a consistent JSON structure with type, code, message, and request_id. See Error Handling for the full error code reference, SDK exception types, and retry strategies.

Rate limits & quotas

Rate limits are per API key, per endpoint, with a 60-second sliding window. Plan quotas limit monthly queries and total documents. See Limits & Quotas for the full table.

Pagination

List endpoints use starting_after pagination:

const page1 = await mk.memories.list({ limit: 20 });
// page1.data — Memory[]
// page1.has_more — boolean
 
if (page1.has_more) {
  const lastId = page1.data[page1.data.length - 1].id;
  const page2 = await mk.memories.list({ limit: 20, startingAfter: lastId });
}