Listar backups - Cube Hosting

curl

curl https://app.cubehosting.com.br/api/projects/$PROJECT_ID/backups \
  -H "Authorization: Bearer $CUBE_API_KEY"

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/projects/${process.env.PROJECT_ID}/backups`, { headers });
const { backups, limit } = await res.json();
console.log(`${backups.length} de ${limit}`, backups[0]?.status);

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(f"{API}/projects/{os.environ['PROJECT_ID']}/backups", headers=headers, timeout=30)
r.raise_for_status()
data = r.json()
print(len(data["backups"]), "de", data["limit"])

{
  "backups": [
    {
      "id": "5b0c7a4e-2f1d-4c8e-9a36-7d2b1e0f4c11",
      "type": "manual",
      "status": "ready",
      "sizeBytes": 184320,
      "error": null,
      "createdAt": "2026-09-27T18:00:00.000Z",
      "finishedAt": "2026-09-27T18:00:04.000Z",
      "expiresAt": "2026-10-27T18:00:00.000Z"
    }
  ],
  "limit": 3,
  "retentionDays": 30,
  "isDailyAvailable": true,
  "isDailyEnabled": true
}

GET

/

projects

/

{id}

/

backups

curl

curl https://app.cubehosting.com.br/api/projects/$PROJECT_ID/backups \
  -H "Authorization: Bearer $CUBE_API_KEY"

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/projects/${process.env.PROJECT_ID}/backups`, { headers });
const { backups, limit } = await res.json();
console.log(`${backups.length} de ${limit}`, backups[0]?.status);

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(f"{API}/projects/{os.environ['PROJECT_ID']}/backups", headers=headers, timeout=30)
r.raise_for_status()
data = r.json()
print(len(data["backups"]), "de", data["limit"])

{
  "backups": [
    {
      "id": "5b0c7a4e-2f1d-4c8e-9a36-7d2b1e0f4c11",
      "type": "manual",
      "status": "ready",
      "sizeBytes": 184320,
      "error": null,
      "createdAt": "2026-09-27T18:00:00.000Z",
      "finishedAt": "2026-09-27T18:00:04.000Z",
      "expiresAt": "2026-10-27T18:00:00.000Z"
    }
  ],
  "limit": 3,
  "retentionDays": 30,
  "isDailyAvailable": true,
  "isDailyEnabled": true
}

Os backups do projeto e as regras do plano: quantos ficam guardados (limit), por quantos dias (retentionDays) e se o backup automático está ligado. Guia completo em Backups.

Autorizações

Authorization

string

header

obrigatório

Chave de API da Cube (cube_…), criada no painel em Chaves de API. Mande como Authorization: Bearer cube_….

Parâmetros de caminho

id

string

obrigatório

O ID do projeto (26 caracteres). Aparece no painel, no topo do projeto, e em GET /projects.

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$

Exemplo:

"01J8Z3W6N0Q4Y7V2K5T9D1H3XA"

Resposta

Os backups e as regras do plano.

backups

object[]

obrigatório

Do mais novo para o mais antigo.

Show child attributes

limit

integer

obrigatório

Quantos backups manuais e automáticos o plano guarda por projeto (Free 1, Block 3, Stack 5, Tower 7, Fortress 10, Monolith 14).

retentionDays

integer

obrigatório

Por quantos dias no máximo um backup fica guardado.

isDailyAvailable

boolean

obrigatório

true nos planos pagos, que têm o backup automático diário.

isDailyEnabled

boolean

obrigatório

Se o backup automático deste projeto está ligado (liga e desliga no painel).