Attach a memory layer to a variation

cadenya agents variations add-memory-layer agent_123 variation_123 \
  --memory-layer-id sample

{
  "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": {
    "systemPromptTemplate": "<string>",
    "progressiveDiscovery": {
      "maxTools": 123,
      "hints": [
        "<string>"
      ]
    },
    "constraints": {
      "maxToolCalls": 123,
      "maxSubObjectives": 123,
      "inactivityTimeout": "<string>"
    },
    "description": "<string>",
    "modelConfig": {
      "modelId": "claude/opus-4.6",
      "temperature": 123,
      "topP": 123,
      "topK": 123,
      "stopSequences": [
        "<string>"
      ],
      "maxOutputTokens": 123,
      "reasoningEffort": "REASONING_EFFORT_UNSPECIFIED",
      "cachingEnabled": true,
      "streamingEnabled": true
    },
    "compactionConfig": {
      "triggerThreshold": 123,
      "summarization": {
        "instructions": "<string>"
      },
      "toolResultClearing": {
        "preserveRecentResults": 123
      }
    },
    "firstUserMessageTemplate": "<string>",
    "assignments": [
      {
        "type": "toolId",
        "toolId": "<string>"
      }
    ],
    "memoryLayerAssignments": [
      {
        "memoryLayerId": "memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH",
        "position": 123
      }
    ]
  },
  "info": {
    "toolCount": 123,
    "toolSetCount": 123,
    "subAgentCount": 123,
    "score": 123,
    "feedbackCount": 123,
    "memoryLayerCount": 123,
    "effectiveToolCount": 123,
    "assignmentMetadata": {},
    "agentPoolCount": 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"
      }
    },
    "model": {
      "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"
    }
  }
}

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

POST

workspaces

{workspaceId}

agents

{agentId}

variations

{variationId}

:addMemoryLayer

cadenya agents variations add-memory-layer agent_123 variation_123 \
  --memory-layer-id sample

{
  "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": {
    "systemPromptTemplate": "<string>",
    "progressiveDiscovery": {
      "maxTools": 123,
      "hints": [
        "<string>"
      ]
    },
    "constraints": {
      "maxToolCalls": 123,
      "maxSubObjectives": 123,
      "inactivityTimeout": "<string>"
    },
    "description": "<string>",
    "modelConfig": {
      "modelId": "claude/opus-4.6",
      "temperature": 123,
      "topP": 123,
      "topK": 123,
      "stopSequences": [
        "<string>"
      ],
      "maxOutputTokens": 123,
      "reasoningEffort": "REASONING_EFFORT_UNSPECIFIED",
      "cachingEnabled": true,
      "streamingEnabled": true
    },
    "compactionConfig": {
      "triggerThreshold": 123,
      "summarization": {
        "instructions": "<string>"
      },
      "toolResultClearing": {
        "preserveRecentResults": 123
      }
    },
    "firstUserMessageTemplate": "<string>",
    "assignments": [
      {
        "type": "toolId",
        "toolId": "<string>"
      }
    ],
    "memoryLayerAssignments": [
      {
        "memoryLayerId": "memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH",
        "position": 123
      }
    ]
  },
  "info": {
    "toolCount": 123,
    "toolSetCount": 123,
    "subAgentCount": 123,
    "score": 123,
    "feedbackCount": 123,
    "memoryLayerCount": 123,
    "effectiveToolCount": 123,
    "assignmentMetadata": {},
    "agentPoolCount": 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"
      }
    },
    "model": {
      "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"
    }
  }
}

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

Workspace ID.

Example:

"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"

agentId

string

required

Agent ID. Accepts the canonical agent_… form or the external_id:<value> form.

Example:

"agent_01HXKD2E5NQM3T9AYWCFMGWT9Y"

variationId

string

required

Variation ID. Accepts the canonical agentvar_… form or the external_id:<value> form.

Example:

"agentvar_01HXKD2E5NQM3T9AYWCF32BSPP"

Body

application/json

Attach a memory layer to a variation. Use UpdateAgentVariationMemoryLayer or replace the spec list to reposition an existing layer. Rejected when:

the layer is already assigned, regardless of position (AlreadyExists)
the layer is system-managed (FailedPrecondition)
the variation is already at the 10-assignment cap (FailedPrecondition)
the position is already in use on this variation (InvalidArgument)

memoryLayerId

string

required

Layer to attach. Accepts the canonical memlyr_… form or the external_id:<value> form.

Minimum string length: 1

Example:

"memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH"

position

integer<int32>

Position in the baseline cascade (lower = more specific). If omitted, the server appends at the most general end (max existing position + 1).

Response

AgentVariation resource

metadata

object

required

Resource metadata

Show child attributes

spec

object

required

Variation specification

Show child attributes

info

object

required

Read-only summary information

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

Attach a memory layer to a variation

Authorizations

Path Parameters

Body

Response