Delete an automation

Remove an automation and its graph.

DELETE /v1/automations/{id}

Requires a Full access API key.

Path parameters

Parameter	Type	Required	Description
id	string	Yes	The automation id (auto_…).

Example

curl

curl -X DELETE "https://api.sendgrail.com/v1/automations/$AUTOMATION_ID" \
  -H "Authorization: Bearer $SENDGRAIL_API_KEY"

Node.js

await fetch(`https://api.sendgrail.com/v1/automations/${id}`, {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.SENDGRAIL_API_KEY}` },
});

Response

{
  "object": "automation",
  "id": "auto_5PmT9wRx2AqK",
  "deleted": true
}

What deleting does

Deleting removes the automation, its graph, and its run history — the runs go with it, so a run id from a deleted automation no longer resolves.

If contacts are mid-flight, prefer stopping over deleting: stopping keeps in-flight runs and the history intact and just closes the door to new ones, while deleting throws the whole thing away. Delete when you're done with an automation for good; stop when you only want it to pause.

An automation from another team answers 404; a sending-access key answers 403. See Errors.