Skip to main content

Delete Experiment

DELETE/v2/project/{project_key}/experiment/{test_id}

Delete an experiment. It disappears from the Experiments list and, if it was running, stops being served to visitors.

Path parameters​

ParameterDescription
project_keyYour project's API key
test_idThe numeric experiment ID to delete

Example​

curl -X DELETE "https://api-{region}.mida.so/v2/project/YOUR_PROJECT_KEY/experiment/34762" \
  -H "Authorization: Bearer YOUR_GENERATED_API_KEY"

Success response​

{
  "success": true,
  "test_id": 34762,
  "test_name": "Homepage H1 - No-Devs Angle",
  "deleted": true,
  "was_live": false,
  "message": "Experiment deleted."
}

Response fields​

FieldDescription
test_nameWhat was deleted, so you can confirm you removed the right experiment
was_livetrue if the experiment was running. It has now stopped serving
messagePlain-language summary, differing for a live experiment

Notes​

  • Deleting a live experiment stops it being served. Read the experiment first if you are not certain of its status, and prefer Update Experiment Status to pause something you may want back shortly, or PATCH /v2/project/{project_key}/experiment/{test_id}/conclusion to record what a finished test taught you rather than discard it.
  • The delivery cache is cleared automatically when a live experiment is deleted, so visitors stop receiving it immediately rather than when the cache lapses.
  • An experiment that is already deleted, or belongs to another project, returns 404. Deleting twice is therefore safe but reports not-found the second time.
  • The experiment is removed from the Experiments list and from every API read. Its recorded results are no longer returned.