AgentVariationService
Agent Variations

List variations

Changed on

Lists all variations for an agent

get/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.

Query parameters

limitinteger

Maximum number of results to return

cursorstring

Pagination cursor from previous response

sortOrderstring

Sort order for results (asc or desc by creation time)

includeInfoboolean

When true, the info field on each returned variation is populated. Requests with this flag count more against your rate limit.

labelsstring

Filters by metadata labels. Comma-separated key=value pairs, e.g. "env=prod,team=ai". A resource matches only if every pair matches exactly (AND semantics).

Response

OK

Example response

{
  "items": [
    {
      "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 optional property //////////// from the response with the status