Restaurar como novo

curl

curl -X POST https://app.cubehosting.com.br/api/account/backups/$BACKUP_ID/restore-as-new \
  -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/${process.env.BACKUP_ID}/restore-as-new`, {
  method: 'POST',
  headers,
});
const { project } = await res.json();
console.log(project.id, project.status); // installing, depois stopped

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}/account/backups/{os.environ['BACKUP_ID']}/restore-as-new",
    headers=headers,
    timeout=780,
)
r.raise_for_status()
print(r.json()["project"]["id"])

{
  "project": {
    "id": "01J8Z6D4S2U7W9Y1A3C5E7G9JM",
    "name": "Bot antigo",
    "description": "Atende o servidor da loja",
    "type": "bot",
    "language": "node",
    "version": "24",
    "entry": "index.js",
    "command": "node index.js",
    "memoryMb": 256,
    "port": null,
    "subdomain": null,
    "url": null,
    "status": "installing",
    "error": null,
    "hasAutoRestart": true,
    "consecutiveCrashes": 0,
    "lastExit": null,
    "usage": null,
    "startedAt": null,
    "templateId": null,
    "restoredFromBackupId": "7c1d9e2f-3a4b-4c5d-8e6f-0a1b2c3d4e5f",
    "createdAt": "2026-09-26T18:00:00.000Z",
    "updatedAt": "2026-09-26T18:01:10.000Z"
  }
}

POST

account

backups

{backupId}

restore-as-new

curl

curl -X POST https://app.cubehosting.com.br/api/account/backups/$BACKUP_ID/restore-as-new \
  -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/${process.env.BACKUP_ID}/restore-as-new`, {
  method: 'POST',
  headers,
});
const { project } = await res.json();
console.log(project.id, project.status); // installing, depois stopped

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}/account/backups/{os.environ['BACKUP_ID']}/restore-as-new",
    headers=headers,
    timeout=780,
)
r.raise_for_status()
print(r.json()["project"]["id"])

{
  "project": {
    "id": "01J8Z6D4S2U7W9Y1A3C5E7G9JM",
    "name": "Bot antigo",
    "description": "Atende o servidor da loja",
    "type": "bot",
    "language": "node",
    "version": "24",
    "entry": "index.js",
    "command": "node index.js",
    "memoryMb": 256,
    "port": null,
    "subdomain": null,
    "url": null,
    "status": "installing",
    "error": null,
    "hasAutoRestart": true,
    "consecutiveCrashes": 0,
    "lastExit": null,
    "usage": null,
    "startedAt": null,
    "templateId": null,
    "restoredFromBackupId": "7c1d9e2f-3a4b-4c5d-8e6f-0a1b2c3d4e5f",
    "createdAt": "2026-09-26T18:00:00.000Z",
    "updatedAt": "2026-09-26T18:01:10.000Z"
  }
}

Precisa da chave de leitura e escrita. O projeto novo vem com o código do backup, a configuração e as variáveis de ambiente que o projeto tinha e o subdomínio de antes, se ainda estiver livre. Ele passa por installing e termina parado: confira e ligue com Iniciar. O backup continua guardado até vencer. Guia em Backups.

Erros comuns

Código	HTTP	O que fazer
`not_found`	404	O backup não existe ou não é da sua conta. Confira em Listar os backups da conta.
`backup_not_ready`	409	Use um backup com `status` `ready`.
`project_limit_reached`	403	O plano já tem todos os projetos que permite. Exclua um ou mude de plano.
`insufficient_memory`	422	Libere memória do plano (reduza ou exclua outro projeto ou banco) e restaure de novo.
`missing_config`	422	Backup antigo sem a configuração: baixe o `.zip` e envie pelo Novo projeto.
`insufficient_permission`	403	Use uma chave de leitura e escrita.
`too_many_requests`	429	Um envio a cada 3 s por conta. Espere e tente de novo.

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

backupId

string<uuid>

obrigatório

O ID do backup (UUID), de Listar backups.

Exemplo:

"5b0c7a4e-2f1d-4c8e-9a36-7d2b1e0f4c11"

Resposta

Projeto novo criado a partir do backup, instalando as dependências. Ele termina parado.

project

object

obrigatório

Um projeto: um bot ou um site.

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

Erros comuns

Autorizações

Parâmetros de caminho

Resposta

​Erros comuns

Autorizações

Parâmetros de caminho

Resposta

Erros comuns