Pterodactyl API v1
Backups

Restore backup

Restores a backup to the server. Existing files will be overwritten. Returns 400 if the backup has not completed, or if the server is currently installing, transferring, or restoring a different backup.

POST/api/client/servers/{server}/backups/{backup}/restore

Authorization

ClientToken
AuthorizationBearer <token>

Client API key (generated at /account/api)

In: header

Path Parameters

server*string

Server identifier (short 8-character ID)

backup*string

Backup UUID

Request Body

application/json

truncate*boolean

Whether to delete all files before restoring the backup

Response Body

curl -X POST "https://pterodactyl.file.properties/api/client/servers/1a7ce997/backups/904df120-a66f-4375-a4ae-40eedbeae630/restore" \  -H "Authorization: Bearer ptlc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \  -H "Accept: application/json" \  -H "Content-Type: application/json" \  -d '{  "truncate": false}'
Empty