DeluxHostAPI Reference
Storage Boxes

Create a storage snapshot

POST
/v1/services/{id}/storage/snapshots

A manual snapshot of the whole box. Ten per 15 minutes per account, shared with the dashboard.

Authorization

apiToken storage:write
headerAuthorizationBearer <token>

A personal API token: Authorization: Bearer dh_live_…. See Authentication for scopes.

Scope: storage:write

Path Parameters

id*integer

The service id, as returned by GET /v1/services.

Request Body

application/json
  1. body
label?string
Lengthlength <= 80

Response Body

The new snapshot.

application/json
  1. response
name*string
kind*string
Value in"manual""auto"
label*string
createdAt*string
Formatdate-time
usedBytes*integer

Space held only by this snapshot.

referencedBytes*integer

Size of the box when it was taken.

curl -X POST 'https://api.deluxhost.net/v1/services/0/storage/snapshots' \  -H "Authorization: Bearer $DELUXHOST_TOKEN" \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "name": "string",  "kind": "manual",  "label": "string",  "createdAt": "2019-08-24T14:15:22Z",  "usedBytes": 0,  "referencedBytes": 0}