delete-alert
dci delete-alert <id>
Deletes the alert specified by the Id.
id— Alert ID as shown bydci list-alerts. Alert names resolve too (exact, unique substring, or close typo); the confirmation shows the resolved target.
Examples
# Preview what would be deleted, without sending a request.
dci delete-alert <alert-id> --dry-run
# Delete without a prompt, for scripts and CI (interactive terminals ask first).
dci delete-alert <alert-id> --yes
Exit code 0 and no output; `dci list-alerts` no longer lists the alert.
Output
On success, this command produces no response data.
Errors
On failure, dci prints a single error message — with a hint when one is available — and exits with a typed code your scripts can branch on. See Errors and exit codes for the full contract.
HTTP status to exit code mapping
| HTTP status | Exit code | Error code | Meaning |
|---|---|---|---|
| 400 | 30 | VALIDATION_ERROR | The arguments or request body were rejected. Review the command's flags and payload. |
| 401 | 10 | AUTHENTICATION_FAILED | Not signed in, or the API token is invalid. Run dci login or check DCI_API_KEY. |
| 403 | 11 | PERMISSION_DENIED | The DoiT user or the active customer context does not have access. |
| 404 | 20 | RESOURCE_NOT_FOUND | The requested resource does not exist. Check the identifier argument. |
Related
- create-alert — Create an alert
- get-alert — Retrieve an alert
- list-alerts — List alerts
- update-alert — Update an alert
- API reference: DELETE /analytics/v1/alerts/{id}
Aliases: deletealert