# Moving sites

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

## GET /sites/{site}/move

**The latest move to another server**

Scope: `sites:read`

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

## POST /sites/{site}/move

**Start moving to another server**

Scope: `sites:write`

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

| Body field | Type | Description |
| --- | --- | --- |
| `server` | string |  |
| `confirm` | string | The site’s domain, typed out to confirm |
| `override_room` | boolean | Team owner only: add it although the server is too small for another site (pfcloud estimates its memory). Without it such a request answers 422 with the reason on `server`. |

## POST /sites/{site}/move/retry

**Retry a failed move**

Scope: `sites:write`

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

## POST /sites/{site}/move/finish

**Switch traffic to the new server**

Scope: `sites:write`

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

| Body field | Type | Description |
| --- | --- | --- |
| `dns` | string | auto or manual |
| `confirm` | string | The site’s domain, typed out to confirm |

## POST /sites/{site}/move/confirm-dns

**Confirm a manual DNS change**

Scope: `sites:write`

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

## POST /sites/{site}/move/switch-back

**Switch back to the old server**

Scope: `sites:write`

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

| Body field | Type | Description |
| --- | --- | --- |
| `confirm` | string | The site’s domain, typed out to confirm |

## POST /sites/{site}/move/cancel

**Cancel a move**

Scope: `sites:write`

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

