# Deployments

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 /sites/{site}/deployments

**List deployments**

Scope: `deployments:read`

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

## GET /sites/{site}/deployments/{deployment}

**Get a deployment with its log**

Scope: `deployments:read`

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

## POST /sites/{site}/deploy

**Deploy**

Scope: `deployments:write`

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

## POST /sites/{site}/rollback

**Roll back to the previous release**

Scope: `deployments:write`

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