> ## 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 Status Page

> Delete a status page and take its public URL offline

## Overview

Deletes a status page. The page's public URL stops working immediately, its subdomain becomes available again, and the page no longer counts against your plan's status page limit. Deleted pages cannot be restored through the API.

`DELETE /api/projects/{projectId}/status-pages/{id}`

## Authentication

| Header | Required | Description |
| - | - | - |
| `X-API-Key` | Yes | Your API key (`Authorization: Bearer {jwt}` also works). API keys need the `read_write` scope. |
| `X-Project-ID` | Yes | Must be the same project UUID as in the URL. |

**Required access:** project admin.

## Path parameters

| Parameter | Type | Description |
| - | - | - |
| `projectId` | UUID | The project |
| `id` | UUID | The status page |

## Response

### 200 OK

```json theme={null}
{
  "success": true,
  "data": {
    "message": "Status page deleted successfully"
  }
}
```

Deleting a status page does not delete its monitors or their incidents.

## Errors

| Status | Code | Cause |
| - | - | - |
| 400 | `PROJECT_ID_REQUIRED` / `INVALID_PROJECT_ID` | `X-Project-ID` header missing or not a UUID |
| 401 | `AUTHENTICATION_REQUIRED` | Missing or invalid credentials |
| 403 | `INSUFFICIENT_PERMISSIONS` | Caller is not a project admin |
| 403 | `ACCESS_DENIED` | The page belongs to another project |
| 403 | `API_KEY_ORGANIZATION_MISMATCH` | The API key belongs to a different organization than the project |
| 403 | `READ_ONLY_API_KEY` | The API key has the `read` scope |
| 404 | `RESOURCE_NOT_FOUND` | The status page does not exist or is already deleted |

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE https://api.uptimeio.com/api/projects/YOUR_PROJECT_ID/status-pages/YOUR_STATUS_PAGE_ID \
    -H "X-API-Key: YOUR_API_KEY" \
    -H "X-Project-ID: YOUR_PROJECT_ID"
  ```

  ```javascript JavaScript theme={null}
  const projectId = 'YOUR_PROJECT_ID';
  const statusPageId = 'YOUR_STATUS_PAGE_ID';

  const response = await fetch(
    `https://api.uptimeio.com/api/projects/${projectId}/status-pages/${statusPageId}`,
    {
      method: 'DELETE',
      headers: {
        'X-API-Key': process.env.UPTIMEIO_API_KEY,
        'X-Project-ID': projectId,
      },
    }
  );

  console.log((await response.json()).data.message);
  ```
</CodeGroup>


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