Skip to main content
POST
Edit your agent's memory

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
action
enum<string>
required

add: a new entry; remove: the entry whose whole text is text.

Available options:
add,
remove
target
enum<string>
required

notes: your agent's notes; profile: what it keeps about you.

Available options:
notes,
profile
text
string
required

One entry: not blank, at most 12000 characters, with no whitespace at either end, no carriage return, and no § on a line of its own between two lines; an added entry does not end with one either.

Response

Accepted

action
enum<string>
required

add: a new entry; remove: the entry whose whole text is the edit's.

Available options:
add,
remove
id
string<uuid>
required
issued_at
string<date-time>
required
state
enum<string>
required

pending: your agent has not applied it yet, or has not woken for it; completed: applied, and your agent's next turn reads it; failed: your agent's memory refused it, for failure.

Available options:
pending,
completed,
failed
target
enum<string>
required

notes: your agent's notes; profile: what it keeps about you.

Available options:
notes,
profile
text
string
required
completed_at
string<date-time>

When the edit was applied or refused; absent while pending.

failure
string

Why the edit was refused: the entry would put the file past its limit, no entry is the removed text, or the host could not apply it. Present on a failed edit.