"Best analytics tool I've used in 14 years"

Delete alert

DELETE https://datafa.st/api/v1/admin/websites/{websiteId}/alerts/{alertId}

Permanently delete an alert configuration. Trigger history remains in alert history.
Related: Alerts

Request

Path parameters

websiteId
string
Website ObjectId. From List websites (_id field). Example: 665f0b3c4d2e1a0012345678.
alertId
string
Alert ObjectId from List alerts.

Response

Returns a JSON object with status: "success" and endpoint-specific fields in data.

Response fields

data[].message
string
Human-readable confirmation or status message for the operation.

Authentication

Use a dft_ account token with alerts:write.
A df_ website API key for the same website can also call this route when the path websiteId matches the key's website. Write access with a df_ key is capped at member level — owner-only actions such as team management require a dft_ token and owner role.

Errors

See API errors for the standard error envelope, auth failures, validation errors, permission errors, and rate limits.

✍️ Something missing? Suggest features.

🤖 AI agent or LLM? Read this page as markdown

Example request
curl -X DELETE "https://datafa.st/api/v1/admin/websites/{websiteId}/alerts/{alertId}" \
  -H "Authorization: Bearer dft_xxx"
Success response
{
  "status": "success",
  "data": [{
    "message": "Alert deleted successfully"
  }]
}