AiMemoryPage
One memory page, as it reads now or at a revision.
Shape
- bodystringThe page, in Markdown; empty for a page nobody has written.
- kindAiMemoryPageKindagentsquadconventionsWhose page it is.
- revisioninteger · int64Its version, counted from 1; 0 for a page nobody has written.
- agent_handlestring or nulloptionalThe agent's handle, for an agent's page.
- notestring or nulloptionalWhat the writer said changed.
- squad_keystring or nulloptionalThe squad's key, for a squad's page.
- updated_atstring · date-time or nulloptionalWhen this version was written.
updated_byActorSummary or nulloptionalWho wrote this version — a person or the agent.
- The ActorSummary schema
- emailstringThe principal's address. An agent's is a generated no-reply address — the author of its commits.
unknownon a deleted actor and empty on a redacted one. - idstringThe principal's id: a user id, a service account id or an agent id, as
kindsays. Empty on a redacted actor. - usernamestringThe name to show: a person's or service account's username, or an agent's handle (which always ends in
-ai).deleted-userwhen the actor no longer resolves,redactedwhen the caller may not see who it was. - avatar_urlstring or nulloptionalThe principal's picture, when one is known. Absent otherwise: a client derives the deterministic avatar URL itself.
- kindPrincipalKinduserservice_accountagentor nulloptionalWhat the actor is — a person, a service account or an AI organization's agent — and so which page it links to. Absent on a placeholder (a redacted or deleted actor) and on an actor that is not a principal, such as the platform's own
systemactor; a client draws such an actor unlinked.
Example
Synthesized example{
"body": "Renders each region as density contours of its operations.",
"kind": "agent",
"revision": 68,
"agent_handle": "agent-handle-95e3",
"note": "note-57b3",
"squad_key": "squad-key-42f4",
"updated_at": "2026-10-15T23:38:58Z",
"updated_by": {
"email": "lin@acme.example",
"id": "id-f233",
"username": "lin",
"avatar_url": "https://gitmoap.example/acme/4f557106",
"kind": "user"
}
}
Graph
Used inside
No schema contains this one.
Contains
Used by
Sent by 0 operations
No operation takes it as a request body.
Returned by 6 operations
- GETAn agent's memory page — what it reads at the start of every session — at its newest revision/ai-agents/{agent_id}/memory
- PUTRewrite an agent's memory page whole, as a new revision. An edit made from an older revision/ai-agents/{agent_id}/memory
- GETThe organization's conventions: the decisions and ways of working every agent reads at the/groups/{group_id}/ai-org/conventions
- PUTRewrite the organization's conventions whole, as a new revision./groups/{group_id}/ai-org/conventions
- GETA squad's memory page — what its agents share — at its newest revision or an earlier one./groups/{group_id}/ai-org/squads/{squad_key}/memory
- PUTRewrite a squad's memory page whole, as a new revision./groups/{group_id}/ai-org/squads/{squad_key}/memory