AgentVariationService
Agent Variations
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
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"
}
]
}
}
]
}