Skip to main content
Price: $0.0005 USDC

Query Parameters

limit
integer
Maximum number of results, 1–100. Default: 20.
offset
integer
Pagination offset. Default: 0.
tags
string
Comma-separated tags. Filter memories matching any of the specified tags.
namespace
string
Filter by namespace.

Response (200)

memories
array
Array of memory objects.
total
number
Total number of matching memories.
limit
number
Applied limit.
offset
number
Applied offset.

Example

curl "https://api.memoclaw.dev/v1/memories?limit=10&offset=0&tags=preferences,ui"
Response
{
  "memories": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "namespace": "default",
      "content": "User prefers dark mode and vim keybindings",
      "metadata": {
        "tags": ["preferences", "ui"]
      },
      "importance": 0.8,
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-15T10:30:00Z",
      "accessed_at": "2025-01-20T14:22:00Z",
      "access_count": 3
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0
}