Delete a series

DELETE /api/v1/series/{seriesId} Deletes the series, its versions, its steps and its wires. Definitive. Campaigns already sent by its steps are not deleted: they went out, they have statistics, and they belong to your history.

Authorization

RoleAccess
OWNERAllowed
ADMINAllowed
MEMBERRefused — 403

Path parameters

ParameterTypeDescription
seriesIdstring (uuid)The series id

Example

bash
curl -s -X DELETE 'https://www.agentsmail.io/api/v1/series/7d7d7d7d-8888-4ccc-9ddd-eeee00001111' \
  -H "x-api-key: $AGENTMAIL_API_KEY"

Response

CodeWhen
200Deleted
400This id is a sequence, not a series
401Missing or invalid key
403The key's role is MEMBER
404No series with this id in your organization

Response fields

FieldTypeDescription
successbooleanAlways true here
data.idstringThe id that was deleted

Example response

json
{"success": true, "data": {"id": "7d7d7d7d-8888-4ccc-9ddd-eeee00001111"}}

Notes

Pause the series first if it is running. A deleted series stops producing campaigns immediately.