Skip to main content
PUT
/
api
/
ab-tests
/
{id}
Error
A valid request URL is required to generate request examples
{
  "_id": "<string>",
  "accountId": "<string>",
  "name": "<string>",
  "status": "draft",
  "variants": [
    {
      "agentConfigId": "<string>",
      "weight": 50.5
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "description": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer token using an API key (format: nl_live_* or nl_test_*).

Path Parameters

​
id
string
required

A/B test ID (MongoDB ObjectId)

Example:

"665a1b2c3d4e5f6a7b8c9d0e"

Body

application/json

Request body for updating an A/B test. All fields are optional; only provided fields will be updated. Variants can only be modified while the test is in draft status.

​
name
string

A/B test display name

​
description
string

Optional description of the test hypothesis

​
variants
object[]

Updated variant configuration (draft status only)

Minimum array length: 2

Response

A/B test updated successfully

An A/B test comparing multiple agent configurations.

​
_id
string
required

Unique A/B test identifier

​
accountId
string
required

Account that owns this A/B test

​
name
string
required

A/B test display name

​
status
enum<string>
required

Current test lifecycle status

Available options:
draft,
running,
paused,
completed
​
variants
object[]
required

Agent configuration variants being compared

Minimum array length: 2
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
description
string

Optional description of the test hypothesis