Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.abconvert.io/llms.txt

Use this file to discover all available pages before exploring further.

Preview — this page is an early draft. We’re still verifying the API reference against the current endpoints. Fields, response shapes, and examples may change before this section is marked stable. Follow PRO-1459 or ask in #abconvert-dev if you’re integrating against this today.
Deleting an experiment removes it from ABConvert and triggers cleanup of everything ABConvert created in your Shopify store on the experiment’s behalf. This includes duplicate product variants, metafields, and any injected scripts or functions tied to the experiment. Both delete endpoints are session endpoints and require Shopify authentication.
Deletion is permanent. All experiment configuration and analytics data are removed and cannot be recovered. If you want to preserve analytics history, export your data before deleting.

​
Delete any experiment

Deletes an experiment of any type — price, content, shipping, redirect, template, theme, or checkout. ABConvert determines what to clean up based on the experiment’s type. 
DELETE /api/experiments/:id

​
What gets cleaned up

When you delete an experiment, ABConvert:
  • Removes duplicate variants created for price experiments (v1 strategy).
  • Resets product prices for any variants that were modified.
  • Deletes metafields written to products or the store for this experiment.
  • Removes script tags associated with the experiment if no other active experiments depend on them.
  • Deregisters Shopify Functions for cart transform or delivery customization experiments.
  • Deletes all analytics records (views, add-to-carts, checkouts, orders) tied to the experiment.

​
Path parameters

​
id
string
required
The experiment’s _id value as returned by the list or get endpoints.

​
Example request

curl -X DELETE "https://app.abconvert.io/api/experiments/64a1f2b3c4d5e6f7a8b9c0d1" \
  -H "Authorization: Bearer <shopi...en>" \
  -H "Content-Type: application/json"

​
Response

"success"
On failure: 
{
  "status": "error",
  "message": "Experiment not found"
}

​
Delete a price experiment

An alternative delete endpoint specific to price experiments. Use this if you need to explicitly target a price experiment, particularly when troubleshooting cleanup issues with price variant duplicates. 
DELETE /api/price-experiments/:id

​
What gets cleaned up

In addition to the general cleanup described above, this endpoint specifically:
  • Archives or deletes duplicated variants created by the v1 (duplicate variant) price testing strategy.
  • Removes cart transform function configuration for v2 (cart transform) experiments.
  • Restores original prices on all product variants that were part of the experiment.

​
Path parameters

​
id
string
required
The price experiment’s _id value.

​
Example request

curl -X DELETE "https://app.abconvert.io/api/price-experiments/64a1f2b3c4d5e6f7a8b9c0d1" \
  -H "Authorization: Bearer <shopi...en>" \
  -H "Content-Type: application/json"

​
Response

"success"

​
Summary

Use caseMethodPath
Delete any experiment typeDELETE/api/experiments/:id
Delete a price experiment explicitlyDELETE/api/price-experiments/:id
Before deleting a running experiment, pause it first using POST /api/experiments/:id/pause. This ensures any in-flight visitor sessions complete their current assignment before the experiment is removed.