Create a new variation

Creates a new variation for an agent

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

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

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

Changed in 11 of the 57 revisions of this API.42012

Jul 19, 20263ecc1debabfa241See the full diff
- ▲
  added VariationAssignment_Tool VariationAssignment_ToolSet VariationAssignment_Agent to the info/allOf[AgentVariationInfo]/assignments/items/ response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  the 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 info/allOf[AgentVariationInfo]/assignments/items/agent from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property info/allOf[AgentVariationInfo]/assignments/items/id from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property info/allOf[AgentVariationInfo]/assignments/items/tool from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property info/allOf[AgentVariationInfo]/assignments/items/toolSet from the response with the 200 status
  response-optional-property-removed
- ○
  added discriminator to info/allOf[AgentVariationInfo]/assignments/items/ response property for the response status 200
  response-property-discriminator-added
Jul 8, 20267a9fa80ead322See the full diff
- ●
  removed the request property spec/progressiveDiscovery/allOf[AgentVariationSpec_ProgressiveDiscovery]/rerankThreshold
  request-property-removed
- ●
  removed the optional property spec/allOf[AgentVariationSpec]/progressiveDiscovery/allOf[AgentVariationSpec_ProgressiveDiscovery]/rerankThreshold from the response with the 200 status
  response-optional-property-removed
Jul 8, 2026631a0b9462a92See the full diff
- ●
  removed the request property spec/weight
  request-property-removed
- ●
  removed the optional property spec/allOf[AgentVariationSpec]/weight from the response with the 200 status
  response-optional-property-removed
Jul 8, 20261b547d16bc3f2See the full diff
- ▲
  the spec/constraints/allOf[AgentVariationSpec_Constraints]/inactivityTimeout request property type/format changed from integer/ to string/
  request-property-type-changed
- ▲
  the 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, 202663210c2f71dc2See the full diff
- ○
  added the new optional request property spec/constraints/allOf[AgentVariationSpec_Constraints]/inactivityTimeout
  new-optional-request-property
- ○
  added the optional property spec/allOf[AgentVariationSpec]/constraints/allOf[AgentVariationSpec_Constraints]/inactivityTimeout to the response with the 200 status
  response-optional-property-added
Jul 4, 202609ccecfe3ece22See the full diff
- ●
  removed the request property spec/userMessageTemplate
  request-property-removed
- ●
  removed the optional property spec/allOf[AgentVariationSpec]/userMessageTemplate from the response with the 200 status
  response-optional-property-removed
- ○
  added the new optional request property spec/firstUserMessageTemplate
  new-optional-request-property
- ○
  added the optional property spec/allOf[AgentVariationSpec]/firstUserMessageTemplate to the response with the 200 status
  response-optional-property-added
Jul 2, 202606e0e37c149931See the full diff
- ●
  removed the request property metadata/bundleKey
  request-property-removed
- ●
  removed the optional property info/allOf[AgentVariationInfo]/model/allOf[ResourceMetadata]/bundleKey from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property metadata/allOf[ResourceMetadata]/bundleKey from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property 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, 202608fde3ae3e374See the full diff
- ●
  removed the request property spec/enableEpisodicMemory
  request-property-removed
- ●
  removed the request property spec/episodicMemoryTtl
  request-property-removed
- ●
  removed the optional property spec/allOf[AgentVariationSpec]/enableEpisodicMemory from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property spec/allOf[AgentVariationSpec]/episodicMemoryTtl from the response with the 200 status
  response-optional-property-removed
Jun 10, 2026d2d65c2665bd24See the full diff
- ●
  removed the request property spec/prompt
  request-property-removed
- ●
  removed the optional property spec/allOf[AgentVariationSpec]/prompt from the response with the 200 status
  response-optional-property-removed
- ○
  added the new optional request property spec/systemPromptTemplate
  new-optional-request-property
- ○
  added the new optional request property spec/userMessageTemplate
  new-optional-request-property
- ○
  added the optional property spec/allOf[AgentVariationSpec]/systemPromptTemplate to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property spec/allOf[AgentVariationSpec]/userMessageTemplate to the response with the 200 status
  response-optional-property-added
Jun 9, 202613d98d37dd962See the full diff
- ○
  added the optional property info/allOf[AgentVariationInfo]/model/allOf[ResourceMetadata]/updatedAt to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property metadata/allOf[ResourceMetadata]/updatedAt to the response with the 200 status
  response-optional-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history (11 revisions)