Memory

Change a memory

New words replace it; the old version stays in its history. id may be its first 8 characters.

PATCHhttps://traceeai.com/api/v1/memories/{id}

CLI:tracee memory update·MCP:memoryaction update

Authorizations

  • Authorizationstringheaderrequired

    Bearer <key>: a personal key (tracee login or Settings → Personal keys), a workspace key, or an MCP client's OAuth token. See Authentication.

Headers

  • Tracee-Workspacestring

    For a personal key or OAuth token that reaches several workspaces: the workspace id to act on. Workspace keys don't need it.

    uuid

Path parameters

  • idstringrequired

    A memory id, or its first 8 characters. From GET /api/v1/memories.

    up to 40 characters

Body

application/json
  • contentstring

    One short, self-contained statement in plain English

    up to 600 characters

  • kindstring

    The kind

    Available options:preferencedecisiongoalfactaudiencecompetitorlessonperson

  • topicstring

    A word or two it's about: a network, a product, a campaign

    up to 60 characters

  • scopestring

    The scope

    Available options:workspacepersonal

  • valuenumber | null

    For goals and targets: the number

  • unitstring | null

    What the number counts

    up to 40 characters

  • importanceinteger

    3 = always keep in mind

    1–3

  • pinnedboolean

    Always included with every message

Response

  • 200Done.

    The action's result, exactly as the MCP tool returns it to agents. A next field, when present, names the endpoint that follows up.