Org in a Box
API Reference

Memories API

List, search, create, and manage long-term agent memories.

GET /v1/memories

List memories for the authenticated user. Supports semantic search.

Query parameters:

  • q — semantic search query (uses pgvector cosine similarity)
  • kind — filter by fact | preference | event | skill-note
  • limit — max results (default 20, max 100)
  • visibility — filter by private | team | org

Response:

{
  "memories": [
    {
      "id": "uuid",
      "kind": "fact",
      "content": "Alice is VP of Engineering at Acme Corp",
      "visibility": "private",
      "createdAt": "2026-04-18T..."
    }
  ]
}

POST /v1/memories

Add a new memory.

Request:

{
  "kind": "fact",
  "content": "Customer renewal date is Q3 2026",
  "visibility": "team"
}

PATCH /v1/memories/:id

Update visibility.

Request:

{ "visibility": "team" }

DELETE /v1/memories/:id

Delete a memory. Requires ownership or memory.delete permission.

On this page