Memory
The memory of the calling project. Each write with a virtual key is an agent's write.
Read the memory settings
The memory settings of the project of the key: whether memory is on, the sources it remembers, the capture mode, and the counts and the cost of the memories. The key makes no call to list the projects: it knows its project.
Read the activity
What the project of the key did in the window: the conversations, the memories, the calls and their cost. The same arguments and the same answer as `GET /api/teams/{slug}/memory/activity`.
List the commits of a conversation
The git commits and the desk changes and landings of one conversation. The same arguments and the same answer as `GET /api/teams/{slug}/memory/commits`.
List the decisions
The live decisions of the project of the key, newest first. `subject` keeps its own decisions and the project's, and `scope` keeps the repository's and the project's. `area` keeps the decisions of one area, such as `database`. A decision that another decision closed is not in the list.
Record a decision, or list the decisions
With `decision` and `reason`, records one decision of the project of the key, and closes the decisions that it replaces. The origin of the decision is `agent`, and its author is `key:<prefix>`. The same body and the same answer as `POST /api/teams/{slug}/memory/decisions`. Without those two fields, the body holds the filters of a page (`subject`, `scope`, `area`, `cursor`, `limit`) and is optional, and the route answers like `GET /v1/memory/decisions`.
Read the diary
The diary entries of the project of the key, newest first. `agent` keeps the entries of one agent. The same arguments and the same answer as `GET /api/teams/{slug}/memory/diary`.
Write the diary
Writes one diary entry of the project of the key. The origin of the entry is `agent`, and its author is `key:<prefix>`. The same body and the same answer as `POST /api/teams/{slug}/memory/diary`.
Diff the files of a conversation
The diff of each file that an agent changed in one conversation. The same arguments and the same answer as `GET /api/teams/{slug}/memory/diff`.
Search the edits
The edits of the files in the conversations of the project of the key. The same arguments and the same answer as `GET /api/teams/{slug}/memory/edits`.
Read a conversation
Returns one conversation of the project of the key, with the text that the memory worker read from it.
Remove a conversation
Removes one conversation of the project of the key: its messages, and the memories that no other conversation also wrote. A memory that another conversation also wrote stays live. The call needs `confirm: true`.
Rename a conversation
Gives one conversation of the project of the key a title that a person chose. The extraction keeps that title and writes only its summary.
Read the markers of a conversation
The prompts of one conversation of the project of the key, oldest first, each with the marker that its wording shows (`interrupt`, `frustrated`, `correction` or `approval`), and the count of each marker. The same arguments and the same answer as `GET /api/teams/{slug}/memory/episodes/{id}/markers` (#523).
Remember a conversation
Asks memory to read one conversation of the project of the key from its start and to write memories from it, at the project's next batch, which starts now. Memory reads it even when it is a one-turn call with no end user. With `focus`, the extraction looks for that. With `now: true`, the call reads the conversation before it answers, and `memories` counts what the read wrote.
Name a path that the memory of the key's project does not read
The call needs `confirm: true`, as the route of a member does.
List the paths that the memory of the key's project does not read
The key comes first: a caller with no key gets 401 before it learns anything.
Find the files that the history already wrote
The files of the project that a name is close to, best first, with the edits of each file and the conversation that changed it last. The same arguments and the same answer as `GET /api/teams/{slug}/memory/files/similar`.
Read the knowledge graph, or add a relation
Without `from`, `predicate` and `to`, returns the live facts of the knowledge graph of the project; the body is then optional. With them, writes a relation, as the person route does, and answers it with `201`.
End one fact of the knowledge graph
The same arguments and the same answer as `POST /api/teams/{slug}/memory/graph/invalidate`, for the project of the key.
Read how much the knowledge graph of the project holds
The same arguments and the same answer as `GET /api/teams/{slug}/memory/graph/stats`, for the project of the key.
Read how much the knowledge graph of the project holds, with a body
The same answer as `GET /v1/memory/graph/stats`, with the fields in the body of the request. A virtual key sends the fields here.
Read the facts of the graph in the order of time
The same arguments and the same answer as `GET /api/teams/{slug}/memory/graph/timeline`, for the project of the key.
Read the facts of the graph in the order of time, with a body
The same answer as `GET /v1/memory/graph/timeline`, with the fields in the body of the request. A virtual key sends the fields here.
Browse the newest items of one source of the memory
Answers the newest memories, decisions, conversations, diary entries or values of the project of the key: 50 of them unless the caller names another number. The decisions answer a cursor for the next page.
Read one item of one source of the memory
Reads one memory, decision, conversation, diary entry or value by its id: the item itself, its whole text, or its triples. A memory that a correction closed answers with the id of the memory that replaced it and the text of that memory.
Write a memory
Writes one memory of the project of the key. The origin of the memory is `agent`, and its author is `key:<prefix>`.
Remove a memory
Closes a live memory, so recall does not return it. A key can remove only a memory whose origin is `agent` or `observed`.
Correct a memory
Replaces the text or the scope of a live memory. proxium closes the old memory and writes a new one with the new text and scope. A key can change only a memory whose origin is `agent` or `observed`.
Rate a memory
Records whether a memory was useful or wrong when the agent used it.
Read the messages of a conversation
The messages that the workers sent to a parent conversation of the project of the key, newest first. The parent is the header `x-proxium-memory-parent` of the call, or the parameter `parent`. The same arguments and the same answer as `GET /api/teams/{slug}/memory/messages`.
Send a message to a parent conversation
A worker reports to the conversation that started it. The parent is the header `x-proxium-memory-parent` of the call, or the field `parent`. The origin of the message is `agent`, and its author is `key:<prefix>`. The same body and the same answer as `POST /api/teams/{slug}/memory/messages`.
Search the prompts
The messages that people typed in the project of the key, newest first. The same arguments and the same answer as `GET /api/teams/{slug}/memory/prompts`.
Resume the last conversations
The last conversations of the project of the key, with the decisions and the diary entries that belong to them. The same arguments and the same answer as `GET /api/teams/{slug}/memory/resume`.
List the scopes of the memory
Lists the scopes of the project of the key with the number of live memories of each. A row with `scope: null` counts the memories of the whole project, and a row named `unsorted` counts the memories that no recall returns until they get a scope. `subject` narrows the count to one subject and the whole project.
Search the memory
Searches the conversations and the memories of the project of the key. When the project embeds, proxium also searches the memories by vector.
List the secrets that memory found in the key's project
The key comes first: a caller with no key gets 401 before it learns anything.
Dismiss the finding with this hash, as the key's project
The call needs `confirm: true`, as the route of a member does.
Dismiss every open finding of one kind, as the key's project
The call needs `confirm: true`, as the route of a member does.
List the secret shapes that the key's project adds
A rule is a literal prefix and the shortest secret that follows it.
Add a shape that the scan of the key's project looks for
A rule with a name that the project already holds is replaced.
Remove a shape that the scan of the key's project looked for
The findings that the rule already made stay.
List the secrets of one conversation of the key's project
The findings of the conversation, the first message first.
Find similar conversations
The conversations of the project of the key that are similar to one of its conversations. The same arguments and the same answer as `GET /api/teams/{slug}/memory/similar`.
Where the cost of the memory of a project goes
Answers the conversations, the turns, the calls and the cost of the memory of the project in a window, the change against the window before it, and the cost of each model and of each call type. The spend is the project's: a usage event carries no end user and no scope, so `subject` narrows only the conversations, and a `scope` is refused.
The counts of the memory of a project and the queue that waits
Answers the counts of the conversations, turns, chunks, live memories and live triples of the project, the live memories of each scope, the memories that wait for review, the conversations whose memory is behind, and the time and the error of the last extraction. A conversation is behind when it holds turns that the worker has not processed, or when its last turn is inside the idle window.
Read the stored values
The values of the project of the key, by namespace and key. The same arguments and the same answer as `GET /api/teams/{slug}/memory/store`.
Set a stored value
Sets one value of the project of the key. The same body and the same answer as `PUT /api/teams/{slug}/memory/store`.
Search the conversations that a subagent ran
The messages of the conversations that came from a subagent, newest first. A harness marks such a call with `x-proxium-memory-parent` and `x-proxium-memory-kind` (or the header of its own harness: `x-claude-code-parent-agent-id`, `x-codex-parent-thread-id`, `x-opencode-parent-session-id`), and memory keeps both on the conversation. The same arguments and the same answer as `GET /api/teams/{slug}/memory/subagents/search` (#531).
Erase an end user
Erases one end user in one transaction: the memories, the profile page and the conversations of the end user, the stored bodies of the calls of the end user, and the chain parts that only those calls used. proxium keeps a SHA-256 of the subject so that a call already in the queue is discarded. You cannot undo this operation.
Read the work of each member
The conversations and the memories of each caller identity of the project in a window, latest activity first. A member is the prefix of a key, or `login:` and the first 8 characters of the subscription of a person. The same arguments and the same answer as `GET /api/teams/{slug}/memory/team/activity`.
Read the memory at the start of a task
Returns what an agent reads at the start of a task: the pinned and the most trusted memories, the newest conversations, and the pages. The body is optional.