Skip to main content
POST
Stop Experiment

Overview

Completes an active experiment with completed_reason: "manual". Eligible calls immediately return to the baseline pin, and the final variant_calls_routed count is frozen on the record. Completion is permanent: a stopped experiment cannot be resumed, so use Create Experiment to test again. Returns 409 CONFLICT if the experiment is already completed for any reason. Experiments are available on enterprise plans. Other organizations get 403 ENTERPRISE_REQUIRED. This endpoint also requires an admin, owner, operator, or prompter role, and takes no body.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
The agent’s unique identifier.
string
required
The experiment’s unique identifier. Must be a valid UUID; returns 400 BAD_REQUEST otherwise.

Response

object
The stopped experiment.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt