Iniciar um banco

curl

curl -X POST https://app.cubehosting.com.br/api/databases/$DATABASE_ID/start \
  -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}/start`, {
  method: 'POST',
  headers,
});
const { database } = await res.json();
console.log(database.status);

import os
import requests

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

r = requests.post(f"{API}/databases/{os.environ['DATABASE_ID']}/start", headers=headers, timeout=120)
r.raise_for_status()
print(r.json()["database"]["status"])

{
  "database": {
    "id": "01J9A2C4E6G8J0K2M4P6R8T0V2",
    "name": "loja-db",
    "engine": "postgres",
    "engineName": "PostgreSQL",
    "host": "loja-db",
    "port": 5432,
    "status": "running",
    "memoryMb": 512,
    "usage": {
      "memoryMb": 61
    },
    "disk": {
      "usedMb": 47,
      "limitMb": 2048
    },
    "startedAt": "2026-09-28T12:26:03.000Z",
    "createdAt": "2026-09-28T12:26:00.000Z",
    "updatedAt": "2026-09-28T12:26:01.000Z"
  }
}

POST

databases

{id}

start

curl

curl -X POST https://app.cubehosting.com.br/api/databases/$DATABASE_ID/start \
  -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}/start`, {
  method: 'POST',
  headers,
});
const { database } = await res.json();
console.log(database.status);

import os
import requests

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

r = requests.post(f"{API}/databases/{os.environ['DATABASE_ID']}/start", headers=headers, timeout=120)
r.raise_for_status()
print(r.json()["database"]["status"])

{
  "database": {
    "id": "01J9A2C4E6G8J0K2M4P6R8T0V2",
    "name": "loja-db",
    "engine": "postgres",
    "engineName": "PostgreSQL",
    "host": "loja-db",
    "port": 5432,
    "status": "running",
    "memoryMb": 512,
    "usage": {
      "memoryMb": 61
    },
    "disk": {
      "usedMb": 47,
      "limitMb": 2048
    },
    "startedAt": "2026-09-28T12:26:03.000Z",
    "createdAt": "2026-09-28T12:26:00.000Z",
    "updatedAt": "2026-09-28T12:26:01.000Z"
  }
}

O banco só liga se couber no plano: a memória dele, somada à dos projetos e bancos ligados, e o número de bancos ligados. A resposta chega quando ele subiu; em alguns segundos o status passa de starting a running.

Erros comuns

Código	HTTP	O que fazer
`plan_limit_reached`	422	Pare um projeto ou outro banco, ou mude de plano.
`database_limit_reached`	403	Pare outro banco ou mude de plano.
`database_busy`	409	Espere a ação em andamento (como o backup do dia) terminar.
`account_suspended`	409	Pague a renovação em Plano e cobrança.
`insufficient_permission`	403	Use uma chave de leitura e escrita.

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

O banco depois da ação.

database

object

obrigatório

Um banco de dados da conta: PostgreSQL, MySQL, MongoDB ou Redis.

Show child attributes

Visão geral

Projetos

Controle

Logs e métricas

Variáveis de ambiente

Backups

Versões dos envios

Bancos de dados

Blob

Avisos

Conta

Erros comuns

Autorizações

Parâmetros de caminho

Resposta

​Erros comuns

Autorizações

Parâmetros de caminho

Resposta

Erros comuns