MemoryService
Memory Layers

List memory layers

Changed on

Lists all memory layers in the workspace

get/v1/workspaces/{workspaceId}/memory_layers

Request

  • Base URL
    https://api.cadenya.com
  • URL
    https://api.cadenya.com/v1/workspaces/{workspaceId}/memory_layers
  • Auth
    HTTP bearer

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"
        }
      }
    }
  ]
}

Changes