Docs · LLMs and developers
Version3.14.0Scoped memory summaries for every member, plus owner and admin routes for the ledger, edits, and candidate review.
Organization memory
Organization memory routes power the organization's Memory pages (/memory). They need a signed-in workspace session. The summary route is open to every active member and checks each scope against the caller's role; the other routes require an owner or admin.
Routes
| Method | Path | Who | Purpose |
|---|---|---|---|
GET | /api/organizations/:id/memory | Any active member | Memory summary for one scope. See Scopes. |
GET | /api/organizations/:id/members/:userId/memory | Owners and admins | Redacted memory summary for an active member. |
PUT | /api/organizations/:id/memory/candidates/:weaviateId | Owners and admins | Approve or reject an organization core-memory candidate. |
GET | /api/organizations/:id/memory/ledger | Owners and admins | List organization memories, filtered by q, collection, and status. limit defaults to 100 and is capped at 200. |
GET | /api/organizations/:id/memory/export | Owners and admins | Download the organization's memory as JSON. |
POST | /api/organizations/:id/memory/items | Owners and admins | Add an organization memory. |
PATCH | /api/organizations/:id/memory/items/:memoryId | Owners and admins | correct, pin, fade, prune, or restore one memory. collection is required. prune requires confirmed: true. |
Routes that read or change organization memory take an environmentId (query string for GET, body otherwise) naming the environment. A personal (me) or member: scope does not depend on it.
Scopes
GET /api/organizations/:id/memory takes a scope query parameter. It defaults to team.
scope | Returns | Who may ask |
|---|---|---|
team | The organization's memory, without memory that belongs to an agent | Any active member |
me | The caller's own memory together with what their personal EA learned about them | Any active member |
me:mine | Only what the caller gave | Any active member |
me:assistant | Only what the caller's personal EA learned | Any active member |
agent:<agentId> | One agent's memory | The agent's creator, owners, and admins |
member:<userId> | Another member's counts, with no contents | Owners and admins |
member:<userId>:mine | Counts for only what that member gave, with no contents | Owners and admins |
member:<userId>:assistant | Counts for only what that member's personal EA learned, with no contents | Owners and admins |
An unknown scope returns 400. A member: scope from anyone but an owner or admin returns 403. An agent the caller may not read returns 404, as does a user who is not an active member.
Paging
Top memories come back most activated first, a page at a time. limit defaults to 25 and is capped at 100; offset starts at 0. nextOffset is the offset of the next page, or null on the last page. Tier counts and candidate counts always cover the whole scope, not just the page.
Summary fields
{
"success": true,
"scope": "team",
"memory": {
"tierDistribution": {
"episodic": 128,
"semantic": 42,
"core": 7
},
"topMemories": [],
"nextOffset": 25,
"candidates": [],
"candidateCount": 3,
"totalMemories": 177
}
}For member:<userId>, member:<userId>:mine, and member:<userId>:assistant, topMemories and candidates are always empty and nextOffset is null; only the counts are filled in.
The response reports memory tiers as aggregate state for the scope. It does not provide separate procedural, episodic, semantic, flashbulb, or core endpoints.