Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Send your API key as Authorization: Bearer YOUR_API_KEY.

Headers

Idempotency-Key
string

Optional retry key. Reusing the same key returns the original result with idempotentReplay: true and a 200 instead of adding a second variant.

Required string length: 1 - 255

Path Parameters

id
string
required

Agent id of the Primary Variant. Every split operation is addressed through the primary, not through a secondary variant.

Minimum string length: 1

Body

application/json

Optional clone source.

Body is optional. Adding a variant re-levels the live arms, the new one included, to equal shares; excluded variants stay at 0. Send the retry key as the Idempotency-Key header.

sourceAgentId
string

Active variant to copy the new one from. Defaults to the Primary Variant.

Minimum string length: 1
Example:

"agent_1ffdb9717444d0e77346838911"

{key}
any

Response

An earlier request with this idempotency key already added the variant.

success
boolean
required
splitTest
object
required
idempotentReplay
boolean

Present only when an Idempotency-Key matched an earlier request. The split was not changed again and the status is 200 rather than 201.