Listar os backups da conta

curl

curl https://app.cubehosting.com.br/api/account/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}/account/backups`, { headers });
const { projects } = await res.json();
const apagados = projects.filter((p) => p.isDeleted);
console.log(apagados.map((p) => [p.name, p.backups[0]?.id]));

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}/account/backups", headers=headers, timeout=30)
r.raise_for_status()
for p in r.json()["projects"]:
    if p["isDeleted"]:
        print(p["name"], p["backups"][0]["id"] if p["backups"] else None)

{
  "limit": 5,
  "retentionDays": 30,
  "isDailyAvailable": true,
  "projects": [
    {
      "id": "01J8Z3W6N0Q4Y7V2K5T9D1H3XA",
      "name": "Meu bot",
      "isDeleted": false,
      "isDailyEnabled": true,
      "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"
        }
      ]
    },
    {
      "id": "01J8Z5C3R1T6V8X0Z2B4D6F8HK",
      "name": "Bot antigo",
      "isDeleted": true,
      "isDailyEnabled": false,
      "backups": [
        {
          "id": "7c1d9e2f-3a4b-4c5d-8e6f-0a1b2c3d4e5f",
          "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"
        }
      ]
    }
  ],
  "deletedDatabases": [
    {
      "id": "01J9A2C4E6G8J0K2M4P6R8T0V2",
      "name": "loja-db",
      "engine": "postgres",
      "engineName": "PostgreSQL",
      "memoryMb": 512,
      "backups": [
        {
          "id": "595bf272-a3da-4d8d-b7d5-ac70868c032d",
          "type": "daily",
          "status": "ready",
          "sizeBytes": 2732,
          "error": null,
          "createdAt": "2026-09-28T12:29:15.000Z",
          "finishedAt": "2026-09-28T12:29:17.000Z",
          "expiresAt": "2026-10-05T12:29:15.000Z"
        }
      ]
    }
  ]
}

GET

account

backups

curl

curl https://app.cubehosting.com.br/api/account/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}/account/backups`, { headers });
const { projects } = await res.json();
const apagados = projects.filter((p) => p.isDeleted);
console.log(apagados.map((p) => [p.name, p.backups[0]?.id]));

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}/account/backups", headers=headers, timeout=30)
r.raise_for_status()
for p in r.json()["projects"]:
    if p["isDeleted"]:
        print(p["name"], p["backups"][0]["id"] if p["backups"] else None)

{
  "limit": 5,
  "retentionDays": 30,
  "isDailyAvailable": true,
  "projects": [
    {
      "id": "01J8Z3W6N0Q4Y7V2K5T9D1H3XA",
      "name": "Meu bot",
      "isDeleted": false,
      "isDailyEnabled": true,
      "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"
        }
      ]
    },
    {
      "id": "01J8Z5C3R1T6V8X0Z2B4D6F8HK",
      "name": "Bot antigo",
      "isDeleted": true,
      "isDailyEnabled": false,
      "backups": [
        {
          "id": "7c1d9e2f-3a4b-4c5d-8e6f-0a1b2c3d4e5f",
          "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"
        }
      ]
    }
  ],
  "deletedDatabases": [
    {
      "id": "01J9A2C4E6G8J0K2M4P6R8T0V2",
      "name": "loja-db",
      "engine": "postgres",
      "engineName": "PostgreSQL",
      "memoryMb": 512,
      "backups": [
        {
          "id": "595bf272-a3da-4d8d-b7d5-ac70868c032d",
          "type": "daily",
          "status": "ready",
          "sizeBytes": 2732,
          "error": null,
          "createdAt": "2026-09-28T12:29:15.000Z",
          "finishedAt": "2026-09-28T12:29:17.000Z",
          "expiresAt": "2026-10-05T12:29:15.000Z"
        }
      ]
    }
  ]
}

Excluir um projeto não apaga os backups dele: eles ficam aqui com isDeleted: true até vencer (30 dias). Pegue o id de um backup ready e use Restaurar como novo para ter o projeto de volta, com outro ID. Os bancos excluídos vêm em deletedDatabases (7 dias); restaurá-los como um banco novo é só pelo painel. Vale com a chave de leitura.

Erros comuns

Código	HTTP	O que fazer
`invalid_api_key`	401	Confira o cabeçalho `Authorization: Bearer cube_…`.
`rate_limit_exceeded`	429	Espere o tempo do `Retry-After`.

Todos os códigos, com o formato do erro, em Códigos de erro.

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_….

Resposta

Os backups da conta.

Os backups de todos os projetos da conta, também os de um projeto apagado, e os dos bancos excluídos.

limit

integer

obrigatório

Quantos backups manuais e automáticos o plano guarda por projeto.

retentionDays

integer

obrigatório

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

isDailyAvailable

boolean

obrigatório

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

projects

object[]

obrigatório

Um item por projeto da conta (com ou sem backup) e, depois, um por projeto apagado que ainda tem backup.

Show child attributes

deletedDatabases

object[]

obrigatório

Um item por banco de dados excluído que ainda tem backup (7 dias). Restaurar como um banco novo é só pelo painel.

Show child attributes

Visão geral

Projetos

Templates

Controle

Logs e métricas

Variáveis de ambiente

Backups

Versões dos envios

Bancos de dados

Blob

Domínios

Avisos

Conta

Listar os backups da conta

Erros comuns

Autorizações

Resposta

​Erros comuns

Autorizações

Resposta

Erros comuns