Skip to main content

Remove Experiment

Endpoint​

/i/ab-testing/remove-experiment

Ⓔ Enterprise Only
This API is available exclusively in Countly Enterprise.

Overview​

Delete an experiment and its associated data, including variant cohorts.

Authentication​

Authentication Methods:

  • API Key (parameter): api_key=YOUR_API_KEY
  • Auth Token (parameter): auth_token=YOUR_AUTH_TOKEN
  • Auth Token (header): countly-token: YOUR_AUTH_TOKEN

Permissions​

  • Delete (ab_testing feature)

Request Parameters​

ParameterTypeRequiredDescription
api_keyStringYes (or use auth_token)API key for authentication
auth_tokenStringYes (or use api_key)Auth token for authentication
app_idStringYesApplication identifier
experiment_idStringYesExperiment ObjectId to remove

Response​

Success Response​

{
  "result": "Success"
}

Response Fields​

FieldTypeDescription
resultStringResult message

Error Responses​

  • HTTP 400 - Missing app_id:
{
  "result": "Missing app_id"
}
  • HTTP 400 - Missing experiment_id:
{
  "result": "Missing experiment_id"
}
  • HTTP 500 - Experiment doesn't exist:
{
  "result": "The experiment does not exist."
}
  • HTTP 500 - Failed to remove:
{
  "result": "Failed to remove experiment"
}

Behavior/Processing​

  • Deletes the experiment document from countly_out.ab_testing_experiments{appId}.
  • Deletes cohorts created for variants and removes cohort data.
  • Attempts to remove experiment assignments from countly.app_users{appId}.

Database Collections​

CollectionUsed forData touched by this endpoint
countly_out.ab_testing_experiments{appId}Primary:Removes experiment document.
countly.cohortsRelated:Deletes all cohorts associated with experiment variants.
countly.cohortdataRelated:Removes cohort membership data.
countly.app_users{appId}Related:Removes experiment assignments from user documents.

Examples​

Example 1: Remove an Experiment​

Request:

curl "https://your-server.com/i/ab-testing/remove-experiment" \
  -d "api_key=YOUR_API_KEY" \
  -d "app_id=YOUR_APP_ID" \
  -d "experiment_id=5f9c8a3b4d1e2a001f3b4567"

Ⓔ Enterprise​

This feature is part of Countly Enterprise.

Get Access:

Already a Customer? Use support portal if you have any questions

Last Updated​

2026-02-16