AgentVariationService
Agent Variations

Create a new variation

Changed on

Creates a new variation for an agent

post/v1/workspaces/{workspaceId}/agents/{agentId}/variations

Request

  • Base URL
    https://api.cadenya.com
  • URL
    https://api.cadenya.com/v1/workspaces/{workspaceId}/agents/{agentId}/variations
  • Auth
    HTTP bearer

Path parameters

workspaceIdstring required
Example:workspace_01HXKD2E5NQM3T9AYWCF133E3Q

Workspace ID.

agentIdstring required
Example:agent_01HXKD2E5NQM3T9AYWCFMGWT9Y

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

Request body

workspaceIdstring

Workspace ID.

agentIdstring

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

Example request

{
  "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
  "agentId": "agent_01HXKD2E5NQM3T9AYWCFMGWT9Y",
  "spec": {
    "modelConfig": {
      "modelId": "claude/opus-4.6"
    }
  }
}

Response

OK

Example response

{
  "metadata": {
    "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
    "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
    "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
  },
  "spec": {
    "modelConfig": {
      "modelId": "claude/opus-4.6"
    }
  },
  "info": {
    "createdBy": {
      "metadata": {
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
      }
    },
    "model": {
      "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
      "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
      "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
    },
    "assignments": [
      {
        "id": "avt_01HXKD2E5NQM3T9AYWCFJE6K89"
      }
    ],
    "memoryLayerAssignments": [
      {
        "id": "avml_01HXKD2E5NQM3T9AYWCFX8AF59"
      }
    ]
  }
}

Changes

  • 3ecc1debabfaRevision changes
    • breaking

      added to the ////// response property oneOf list for the response status

    • breaking

      the ////// response's property type changed from object to no type for status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • info

      added discriminator to ////// response property for the response status

  • 7a9fa80ead32Revision changes
    • warning

      removed the request property //////

    • warning

      removed the optional property ////////// from the response with the status