Skip to main content
POST
Create AI Config variation

Authorizations

Authorization
string
header
required

Path Parameters

projectKey
string
required
configKey
string
required

Body

application/json

AI Config variation object to create

key
string
required
name
string
required
comment
string

Human-readable description of this variation

description
string

Returns the description for the agent. This is only returned for agent variations.

instructions
string

Returns the instructions for the agent. This is only returned for agent variations.

messages
object[]
model
object
modelConfigKey
string
modelConfigVersion
integer

The exact model config version to set this variation to. Requires modelConfigKey to be set, and the version must exist for that model config. When omitted, the variation records the model config's current (latest) version.

Required range: x >= 1
outputFormat
object

JSON Schema defining the structured output format for the variation.

tools
object[]

List of tools to use for this variation. The latest version of the tool will be used.

toolKeys
string[]

List of tool keys to use for this variation. The latest version of the tool will be used.

skills
object[]

List of agent skills to attach to this variation.

judgeConfiguration
object
Example:

Response

AI Config variation created

key
string
required
_id
string
required
model
object
required
name
string
required
createdAt
integer<int64>
required
version
integer
required
Example:
color
string
comment
string
description
string

Returns the description for the agent. This is only returned for agent variations.

instructions
string

Returns the instructions for the agent. This is only returned for agent variations.

messages
object[]
modelConfigKey
string
modelConfigVersion
integer

The version of the model config that this variation is pinned to, when it references a custom model config. Absent when the variation does not reference a model config, when the variation is not pinned to a specific version, or when custom model config versioning is not enabled for the project.

outputFormat
object

JSON Schema defining the structured output format for the variation.

state
string
_archivedAt
integer<int64>
_publishedAt
integer<int64>
tools
object[]
skills
object[]
judgeConfiguration
object
Example:
judgingConfigKeys
string[]