Check whether an experiment is eligible for promotion

curl --request GET \
  --url https://api.verlon.ai/v1/ab-tests/:id/promotion-eligibility \
  --header 'Authorization: Bearer <token>'

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

Experiments

Check whether an experiment is eligible for promotion

Use when: caller wants to know whether an experiment meets the criteria to be promoted (sample size, guardrail status, sequential-test verdict) before attempting /promote

Returns a structured eligibility decision: whether the experiment can be promoted, which checks passed, which failed (e.g. insufficient samples, guardrail violations, no winner declared), and the threshold values used. Drives the ‘Promote’ button state on the experiment Results tab and lets Einstein know whether to recommend promotion. Threshold overrides may be set per-experiment via promotion_thresholds.

GET

ab-tests

:id

promotion-eligibility

Check whether an experiment is eligible for promotion

curl --request GET \
  --url https://api.verlon.ai/v1/ab-tests/:id/promotion-eligibility \
  --header 'Authorization: Bearer <token>'

{
  "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.

Response

Eligibility decision payload — eligible: boolean + per-check details.

Promote a completed shadow experiment (apply or graduate to split)Generic completion endpoint (v2 — legacy)

Documentation Index

Authorizations

Response