Update Serving Rollout
PATCH
/v2/project/{project_key}/experiment/{test_id}/serving-rolloutChange the rollout percentage for an experiment that is already serving a winner. Updates traffic_allocation without changing which variant is served.
Path parameters
| Parameter | Description |
|---|---|
project_key | Your project's API key |
test_id | The numeric experiment ID |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
traffic_allocation | number | Yes | Rollout percentage 0–100 of eligible visitors who receive the winning variant. |
Example
curl -X PATCH "https://api-{region}.mida.so/v2/project/YOUR_PROJECT_KEY/experiment/1234/serving-rollout" \
-H "Authorization: Bearer YOUR_GENERATED_API_KEY" \
-H "Content-Type: application/json" \
-d '{"traffic_allocation": 50}'
Success response
{
"success": true,
"test_id": 1234,
"traffic_allocation": 50,
"is_serving": true,
"message": "Serving rollout percentage updated."
}
Error responses
| Status | Meaning |
|---|---|
400 | Missing or invalid traffic_allocation |
401 | Invalid or missing API key |
404 | Experiment not found |
409 | Experiment is not currently serving a winner |
Related
Initial serve: Serve Experiment Winner. Stop serving: Stop Experiment Serving.