Create a new variation

cadenya agents variations create agent_123 \
  --name 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

cadenya agents variations create agent_123 \
  --name 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"

Body

application/json

Create agent variation request

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

AgentVariationSpec defines the complete operational configuration for a variation, including assignments. Reads always populate both assignment lists, even when include_info is false. Create and update validate and persist the configuration atomically: any invalid target or cascade rejects the entire request. Targets must belong to the variation's workspace and pass the same eligibility checks as the dedicated add methods.

Show child attributes

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

Create a new variation

Authorizations

Path Parameters

Body

Response