AchiralAchiral

Docs · LLMs and developers

Version3.14.0

Scoped 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

MethodPathWhoPurpose
GET/api/organizations/:id/memoryAny active memberMemory summary for one scope. See Scopes.
GET/api/organizations/:id/members/:userId/memoryOwners and adminsRedacted memory summary for an active member.
PUT/api/organizations/:id/memory/candidates/:weaviateIdOwners and adminsApprove or reject an organization core-memory candidate.
GET/api/organizations/:id/memory/ledgerOwners and adminsList organization memories, filtered by q, collection, and status. limit defaults to 100 and is capped at 200.
GET/api/organizations/:id/memory/exportOwners and adminsDownload the organization's memory as JSON.
POST/api/organizations/:id/memory/itemsOwners and adminsAdd an organization memory.
PATCH/api/organizations/:id/memory/items/:memoryIdOwners and adminscorrect, 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.

scopeReturnsWho may ask
teamThe organization's memory, without memory that belongs to an agentAny active member
meThe caller's own memory together with what their personal EA learned about themAny active member
me:mineOnly what the caller gaveAny active member
me:assistantOnly what the caller's personal EA learnedAny active member
agent:<agentId>One agent's memoryThe agent's creator, owners, and admins
member:<userId>Another member's counts, with no contentsOwners and admins
member:<userId>:mineCounts for only what that member gave, with no contentsOwners and admins
member:<userId>:assistantCounts for only what that member's personal EA learned, with no contentsOwners 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

JSON
{
  "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.