Update AI Config variation

For the complete documentation index, see llms.txt. For the full documentation snapshot, see llms-full.txt.

Edit an existing variation of an AI Config. This creates a new version of the variation.

The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields.

Here’s an example:

  {
    "messages": [
      {
        "role": "system",
        "content": "The new message"
      }
    ]
  }

PATCH /api/v2/projects/{projectKey}/ai-configs/{configKey}/variations/{variationKey}

Update AI Config variation

cURL

curl --request PATCH \
  --url https://app.launchdarkly.com/api/v2/projects/{projectKey}/ai-configs/{configKey}/variations/{variationKey} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "judgeConfiguration": {
    "judges": [
      {
        "samplingRate": 0.7061401,
        "judgeConfigKey": "judgeConfigKey"
      },
      {
        "samplingRate": 0.7061401,
        "judgeConfigKey": "judgeConfigKey"
      }
    ]
  },
  "instructions": "instructions",
  "toolKeys": [
    "toolKeys",
    "toolKeys"
  ],
  "name": "name",
  "description": "description",
  "messages": [
    {
      "role": "role",
      "content": "content"
    },
    {
      "role": "role",
      "content": "content"
    }
  ],
  "comment": "comment",
  "model": "{}",
  "published": true,
  "state": "state",
  "modelConfigKey": "modelConfigKey",
  "tools": [
    {
      "version": 0,
      "key": "key"
    },
    {
      "version": 0,
      "key": "key"
    }
  ]
}
'

200

{
  "judgeConfiguration": {
    "judges": [
      {
        "samplingRate": 0.7061401,
        "judgeConfigKey": "judgeConfigKey"
      },
      {
        "samplingRate": 0.7061401,
        "judgeConfigKey": "judgeConfigKey"
      }
    ]
  },
  "instructions": "instructions",
  "color": "color",
  "_links": {
    "parent": {
      "href": "href",
      "type": "type"
    }
  },
  "description": "description",
  "modelConfigKey": "modelConfigKey",
  "judgingConfigKeys": [
    "judgingConfigKeys",
    "judgingConfigKeys"
  ],
  "version": 1,
  "tools": [
    {
      "customParameters": {
        "key": ""
      },
      "version": 2,
      "key": "key"
    },
    {
      "customParameters": {
        "key": ""
      },
      "version": 2,
      "key": "key"
    }
  ],
  "createdAt": 6,
  "_publishedAt": 5,
  "_archivedAt": 5,
  "name": "name",
  "messages": [
    {
      "role": "role",
      "content": "content"
    },
    {
      "role": "role",
      "content": "content"
    }
  ],
  "comment": "comment",
  "model": "{}",
  "_id": "_id",
  "state": "state",
  "key": "key"
}

Authorizations

Authorization · string · header · required

Path Parameters

projectKey · string · required

configKey · string · required

variationKey · string · required

Body

application/json

AI Config variation object to update

comment · string

Human-readable description of what this patch changes

description · string

Description for agent when AI Config is in agent mode.

instructions · string

Instructions for agent when AI Config is in agent mode.

messages · object[]

Show child attributes

model · object

modelConfigKey · string

name · string

published · boolean

state · string

One of 'archived', 'published'

tools · object[]

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

Show child attributes

toolKeys · string[]

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

judgeConfiguration · object

Show child attributes

Example:

{
  "judges": [
    {
      "samplingRate": 0.7061401,
      "judgeConfigKey": "judgeConfigKey"
    },
    {
      "samplingRate": 0.7061401,
      "judgeConfigKey": "judgeConfigKey"
    }
  ]
}

Response

200

application/json

AI Config variation updated

key · string · required

_id · string · required

model · object · required

name · string · required

createdAt · integer<int64> · required

version · integer · required

_links · object

Show child attributes

Example:

{
  "parent": { "href": "href", "type": "type" }
}

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[]

Show child attributes

modelConfigKey · string

state · string

_archivedAt · integer<int64>

_publishedAt · integer<int64>

tools · object[]

Show child attributes

judgeConfiguration · object

Show child attributes

Example:

{
  "judges": [
    {
      "samplingRate": 0.7061401,
      "judgeConfigKey": "judgeConfigKey"
    },
    {
      "samplingRate": 0.7061401,
      "judgeConfigKey": "judgeConfigKey"
    }
  ]
}

judgingConfigKeys · string[]