Skip to main content

​
Base URL

https://api.memoclaw.com

​
Request Format

All requests use Content-Type: application/json. The maximum request body size is 64 KB.

​
Authentication

MemoClaw uses your wallet as identity — no API keys or accounts needed.
  • Paid endpoints (store, recall, update, extract, ingest, consolidate, context, migrate) require an x402 payment header or free tier credits. Your wallet address is extracted from the payment proof.
  • Free endpoints (list, get, delete, search, suggested, core memories, relations, history, graph, export, namespaces, stats) require only a wallet signature via the x-wallet-auth header. No payment needed.
See Pricing for the full breakdown of paid vs. free endpoints.

​
Request ID

Every response includes a unique X-Request-Id header. Include this when contacting support or debugging issues. 
X-Request-Id: 550e8400-e29b-41d4-a716-446655440000

​
Error Format

All errors return a consistent JSON structure: 
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Content is required",
    "details": {
      "field": "content"
    }
  }
}
See Error Codes for a full list of error codes and their meanings.

​
TypeScript Examples

Some API reference pages include TypeScript code samples using the memoclaw package. The SDK client (MemoClawClient) is planned but not yet exported — these examples show the intended interface. For now, use the CLI (npm install -g memoclaw) or direct REST API calls. See TypeScript SDK for details.