Update a variation's memory layer assignment

cadenya agents variations update-memory-layer agent_123 variation_123 \
  --memory-layer-id sample \
  --position 1

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

:updateMemoryLayer

cadenya agents variations update-memory-layer agent_123 variation_123 \
  --memory-layer-id sample \
  --position 1

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

Update an existing memory layer assignment. Only position is mutable. A new position that collides with another assignment on the same variation is rejected with InvalidArgument. An unassigned layer returns NotFound.

memoryLayerId

string

required

Layer to reposition. Accepts memlyr_… or external_id:.

Minimum string length: 1

Example:

"memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH"

position

integer<int32>

required

New position. Only field currently updatable on an assignment.

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

Update a variation's memory layer assignment

Authorizations

Path Parameters

Body

Response