Agents

Replace or append to an AI Agent's Memory (v2)

Edits soulMd, the agent's long-lived notes, shown as "Memory" in the admin UI. soulMd replaces the whole text; append adds a line to the end. Send one of them (if both are sent, soulMd wins). Running bots of this agent get the new text straight away.

Owner only. Supports User JWT and B2B Server JWT.

post/v2/agents/{idOrAddress}/soul

Request

  • Base URL: https://api.chat.ethora.com
  • URL: https://api.chat.ethora.com/v2/agents/{idOrAddress}/soul
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

idOrAddressstring required

Agent id, or the agent's 0x... address.

Request body

soulMdstring

New Memory text (replaces the current one; "" clears it).

appendstring

Text added at the end, on a new line.

Response 

{ ok: true, agent: Agent }   // soulMdUpdatedBy: 'operator'

Changes

No recorded changes to this operation across all 1 revision of this API.