> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memoclaw.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Overview

> Base URL, request format, authentication headers, and common patterns.

## 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](/get-started/authentication) or [free tier](/api-reference/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](/reference/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:

```json theme={null}
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Content is required",
    "details": {
      "field": "content"
    }
  }
}
```

See [Error Codes](/reference/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](/get-started/cli) (`npm install -g memoclaw`) or direct [REST API](/api-reference/overview) calls. See [TypeScript SDK](/get-started/typescript-sdk) for details.