---
title: "Delete a monitor"
method: DELETE
path: "/monitors/{monitor}"
tags: ["Monitors"]
---

# Delete a monitor

`DELETE /monitors/{monitor}`

## Request

- Base URL: `https://api.spectate.net/v1`
- URL: `https://api.spectate.net/v1/monitors/{monitor}`
- Auth: HTTP bearer

Its checks stop at once and it no longer appears in the API or the dashboard. Seven days
later the monitor is deleted permanently with all its data: check history, alerts and
failure snapshots. Until then support can restore it on request. Incidents stay, and status
page components that showed the monitor keep their place without it. Deleting the same
monitor again returns `404`.

## Path parameters

- `monitor` string, uuid, required

## Response `204`

No content

## Other responses

- `401`: `UNAUTHENTICATED`: no token was sent. `INVALID_TOKEN`: the token is unknown or revoked. `TOKEN_EXPIRED`: the token has expired.
- `403`: `FORBIDDEN`: the token lacks an ability this endpoint requires (listed in `details.required_abilities`). `TEAM_PENDING_DELETION`: the team is scheduled for deletion. `TEAM_SUSPENDED`: Spectate suspended the team.
- `404`: `RESOURCE_NOT_FOUND`: there is no such resource in this team.
- `429`: `RATE_LIMITED`: too many requests for this token. Wait for the number of seconds in `Retry-After`.

---

[API](https://skmtc.dev/spectate/apis/spectate-api.md) - [All operations](https://skmtc.dev/spectate/apis/spectate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spectate/apis/spectate-api/revisions/9b1a233997de?raw)