Skip to main content
GET
JavaScript
The complete configuration of one variation: its prompt, model, assignments, and the score it has earned.

What one read gives you

spec is the configuration you set: systemPromptTemplate, firstUserMessageTemplate, modelConfig, description. info is everything computed around it, and it returns on every read, includeInfo is a no-op here as on the other variation reads. So this is the read for “show me everything about this one variation.” For a leaderboard across an agent’s variations, List variations returns the same shape for all of them and explains what score means and how to rank on it. Variations take an external ID like any resource, scoped to their agent, so pass the agentvar_... value or the external_id: form. A missing ID is a 404.

List variations

Every variation on the agent, and the score story in full.

Update a variation

Change the prompt or model, with the zero-value rule.

Add an assignment

What fills info.assignments.

Submit feedback

What moves info.score.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspaceId
string
required

Workspace ID.

Example:

"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"

agentId
string
required

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

Example:

"agent_01HXKD2E5NQM3T9AYWCFMGWT9Y"

id
string
required

Variation ID. Accepts the canonical agentvar_… form or the external_id:<value> form.

Example:

"agentvar_01HXKD2E5NQM3T9AYWCF32BSPP"

Response

OK

AgentVariation resource

metadata
object
required

Resource metadata

spec
object
required

Variation specification

info
object

Read-only summary information