Get A/B test
Get one A/B test with its configuration, status, and run counts.
Required permission: ab_tests.view. With judges.view, the response also includes judge names.
Request
- Base URL: https://api.connic.co
- URL: https://api.connic.co/v1/projects/{project_id}/ab-tests/{test_id}
- Auth: HTTP bearer
Path parameters
ID of the project the API key belongs to.
A/B test ID from GET /ab-tests.
Response
Successful Response
Project the test belongs to.
Environment the test runs in.
Base (control) agent.
Variant suffix.
Variant agent name, {agent_name}-test-{test_name}.
Percentage of the agent's traffic routed to the variant.
A/B test state: draft until started, running while routing traffic, paused, concluded, or failed when the variant is missing from the active deployment. rolled_back is no longer set.
exploratory compares descriptive metrics; confidence follows a locked statistical plan with planned decision looks.
Completed runs needed in each group before the comparison reports enough data.
Whether the failure guardrail is on.
Variant failure rate (0 to 1) above which the failure guardrail pauses the test.
Number of most recent finished variant runs the failure guardrail evaluates.
Whether the quality guardrail is on.
Judge for the quality guardrail. null when unset or without judges.view.
Lowest acceptable average normalized score (0 to 1) for the variant.
Number of most recent evaluated variant runs the quality guardrail averages.
Evaluations needed before the quality guardrail can act.
Manually chosen winner of an exploratory test. null when none.
Test verdict: collecting before the first planned look, continue after a look without a decision, variant_recommended or control_recommended when a boundary was crossed, inconclusive, invalid_srm after a sample-ratio mismatch, or safety_stopped when the test was stopped automatically.
Explanation of recommendation.
Why the test was stopped automatically. Cleared when the test resumes.
Why a test stopped: manual, a guardrail (failure_guardrail, quality_guardrail), a planned look (efficacy when a boundary was crossed, futility when the final look was inconclusive), srm (sample-ratio mismatch), analysis_error (metric judge evaluations failed), or variant_unavailable.
Details for stop_reason, such as the observed failure rate and window for failure_guardrail.
When the test first started. null for drafts.
When the test was last paused or stopped. Cleared when it resumes.
When the test was concluded.
Completed control runs. Confidence tests exclude forced runs.
Completed variant runs. Confidence tests exclude forced runs.
Always null. Cost statistics are returned by the comparison endpoint.
Always null. Cost statistics are returned by the comparison endpoint.
Average duration of completed control runs, in milliseconds.
Average duration of completed variant runs, in milliseconds.
Average normalized judge score (0 to 1) of control runs, from the metric or quality judge when set. null without evaluations.
Average normalized judge score (0 to 1) of variant runs, from the metric or quality judge when set. null without evaluations.
Changes
No recorded changes to this operation across all 2 revisions of this API.