Parar um banco

curl

curl -X POST https://app.cubehosting.com.br/api/databases/$DATABASE_ID/stop \
  -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}/stop`, {
  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']}/stop", 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": "stopped",
    "memoryMb": 512,
    "usage": null,
    "disk": {
      "usedMb": 47,
      "limitMb": 2048
    },
    "startedAt": null,
    "createdAt": "2026-09-28T12:26:00.000Z",
    "updatedAt": "2026-09-28T12:26:01.000Z"
  }
}

POST

databases

{id}

stop

curl

curl -X POST https://app.cubehosting.com.br/api/databases/$DATABASE_ID/stop \
  -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}/stop`, {
  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']}/stop", 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": "stopped",
    "memoryMb": 512,
    "usage": null,
    "disk": {
      "usedMb": 47,
      "limitMb": 2048
    },
    "startedAt": null,
    "createdAt": "2026-09-28T12:26:00.000Z",
    "updatedAt": "2026-09-28T12:26:01.000Z"
  }
}

Os dados ficam guardados e a memória continua reservada no plano. Os projetos que usam o banco perdem a conexão até você iniciar de novo. Parado, o banco não ganha o backup do dia.

Erros comuns

Código	HTTP	O que fazer
`database_busy`	409	Espere a ação em andamento (como o backup do dia) terminar.
`not_found`	404	O banco não existe ou não é da sua conta.
`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