List variations

Lists all variations for an agent

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

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

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

Changed in 13 of the 57 revisions of this API.3159

Jul 19, 20263ecc1debabfa241See the full diff
- ▲
  added VariationAssignment_Tool VariationAssignment_ToolSet VariationAssignment_Agent to the items/items/info/allOf[AgentVariationInfo]/assignments/items/ response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  the items/items/info/allOf[AgentVariationInfo]/assignments/items/ response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ●
  removed the optional property items/items/info/allOf[AgentVariationInfo]/assignments/items/agent from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/items/info/allOf[AgentVariationInfo]/assignments/items/id from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/items/info/allOf[AgentVariationInfo]/assignments/items/tool from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/items/info/allOf[AgentVariationInfo]/assignments/items/toolSet from the response with the 200 status
  response-optional-property-removed
- ○
  added discriminator to items/items/info/allOf[AgentVariationInfo]/assignments/items/ response property for the response status 200
  response-property-discriminator-added
Jul 8, 20267a9fa80ead321See the full diff
- ●
  removed the optional property items/items/spec/allOf[AgentVariationSpec]/progressiveDiscovery/allOf[AgentVariationSpec_ProgressiveDiscovery]/rerankThreshold from the response with the 200 status
  response-optional-property-removed
Jul 8, 2026a99a473ee3ad1See the full diff
- ●
  removed the optional property pagination/total from the response with the 200 status
  response-optional-property-removed
Jul 8, 2026631a0b9462a91See the full diff
- ●
  removed the optional property items/items/spec/allOf[AgentVariationSpec]/weight from the response with the 200 status
  response-optional-property-removed
Jul 8, 2026e72f368ddab71See the full diff
- ○
  added the new optional query request parameter labels
  new-optional-request-parameter
Jul 8, 20261b547d16bc3f1See the full diff
- ▲
  the items/items/spec/allOf[AgentVariationSpec]/constraints/allOf[AgentVariationSpec_Constraints]/inactivityTimeout response's property type/format changed from integer/ to string/ for status 200
  response-property-type-changed
Jul 7, 202663210c2f71dc1See the full diff
- ○
  added the optional property items/items/spec/allOf[AgentVariationSpec]/constraints/allOf[AgentVariationSpec_Constraints]/inactivityTimeout to the response with the 200 status
  response-optional-property-added
Jul 4, 202609ccecfe3ece11See the full diff
- ●
  removed the optional property items/items/spec/allOf[AgentVariationSpec]/userMessageTemplate from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property items/items/spec/allOf[AgentVariationSpec]/firstUserMessageTemplate to the response with the 200 status
  response-optional-property-added
Jul 2, 202606e0e37c149931See the full diff
- ●
  deleted the query request parameter bundleKey
  request-parameter-removed
- ●
  removed the optional property items/items/info/allOf[AgentVariationInfo]/model/allOf[ResourceMetadata]/bundleKey from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/items/metadata/allOf[ResourceMetadata]/bundleKey from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property items/items/info/allOf[AgentVariationInfo]/createdBy/metadata/createdAt to the response with the 200 status
  response-optional-property-added
This revision also has 27 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 11, 202608fde3ae3e372See the full diff
- ●
  removed the optional property items/items/spec/allOf[AgentVariationSpec]/enableEpisodicMemory from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/items/spec/allOf[AgentVariationSpec]/episodicMemoryTtl from the response with the 200 status
  response-optional-property-removed

Full history (13 revisions)