Promote a completed shadow experiment (apply or graduate to split)

curl --request POST \
  --url https://api.verlon.ai/v1/ab-tests/:id/promote \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "initialSplitPercent": 5
}
'

{
  "error": "<string>",
  "message": "<string>",
  "details": "<unknown>"
}

Experiments

Promote a completed shadow experiment (apply or graduate to split)

Use when: caller has a finished shadow experiment and wants to either apply its winner directly to the gate (apply) or graduate it to a live split experiment for further validation (split)

Two actions: apply directly writes the winning config back to the gate (same effect as /v1/ab-tests/:id/apply); split graduates the shadow test to a live split experiment with the current gate config as variant A and the shadow winner as variant B. Split percentage is clamped against the gate’s max_experiment_split_percent safety bound. The newly-created split experiment auto-rolls back if guardrails trip.

POST

ab-tests

:id

promote

Promote a completed shadow experiment (apply or graduate to split)

curl --request POST \
  --url https://api.verlon.ai/v1/ab-tests/:id/promote \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "initialSplitPercent": 5
}
'

{
  "error": "<string>",
  "message": "<string>",
  "details": "<unknown>"
}

Authorizations

Authorization

string

header

required

Layer API key (prefixed sk-). Generated from the dashboard under Settings → API Keys, or via layer key create in the CLI.

Body

application/json

action

enum<string>

required

Available options:

apply,

split

initialSplitPercent

number

default:5

Response

Promotion applied — for apply returns {success, action, gateId}; for split returns the new experiment id + clamped split percent.

Get the multi-aggregate shadow-analysis breakdown Check whether an experiment is eligible for promotion

Documentation Index

Authorizations

Body

Response