MemoryService
Memory Layers
List memory layers
Lists all memory layers in the workspace
get/v1/workspaces/{workspaceId}/memory_layers
Path parameters
workspaceIdstring required
Example:workspace_01HXKD2E5NQM3T9AYWCF133E3Q
Query parameters
limitinteger
Maximum number of results to return
cursorstring
Pagination cursor from previous response
prefixstring
Filter expression (query param: prefix)
querystring
Free-form search query
type'MEMORY_LAYER_TYPE_UNSPECIFIED' | 'MEMORY_LAYER_TYPE_EPISODIC' | 'MEMORY_LAYER_TYPE_SKILLS' enum
Filter by layer type
agentIdstring
Example:agent_01HXKD2E5NQM3T9AYWCFMGWT9Y
Filter to episodic layers belonging to this agent.
episodicKeyPrefixstring
Filter to episodic layers whose episodic key starts with this prefix (e.g. "customer/" matches "customer/42" and "customer/43"). Useful for namespaced keys, similar to a redis key scan.
labelsstring
Filters by metadata labels. Comma-separated key=value pairs, e.g. "env=prod,team=ai". A resource matches only if every pair matches exactly (AND semantics).
sortOrderstring
Sort order for results (asc or desc by creation time)
includeInfoboolean
When set to true you may use more of your alloted API rate-limit
Response
OK
Example response
{
"items": [
{
"metadata": {
"accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
"workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
"profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
},
"spec": {
"agentId": "agent_01HXKD2E5NQM3T9AYWCFMGWT9Y"
},
"info": {
"createdBy": {
"metadata": {
"accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
"profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
}
},
"agent": {
"accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
"workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
"profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
}
}
}
]
}