Skip to main content
DELETE
/
v1
/
campaigns
/
{id}
/
steps
/
{stepId}
/
variants
/
{variantId}
Delete Variant
curl --request DELETE \
  --url https://app-api.walead.ai/api/v1/campaigns/{id}/steps/{stepId}/variants/{variantId} \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "message": "<string>",
  "variants": [
    {
      "id": "<string>",
      "body": "<string>",
      "order": 123,
      "isDisabled": true,
      "icpDefinitionRaw": "<string>",
      "stepId": "<string>",
      "aiTools": [
        {
          "name": "<string>",
          "key": "<string>"
        }
      ]
    }
  ]
}

​
Overview

Permanently removes a message variant from a step. Use this to clean up underperforming variants or simplify your A/B testing rotation.

​
When to Delete a Variant

  • Underperforming messages: Remove variants that consistently get lower response rates
  • Completed tests: After determining a winner in your A/B test
  • Simplifying rotation: Reduce the number of variants for more focused testing
  • Strategy changes: Remove messages that no longer align with your campaign goals

​
What Happens

  1. The variant is permanently deleted
  2. The variant order may be adjusted for remaining variants
  3. Future leads won’t receive this variant
  4. Historical data is preserved in analytics

​
Response

Returns the updated array of variants for the step, showing the remaining active variants.

​
Important Considerations

This action cannot be undone. The variant and its configuration are permanently removed.
Minimum Variants: If this is the only variant for a step, consider either:
  • Adding a new variant before deleting this one
  • Deleting the entire step instead

​
Impact on Analytics

  • Leads who already received this variant remain in the analytics
  • Performance metrics for this variant are preserved
  • New leads will be assigned to remaining variants

​
Alternative: Disable Instead of Delete

If you’re not sure whether to permanently remove a variant, consider using the Update Variant endpoint to disable it instead: 
{
  "isDisabled": true
}
This allows you to:
  • Preserve the variant for future use
  • Keep all historical data and configuration
  • Re-enable it later if needed

​
Best Practices

  1. Analyze first: Review variant performance before deleting
  2. Document why: Keep notes on why variants were removed
  3. Gradual refinement: Remove variants one at a time and monitor impact
  4. Backup content: Save successful message templates for future campaigns

Authorizations

​
x-api-key
string
header
required

API key for authentication. Generate from your WaLead dashboard.

Path Parameters

​
id
string
required

Campaign ID

​
stepId
string
required

Step ID

​
variantId
string
required

Variant ID

Response

Variant deleted successfully

​
success
boolean
​
message
string
​
variants
object[]