List memory layers

cadenya memory-layers list

{
  "items": [
    {
      "metadata": {
        "id": "<string>",
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
        "name": "<string>",
        "externalId": "<string>",
        "labels": {},
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z"
      },
      "spec": {
        "type": "MEMORY_LAYER_TYPE_UNSPECIFIED",
        "systemManaged": true,
        "agentId": "agent_01HXKD2E5NQM3T9AYWCFMGWT9Y",
        "episodicKey": "<string>",
        "description": "<string>",
        "expiresAt": "2023-11-07T05:31:56Z",
        "tenantId": "tenant_01HXKD2E5NQM3T9AYWCF133E3Q",
        "subjectId": "subj_01HXKD2E5NQM3T9AYWCFQAZGFV"
      },
      "info": {
        "entryCount": 123,
        "createdBy": {
          "metadata": {
            "id": "<string>",
            "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
            "name": "<string>",
            "externalId": "<string>",
            "labels": {},
            "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
            "createdAt": "2023-11-07T05:31:56Z"
          },
          "spec": {
            "email": "<string>",
            "name": "<string>",
            "type": "PROFILE_TYPE_UNSPECIFIED"
          }
        },
        "lastUsedAt": "2023-11-07T05:31:56Z",
        "agent": {
          "id": "<string>",
          "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
          "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
          "name": "<string>",
          "externalId": "<string>",
          "labels": {},
          "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z"
        },
        "tenant": {
          "id": "tenant_01HXKD2E5NQM3T9AYWCF133E3Q",
          "externalId": "acme-corp",
          "name": "Acme Corp"
        },
        "subject": {
          "id": "subj_01HXKD2E5NQM3T9AYWCFQAZGFV",
          "externalId": "customer-user-42",
          "name": "Jane Doe"
        }
      }
    }
  ],
  "pagination": {
    "nextCursor": "<string>"
  }
}

{
  "code": 123,
  "message": "<string>",
  "details": [
    {
      "@type": "type.googleapis.com/google.rpc.ErrorInfo",
      "domain": "api.cadenya.com",
      "reason": "TOKEN_EXPIRED",
      "metadata": {}
    }
  ]
}

GET

workspaces

{workspaceId}

memory_layers

cadenya memory-layers list

{
  "items": [
    {
      "metadata": {
        "id": "<string>",
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
        "name": "<string>",
        "externalId": "<string>",
        "labels": {},
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z"
      },
      "spec": {
        "type": "MEMORY_LAYER_TYPE_UNSPECIFIED",
        "systemManaged": true,
        "agentId": "agent_01HXKD2E5NQM3T9AYWCFMGWT9Y",
        "episodicKey": "<string>",
        "description": "<string>",
        "expiresAt": "2023-11-07T05:31:56Z",
        "tenantId": "tenant_01HXKD2E5NQM3T9AYWCF133E3Q",
        "subjectId": "subj_01HXKD2E5NQM3T9AYWCFQAZGFV"
      },
      "info": {
        "entryCount": 123,
        "createdBy": {
          "metadata": {
            "id": "<string>",
            "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
            "name": "<string>",
            "externalId": "<string>",
            "labels": {},
            "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
            "createdAt": "2023-11-07T05:31:56Z"
          },
          "spec": {
            "email": "<string>",
            "name": "<string>",
            "type": "PROFILE_TYPE_UNSPECIFIED"
          }
        },
        "lastUsedAt": "2023-11-07T05:31:56Z",
        "agent": {
          "id": "<string>",
          "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
          "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
          "name": "<string>",
          "externalId": "<string>",
          "labels": {},
          "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z"
        },
        "tenant": {
          "id": "tenant_01HXKD2E5NQM3T9AYWCF133E3Q",
          "externalId": "acme-corp",
          "name": "Acme Corp"
        },
        "subject": {
          "id": "subj_01HXKD2E5NQM3T9AYWCFQAZGFV",
          "externalId": "customer-user-42",
          "name": "Jane Doe"
        }
      }
    }
  ],
  "pagination": {
    "nextCursor": "<string>"
  }
}

{
  "code": 123,
  "message": "<string>",
  "details": [
    {
      "@type": "type.googleapis.com/google.rpc.ErrorInfo",
      "domain": "api.cadenya.com",
      "reason": "TOKEN_EXPIRED",
      "metadata": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspaceId

string

required

Example:

"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"

Query Parameters

limit

integer<int32>

Maximum number of results to return

cursor

string

Pagination cursor from previous response

prefix

string

Filter expression (query param: prefix)

query

string

Free-form search query

type

enum<string>

Filter by layer type

Available options:

MEMORY_LAYER_TYPE_UNSPECIFIED,

MEMORY_LAYER_TYPE_EPISODIC,

MEMORY_LAYER_TYPE_SKILLS

agentId

string

Filter to episodic layers belonging to this agent.

Example:

"agent_01HXKD2E5NQM3T9AYWCFMGWT9Y"

episodicKeyPrefix

string

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.

labels

string

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).

tenantId

string

Filter to episodic layers scoped to a tenant. Accepts the canonical tenant_… form or the external_id:<value> form.

subjectId

string

Filter to episodic layers scoped to a subject. Accepts the canonical subj_… form or the external_id:<value> form; the external_id form is scoped within a tenant and requires tenant_id to also be set.

sortOrder

string

Sort order for results (asc or desc by creation time)

includeInfo

boolean

When set to true you may use more of your alloted API rate-limit

Response

items

object[]

required

Show child attributes

pagination

object

Page carries cursor-based pagination state. There is no total: the cursor walks the result set without ever counting it, and a count would cost a second query on every list.

Show child attributes

Overview

Tool Sets

Tools

Tool Set Secrets

Agents

Agent Variations

Agent Schedules

Objectives

Widgets

Widget Sessions

Tenants

Memory Layers

Memory Entries

Models

Uploads

Workspaces

Workspace Secrets

Workspace Admin

Accounts

API Keys

AI Provider Keys

Webhook Events

List memory layers

Authorizations

Path Parameters

Query Parameters

Response