stop_experiment
Stop an experiment before conclusion — irreversible: arms are paused, the source entity is restored, and the stop is recorded in the decision log (and on any linked strategy initiative).
Requires a user-bound credential (OAuth login or a personal API key). Organization API keys get error_type: "user_credential_required".
Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
experiment_id | string | yes | The experiment id |
detail | string | no | Human note recorded as the stop reason |
Returns#
json
{
"success": true,
"experiment": { "id": "exp_abc123", "status": "stopped", "stopped_reason": "user" },
"source": "adlyse.experiments@v1"
}Errors#
error_type | When |
|---|---|
auth_error | Missing / invalid credential |
user_credential_required | Called with an organization API key |
not_found | No experiment with that id in your org |
invalid_state | The experiment already completed/stopped/failed |