Listar backups do banco

curl

curl https://app.cubehosting.com.br/api/databases/$DATABASE_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}/databases/${process.env.DATABASE_ID}/backups`, { headers });
const { backups } = await res.json();
console.log(backups[0]?.status, backups[0]?.createdAt);

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}/databases/{os.environ['DATABASE_ID']}/backups", headers=headers, timeout=30)
r.raise_for_status()
print([b["status"] for b in r.json()["backups"]])

{
  "backups": [
    {
      "id": "595bf272-a3da-4d8d-b7d5-ac70868c032d",
      "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"
    }
  ],
  "retentionDays": 7,
  "isAvailable": true
}

GET

databases

{id}

backups

curl

curl https://app.cubehosting.com.br/api/databases/$DATABASE_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}/databases/${process.env.DATABASE_ID}/backups`, { headers });
const { backups } = await res.json();
console.log(backups[0]?.status, backups[0]?.createdAt);

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}/databases/{os.environ['DATABASE_ID']}/backups", headers=headers, timeout=30)
r.raise_for_status()
print([b["status"] for b in r.json()["backups"]])

{
  "backups": [
    {
      "id": "595bf272-a3da-4d8d-b7d5-ac70868c032d",
      "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"
    }
  ],
  "retentionDays": 7,
  "isAvailable": true
}

Com o banco no ar, a Cube faz um backup por dia e guarda por 7 dias. Se o do dia não sair, ele aparece como failed e sai de novo em 1 hora. Para baixar, use Pedir o link do backup; restaurar é só pelo painel.

Erros comuns

Código	HTTP	O que fazer
`not_found`	404	O banco não existe ou não é da sua conta.
`invalid_api_key`	401	Confira o cabeçalho `Authorization: Bearer cube_…`.

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

Parâmetros de caminho

string

obrigatório

O ID do banco de dados (26 caracteres), de Listar bancos de dados.

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

Exemplo:

"01J9A2C4E6G8J0K2M4P6R8T0V2"

Resposta

Os backups do banco.

backups

object[]

obrigatório

Do mais novo para o mais antigo.

Show child attributes

retentionDays

integer

obrigatório

isAvailable

boolean

obrigatório

false quando o armazenamento dos backups está fora.

Visão geral

Projetos

Controle

Logs e métricas

Variáveis de ambiente

Backups

Versões dos envios

Bancos de dados

Blob

Avisos

Conta

Listar backups do banco

Erros comuns

Autorizações

Parâmetros de caminho

Resposta

​Erros comuns

Autorizações

Parâmetros de caminho

Resposta

Erros comuns