Pixel Host Docs

Documentação Pixel Host

Backups

Liste, crie e restaure backups do servidor.

A restauração substitui o estado atual pelos dados do backup escolhido. Pare o servidor antes de restaurar arquivos usados em execução.

Endpoints

GET/servers/{serverId}/backups

Lista os backups disponíveis.

Permissão
backup.read
Como enviar
curl -sS -X GET \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  "https://pixel-host.com.br/api/v1/servers/SEU_SERVER_ID/backups"
Resposta HTTP 200
{
  "backups": [
    { "id": "backup-id", "format": "pxbk", "size": 52428800, "createdAt": "2026-06-22T18:30:00.000Z" }
  ]
}
POST/servers/{serverId}/backups

Cria um backup imediatamente.

Permissão
backup.create
Como enviar
curl -sS -X POST \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  "https://pixel-host.com.br/api/v1/servers/SEU_SERVER_ID/backups"
Resposta HTTP 201
{
  "backup": { "id": "backup-id", "format": "pxbk", "size": 52428800 },
  "backups": []
}
PATCH/servers/{serverId}/backups

Restaura um backup.

Permissão
backup.restore
Como enviar
curl -sS -X PATCH \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{ "id": "backup-id" }' \
  "https://pixel-host.com.br/api/v1/servers/SEU_SERVER_ID/backups"
Corpo JSON formatado
{ "id": "backup-id" }
Resposta HTTP 200
{ "restored": true, "backupId": "backup-id", "backups": [] }
DELETE/servers/{serverId}/backups

Exclui um backup.

Permissão
backup.delete
Como enviar
curl -sS -X DELETE \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{ "id": "manual/backup.tar.gz" }' \
  "https://pixel-host.com.br/api/v1/servers/SEU_SERVER_ID/backups"
Corpo JSON formatado
{ "id": "manual/backup.tar.gz" }
Resposta HTTP 200
{ "ok": true, "backups": [] }
API basehttps://pixel-host.com.br/api/v1