# Deleting

Base URL `https://pfcloud.pfctek.com/api/v1`. Every call needs `Authorization: Bearer mf_…`. Changes accept an `Idempotency-Key` header. Ids are public ids (UUIDs).

## GET /deletion-requests

**List deletion requests**

Scope: `deletions:request`

| Parameter | In | Description |
| --- | --- | --- |
| `status` | query |  |

## GET /deletion-requests/{deletion}

**Get a deletion request**

Scope: `deletions:request`

| Parameter | In | Description |
| --- | --- | --- |
| `deletion` | path | Public id from the dashboard address (required) |

## DELETE /deletion-requests/{deletion}

**Withdraw a waiting request (only the token that asked)**

Scope: `deletions:request`

| Parameter | In | Description |
| --- | --- | --- |
| `deletion` | path | Public id from the dashboard address (required) |

## POST /servers/{server}/deletion-requests

**Ask to remove a server**

Scope: `deletions:request`

Owners and admins are emailed and approve in the dashboard (DELETE, password, emailed code). Removing a server never touches it.

| Parameter | In | Description |
| --- | --- | --- |
| `server` | path | Public id from the dashboard address (required) |

| Body field | Type | Description |
| --- | --- | --- |
| `reason` | string |  |

## POST /servers/{server}/databases/{database}/deletion-requests

**Ask to drop a database**

Scope: `deletions:request`

Approved in the dashboard by typing the database name and a password.

| Parameter | In | Description |
| --- | --- | --- |
| `server` | path | Public id from the dashboard address (required) |
| `database` | path | Database name (required) |

| Body field | Type | Description |
| --- | --- | --- |
| `reason` | string |  |

## POST /sites/{site}/deletion-requests

**Ask to delete a site**

Scope: `deletions:request`

| Parameter | In | Description |
| --- | --- | --- |
| `site` | path | Public id from the dashboard address (required) |

| Body field | Type | Description |
| --- | --- | --- |
| `reason` | string |  |
| `drop_database` | boolean |  |