Dismiss Alert

### Dismiss an alert, leaving it in place for later reset. **Available to:** All authenticated users **Environments:** Demo, Live **[Rate Limit](/api/authentication#request-rate-limits-and-time-penalties):** No endpoint-specific limit Stops watching the alert identified by `alertId` and sets its `status` to `Inactive`. The alert must belong to the calling user. Dismissing keeps the alert entity, so it is not removed — it simply stops evaluating its condition. To start it watching again, use [`resetAlert`](/api/rest-api-endpoints/alerts/reset-alert) (which also clears the trigger counter and any failure). To remove the alert entirely, use [`deleteAlert`](/api/rest-api-endpoints/alerts/delete-alert). The request body contains a single required field, `alertId`, from [`createAlert`](/api/rest-api-endpoints/alerts/create-alert) or [`alertItem`](/api/rest-api-endpoints/alerts/alert-item). The response returns the dismissed `alert`. Dismiss is idempotent: dismissing an alert that is already `Inactive` returns the alert unchanged. **Common Failure Scenarios** - `alertId` does not exist or is not owned by the calling user. **Error Messages** | `errorText` | Trigger | |-------------|---------| | Non-empty `errorText` | The request failed; the field describes the reason. |