Restaurar um backup

{
  "project": {
    "id": "01J8Z3W6N0Q4Y7V2K5T9D1H3XA",
    "name": "Meu bot",
    "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,
    "createdAt": "2026-09-26T18:00:00.000Z",
    "updatedAt": "2026-09-26T18:01:10.000Z"
  },
  "isReinstallingDependencies": false
}

POST

projects

{id}

backups

{backupId}

restore

{
  "project": {
    "id": "01J8Z3W6N0Q4Y7V2K5T9D1H3XA",
    "name": "Meu bot",
    "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,
    "createdAt": "2026-09-26T18:00:00.000Z",
    "updatedAt": "2026-09-26T18:01:10.000Z"
  },
  "isReinstallingDependencies": false
}

Precisa da chave de leitura e escrita. O projeto para antes da troca e termina parado: confira os arquivos e ligue com Iniciar. As dependências só reinstalam se o package.json ou o requirements.txt mudou.

Erros comuns

Código	HTTP	O que fazer
`project_busy`	409	O projeto está sendo enviado ou instalado. Espere terminar.
`backup_not_ready`	409	Use um backup com `status` `ready`.
`insufficient_permission`	403	Use uma chave de leitura e escrita.
`invalid_backup`	422	O backup não abriu: os arquivos ficam como estavam. Use outro.
`restore_no_space`	507	Sem espaço para a troca agora. Nada mudou.

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 projeto (26 caracteres). Aparece no painel, no topo do projeto, e em GET /projects.

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

Exemplo:

"01J8Z3W6N0Q4Y7V2K5T9D1H3XA"

backupId

string<uuid>

obrigatório

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

Exemplo:

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

Resposta

Arquivos trocados pelos do backup. O projeto passa por installing e termina parado: quem liga é você.

project

object

obrigatório

Um projeto: um bot ou um site.

Show child attributes

isReinstallingDependencies

boolean

obrigatório

true quando as dependências vão ser instaladas de novo; false quando só o build (se houver) roda.

Visão geral

Projetos

Controle

Logs e métricas

Variáveis de ambiente

Backups

Versões dos envios

Bancos de dados

Avisos

Conta

Erros comuns

Autorizações

Parâmetros de caminho

Resposta

​Erros comuns

Autorizações

Parâmetros de caminho

Resposta

Erros comuns