> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uptimeio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Monitor

> Permanently remove a monitor and stop its checks

## Overview

Delete a monitor. Checks stop immediately, the monitor disappears from lists and no longer counts toward your plan's monitor limit, and any incident that is still open for it is closed automatically.

```
DELETE https://api.uptimeio.com/api/monitors/{id}
```

<Warning>
  Deleting a monitor cannot be undone through the API. If you only need checks to stop for a while, use [Pause Monitor](/api-reference/monitors/pause) instead.
</Warning>

## Authentication

| Header | Required | Description |
| - | - | - |
| `X-API-Key` | Yes (or a Bearer token) | Your API key with **read and write** access. Read-only keys receive `READ_ONLY_API_KEY` (403). See [Authentication](/api-reference/authentication). |
| `X-Project-ID` | No | Project that contains the monitor. Defaults to your organization's default project. |

Your role must be allowed to delete monitors, otherwise `INSUFFICIENT_PERMISSIONS` (403).

## Path parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `id` | UUID | Yes | Monitor ID. |

## Response

### 204 No Content

The monitor was deleted. The response has no body.

## Errors

| Code | Status | Meaning |
| - | - | - |
| `AUTHENTICATION_REQUIRED` / `MISSING_AUTH` / `INVALID_API_KEY` | 401 | Missing or invalid credentials. |
| `READ_ONLY_API_KEY` | 403 | The key has read-only access. |
| `INSUFFICIENT_PERMISSIONS` | 403 | Your role cannot delete monitors. |
| `MONITOR_NOT_FOUND` | 404 | No monitor with this ID in the project, or it was already deleted. |
| `MONITOR_DELETION_FAILED` | 500 | The monitor could not be deleted. |

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE https://api.uptimeio.com/api/monitors/MONITOR_ID \
    -H "X-API-Key: YOUR_API_KEY" \
    -i
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch('https://api.uptimeio.com/api/monitors/MONITOR_ID', {
    method: 'DELETE',
    headers: { 'X-API-Key': process.env.UPTIMEIO_API_KEY },
  });
  console.log(res.status); // 204
  ```

  ```python Python theme={null}
  import os
  import requests

  res = requests.delete(
      "https://api.uptimeio.com/api/monitors/MONITOR_ID",
      headers={"X-API-Key": os.environ["UPTIMEIO_API_KEY"]},
  )
  print(res.status_code)  # 204
  ```
</CodeGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.