Backups

Get a direct download URL for the archive

GET
/game-servers/{slice}/backups/{backup}/download

The URL points at the node and carries a short-lived token of its own, so the transfer never passes through this API and does not count against its rate limit. One call buys a download of any size.

Only a finished backup has an archive to download.

Authorization

orgApiKey game-servers.backups.read
AuthorizationBearer <token>

An organisation API key, prefixed tbk_. Create one under Organisation to API keys; the plaintext is shown once.

The scopes listed on each operation are the abilities the key must carry. They are not OAuth scopes and are not negotiated per request.

In: header

Scope: game-servers.backups.read

Path Parameters

slice*string

The server's UUID, as returned by the list endpoint.

Formatuuid
backup*string

The backup's UUID, as returned by the list endpoint.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/game-servers/497f6eca-6276-4993-bfeb-53cbbbba6f08/backups/497f6eca-6276-4993-bfeb-53cbbbba6f08/download"
{  "data": {    "url": "string",    "expires_at": "2019-08-24T14:15:22Z"  }}