---
title: "Disable an alert via email-footer token"
method: POST
path: "/v1/alerts/disable"
tags: ["Alerts", "tier:free"]
---

# Disable an alert via email-footer token

`POST /v1/alerts/disable`

## Request

- Base URL: `https://api.particle.pro`
- URL: `https://api.particle.pro/v1/alerts/disable`
- Auth: none required

Redeems a single-use token from the footer of an alert email and flips the alert's is_active flag to false. Idempotent: a replay returns 200 with already_disabled=true. Public — token possession is the auth factor.

## Request body

- DisableAlertBody
  - `token` string, required: Disable-alert token from the footer of an alert email.

## Response `200`

OK

- DisableAlertResponseBody
  - `alert_id` string, required: The alert identified by the supplied token.
  - `already_disabled` boolean, required: True when this click is not the one that changed state — either the token was already redeemed (GET preview after a click, or POST replay), or the alert was already inactive when the token was redeemed. The is_active field reflects the alert's *current* state, which can diverge from already_disabled if the alert was re-enabled after the token was redeemed.
  - `delivery_cadence` string, required: The alert's delivery cadence (REALTIME, DAILY, or WEEKLY).
  - `is_active` boolean, required: The alert's current is_active flag — false after a successful POST.
  - `kind` string, required: The alert's kind (ENTITY_MENTION, PODCAST_SPEAKER, or KEYWORD_MENTION).
  - `manage_url` string, required: Deep-link to the alert's management page.
  - `monitor_id` string, required: Deprecated — use alert_id. The alert identified by the supplied token.
  - `title` string, required: The alert's current title.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/particle/apis/particle-api.md) · [All operations](https://skmtc.dev/particle/apis/particle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/particle/apis/particle-api/revisions/416ba82ab9d7?raw)