Agent memory

Overview

Every personal CREAO agent has long-term memory (called Playbooks in the product UI). Memory is created automatically as the agent runs and learns reusable workflow rules. The Developer API lets you read that memory, overwrite it, or clear it. Memory is scoped per agent. Changing one agent’s memory never affects another.

Read memory

curl https://developer.creao.ai/v1/agents/00000000-0000-4000-8000-000000000000/memory \
  -H "Authorization: Bearer cr_sk_your_key_here"

{
  "items": [
    {
      "id": "7",
      "name": "region-check",
      "content": "Always validate region before deploy.",
      "trigger": "Deployment request",
      "rationale": "Learned from repeated corrections.",
      "status": "approved",
      "created_at": "2026-07-01T00:00:00.000Z"
    }
  ]
}

Optional query params:

status — pending, approved, rejected, all, or a comma-separated list
limit — default 500, max 1000

An agent with no memory returns { "items": [] }.

Overwrite memory

PUT replaces the entire memory set. New items are written first; previous items are deleted only after that write succeeds, so a failed overwrite leaves the existing memory untouched.

curl -X PUT https://developer.creao.ai/v1/agents/00000000-0000-4000-8000-000000000000/memory \
  -H "Authorization: Bearer cr_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "name": "region-check",
        "content": "Always validate region before deploy.",
        "trigger": "Deployment request",
        "status": "approved"
      }
    ]
  }'

Rules:

Max 100 items per request
Each content value is capped at 8 KB
status defaults to approved when omitted (so items apply on the next run)
Pass "items": [] to clear memory via overwrite

Clear memory

curl -X DELETE https://developer.creao.ai/v1/agents/00000000-0000-4000-8000-000000000000/memory \
  -H "Authorization: Bearer cr_sk_your_key_here"

{
  "ok": true,
  "deleted_count": 3
}

Errors

Code	When
`AGENT_NOT_FOUND`	Agent is missing, not personal, or not owned by the API key account
`FEATURE_DISABLED`	Agent memory is not configured in this environment
`INVALID_INPUT`	Bad UUID, status filter, or request body
`REFLEXIO_*` / `502`	Upstream memory service failed

See also the OpenAPI operations under Agent Memory.

Get Started

Agents

Agent Files

Runs

Models

Concepts

Agent memory

Overview

Read memory

Overwrite memory

Clear memory

Errors

​Overview

​Read memory

​Overwrite memory

​Clear memory

​Errors

Overview

Read memory

Overwrite memory

Clear memory

Errors