Project Memories

Overview

Memories are a project-scoped knowledge base that agents build up over time. During execution, an agent can save an operational insight (a workaround it discovered, an efficient navigation path, a timing requirement) and future agents working on the same project can recall these memories to avoid repeating mistakes.

Each memory has a context (where it applies, like a specific page or flow), content (the actual advice), and a category (workaround, efficient_path, timing, navigation, auth, or general). Memories can also be created and managed via the API, not just by agents.

Recall and deduplication

When an agent recalls memories, the system performs a full-text search across the context and content fields and returns the most relevant active memories. Recall is ranked by relevance and limited to a small number of results to keep the agent's context focused.

When saving, the system checks for duplicates. If an existing memory covers the same context with similar content, it is reconfirmed (its use count increments and staleness resets) rather than creating a duplicate. If the context matches but the content has changed, the old memory is marked stale and the new one takes its place. This keeps the knowledge base current without manual cleanup.

Create a project memory

Creates a new memory or reconfirms an existing one if a duplicate is detected.

Parameters

Status Codes

Response Body

{
  "id": "019d...",
  "project_id": "019c...",
  "source": "api",
  "category": "timing",
  "context": "login page",
  "content": "Wait 3s after login for the dashboard spinner to finish",
  "status": "active",
  "use_count": 0,
  "staleness": 0,
  "created_at": "2026-03-27T10:00:00Z"
}

List project memories

Returns memories for a project with cursor-based pagination. Filterable by status, category, and source.

Parameters

Status Codes

Get a project memory

Parameters

Status Codes

Update a project memory

Update status, content, category, or context of a memory.

Parameters

Status Codes

Delete a project memory

Parameters

Status Codes