Create a new memory layer

cadenya memory-layers create \
  --name sample \
  --type episodic

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

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

POST

workspaces

{workspaceId}

memory_layers

cadenya memory-layers create \
  --name sample \
  --type episodic

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

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

Body

application/json

metadata

object

required

CreateResourceMetadata contains the user-provided fields for creating a workspace-scoped resource. Read-only fields (id, account_id, workspace_id, profile_id, created_at) are excluded since they are set by the server.

Show child attributes

spec

object

required

Show child attributes

tenant

object

Optional tenant assertion: the customer's org or company identifier for the end users this layer serves. Upserts the tenant record, the same way as on CreateObjectiveRequest, so a layer can be prepared for a tenant before any of its objectives exist.

Show child attributes

subject

object

Optional subject assertion: the person within the tenant this layer serves. Requires tenant.

Show child attributes

Response

MemoryLayer is a named container of memory entries that can be composed into an objective's memory cascade. Layers are workspace-scoped resources. The layer type controls how its entries participate in the agent loop — see MemoryLayerType for details.

See "Memory cascade composition" above for how layers compose at lookup time.

metadata

object

required

Standard metadata for persistent, named resources (e.g., agents, tools, prompts)

Show child attributes

spec

object

required

Show child attributes

info

object

required

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

Create a new memory layer

Authorizations

Path Parameters

Body

Response