TraceeDocs

Memory

Remember something

Keeps one short statement. scope=personal needs a person's token. Goals carry their number in value and unit.

POSThttps://traceeai.com/api/v1/memories

CLI:tracee memory add·MCP:memoryaction remember

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

Body

application/json
  • contentstringrequired

    One short, self-contained statement in plain English

    up to 600 characters

  • kindstringrequired

    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

Errors
  • 201Created.

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