Swarmtix Help Center
Tool Reference

swarmtix_discounts_delete

Switches a discount off so it can no longer be used - the offer is kept because orders point at it

swarmtix_discounts_delete

Switches a discount, public discount or access code off, so it can no longer be used, and returns its id. The offer is kept, not erased, because orders that used it still point at it.

When you would reach for it

Scope

discounts:write

The tool is marked destructive, because the offer stops working. It is idempotent: switching off an offer that is already off succeeds.

Parameters

NameTypeRequiredDefaultDescription
eventstringYes-The event's id (a GUID) or its URL slug.
discountstringYes-The id of the discount, from swarmtix_discounts_list.

Example call

{
  "name": "swarmtix_discounts_delete",
  "arguments": {
    "event": "spring-summit-2027",
    "discount": "a15c9e02-3b7d-4c61-8f95-6d24e0a7b3c8"
  }
}

What comes back

{
  "id": "a15c9e02-3b7d-4c61-8f95-6d24e0a7b3c8",
  "eventId": "3b6f81ce-04a2-4d97-b5e8-7c10924af3d6",
  "name": "PARTNER20",
  "deleted": true
}

What happens when you call it

Only the Active flag is changed. The dashboard's own delete removes the row and does not check for orders that point at it, so this tool does not use it.

A switched-off offer cannot be changed again through MCP. Create a new one if you need it back.

Troubleshooting

"discount is not valid: there is no discount with that id on this event."

The id is wrong, or belongs to another event.

Use cases

  • Retiring a campaign code
  • Removing a duplicate after a retry

On this page