API Overview - Orca Memory

Base URL

All API requests use the following base URL:

https://app.orcamemory.com/api/v1

For self-hosted deployments, replace with your own domain.

All API endpoints require authentication via API key. Include your credentials in the headers:

X-Key-Id: omk_your_key_id
X-Api-Key: oms_your_api_key

Get your credentials from the dashboard at Link Agent or Settings → General.

Most users don’t need to call the API directly. The OpenClaw plugin handles everything automatically:

Use the direct API only if you’re building custom integrations or non-OpenClaw applications.

Method	Endpoint	Description
`POST`	`/memory/store`	Store a new memory
`POST`	`/memory/search`	Search memories semantically
`POST`	`/memory/recent`	Get recent memories
`DELETE`	`/memory/:id`	Delete a memory

All responses are JSON:

{
  "success": true,
  "data": { ... }
}

Error responses:

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}

Rate limits are based on your plan’s token and search quotas: