memory — @personaai/sdk

Generated field tables for memory — do not edit

Generated from sdk/typescript/dist/typedoc.json — do not edit. Regenerate with node platform/scripts/typedoc-resources.mjs.

memory

Auth: Requires Authorization: Bearer <keyId>.<secret> (server-side). For per-user calls add x-persona-external-user-id. See .

Memory is a file-based store: /memories/user/ (shared) and /memories/agent/ (per user-agent). Agents read/write via write_file/read_file.

Example

TypeScript

const list = await userClient.memory.list();await userClient.memory.writeFile({ path: '/memories/user/preferences.md', content: '# Likes\n- concise answers' });

const list = await userClient.memory.list();await userClient.memory.writeFile({ path: '/memories/user/preferences.md', content: '# Likes\n- concise answers' });

cURL

bash

curl https://api.persona.hasanraiyan.me/api/v1/developer/memory/file?path=/memories/user/preferences.md \  -H "Authorization: Bearer $PERSONA_CREDENTIAL" -H "x-persona-external-user-id: user_123"

curl https://api.persona.hasanraiyan.me/api/v1/developer/memory/file?path=/memories/user/preferences.md \  -H "Authorization: Bearer $PERSONA_CREDENTIAL" -H "x-persona-external-user-id: user_123"

Response

`MemoryFile`

Mirrors memory.service.js's _toFileDto — the wire shape for one memory file.

Source: types/memory.ts:2

Interface

Field	Type	Description
`scope`	`"user" \| "agent"`	— _ `types/memory.ts:3`_
`agentId?`	`string`	Set when `scope` is `'agent'`. — _ `types/memory.ts:5`_
`path`	`string`	— _ `types/memory.ts:6`_
`content`	`string`	— _ `types/memory.ts:7`_
`mimeType`	`string`	— _ `types/memory.ts:8`_
`createdAt`	`string`	— _ `types/memory.ts:9`_
`updatedAt`	`string`	— _ `types/memory.ts:10`_

`MemoryAgentGroup`

One agent's group of agent-scoped memory files, as returned by memory.list().

Source: types/memory.ts:14

Interface

Field	Type	Description
`agentId`	`string`	— _ `types/memory.ts:15`_
`agentName`	`string \| null`	`null` if the Agent no longer exists. — _ `types/memory.ts:17`_
`files`	`MemoryFile[]`	— _ `types/memory.ts:18`_

`MemoryListResult`

GET /api/v1/developer/memory — every memory file for the asserted external user.

Source: types/memory.ts:22

Interface

Field	Type	Description
`userFiles`	`MemoryFile[]`	— _ `types/memory.ts:23`_
`agentMemories`	`MemoryAgentGroup[]`	— _ `types/memory.ts:24`_

`MemoryFileScopeParams`

Source: types/memory.ts:27

Interface

`GetMemoryFileParams`

Source: types/memory.ts:34

Interface

`WriteMemoryFileInput`

Source: types/memory.ts:38

Interface

Field	Type	Description
`scope?`	`"user" \| "agent"`	— _ `types/memory.ts:29`_
`agentId?`	`string`	Required when `scope` is `'agent'`. — _ `types/memory.ts:31`_
`path`	`string`	— _ `types/memory.ts:39`_
`content`	`string`	— _ `types/memory.ts:40`_

`DeleteMemoryFileParams`

Source: types/memory.ts:43

Interface

mcp — @personaai/sdk

providers — @personaai/sdk