Delete an alert owned by the authenticated user.

Available to: All authenticated users

Environments: Demo, Live

Rate Limit: No endpoint-specific limit

Removes the alert identified by alertId. The alert must belong to the calling user. The server archives the alert and stops watching its condition, so the alert no longer appears in alertItem or list reads and cannot be reset afterward. To stop an alert without removing it — so it can be re-armed later — use dismissAlert followed by resetAlert instead.

The request body contains a single required field, alertId, from createAlert or alertItem. On success the response returns no alert; an empty errorText indicates the alert was removed.

Common Failure Scenarios

• alertId does not exist or is not owned by the calling user.

This action cannot be undone. To keep the alert available for future use, dismiss it instead of deleting it.

Error Messages