> ## Documentation Index > Fetch the complete documentation index at: https://docs.cubehosting.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Restaurar como novo > Cria um projeto com outro ID a partir do backup de um projeto apagado, parado até você iniciar. 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 (o que o backup guardou vem em `hasConfig` e `hasVariables` na [lista](/api-reference/backups/list-account)) e, num site, o subdomínio de antes, se ainda estiver livre. Ele passa por `installing` e termina **parado**: confira e ligue com [Iniciar](/api-reference/projects/start). O backup continua guardado até vencer. Guia em [Backups](/hosting/backups#restaurar-como-novo). ## Erros comuns | Código | HTTP | O que fazer | | - | - | - | | [`not_found`](/errors#param-not-found) | 404 | O backup não existe ou não é da sua conta. Confira em [Listar os backups da conta](/api-reference/backups/list-account). | | [`backup_not_ready`](/errors#param-backup-not-ready) | 409 | Use um backup com `status` `ready`. | | [`project_limit_reached`](/errors#param-project-limit-reached) | 403 | O plano já tem todos os projetos que permite. Exclua um ou mude de plano. | | [`insufficient_memory`](/errors#param-insufficient-memory) | 422 | Libere memória do plano (reduza ou exclua outro projeto ou banco) e restaure de novo. | | [`missing_config`](/errors#param-missing-config) | 422 | Backup antigo sem a configuração: baixe o `.zip` e envie pelo Novo projeto. | | [`insufficient_permission`](/errors#param-insufficient-permission) | 403 | Use uma chave de leitura e escrita. | | [`too_many_requests`](/errors#param-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](/errors). ## OpenAPI ````yaml POST /account/backups/{backupId}/restore-as-new openapi: 3.1.0 info: title: API da Cube Hosting version: 1.0.0 description: >- Hospede bots de Discord, sites e APIs em Node.js e Python: envie o .zip, inicie, pare, reinicie, leia logs e métricas, cuide das variáveis de ambiente, faça e baixe backups, volte para uma versão anterior, crie bancos de dados (PostgreSQL, MySQL, MongoDB e Redis), guarde arquivos privados no Blob, use um domínio seu nos sites e veja o uso do plano. Para agentes de IA, o servidor MCP da conta (`POST https://app.cubehosting.com.br/api/mcp`, JSON-RPC, com a mesma chave) está em https://docs.cubehosting.com.br/account-mcp. contact: name: Cube Hosting url: https://discord.gg/pv6D9tUsDV servers: - url: https://app.cubehosting.com.br/api security: - bearerAuth: [] tags: - name: Projetos - name: Controle - name: Logs e métricas - name: Variáveis de ambiente - name: Backups - name: Versões dos envios - name: Bancos de dados - name: Blob - name: Domínios - name: Templates - name: Avisos - name: Conta paths: /account/backups/{backupId}/restore-as-new: post: tags: - Backups summary: Restaurar como novo description: >- Cria um projeto **com outro ID** a partir de um backup `ready` da conta (o de um projeto apagado, de [Listar os backups da conta](/api-reference/backups/list-account)), pelo mesmo caminho de criar um projeto: o código do backup, a configuração que o projeto tinha no momento dele (nome, tipo, linguagem e versão, comando, arquivo principal, memória, porta, build) e as mesmas variáveis de ambiente, cifradas de novo para o projeto novo. Num site, o subdomínio de antes volta se estiver livre; se não, sai outro. A memória sobe até o mínimo do plano de agora, se estava abaixo. O projeto passa por `installing` e termina **parado**: você inicia quando conferir. Vale como um envio: precisa caber no plano, a conta não pode estar suspensa e conta no limite de 1 envio a cada 3 s. Backup de antes de a configuração ir junto (até 28/09/2026, `hasConfig: false` na lista) usa o `cube.json` do `.zip` e volta sem as variáveis; sem o `cube.json`, `missing_config`. Precisa da chave de **leitura e escrita**. operationId: restoreBackupAsNew parameters: - $ref: '#/components/parameters/BackupId' responses: '201': description: >- Projeto novo criado a partir do backup, instalando as dependências. Ele termina **parado**. content: application/json: schema: type: object required: - project properties: project: $ref: '#/components/schemas/Project' example: 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 root: null 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' '401': description: Chave ausente, inválida ou revogada. content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalid_api_key: summary: invalid_api_key value: status: error code: invalid_api_key message: >- Chave de API inválida ou revogada. Confira o cabeçalho "Authorization: Bearer " ou crie outra em Chaves de API no painel. '403': description: A chave é só de leitura, ou o plano não comporta este projeto. content: application/json: schema: $ref: '#/components/schemas/Error' examples: insufficient_permission: summary: insufficient_permission value: status: error code: insufficient_permission message: >- Esta chave é só de leitura. Para enviar, iniciar, parar, reiniciar, mexer nas variáveis, fazer, baixar e restaurar backups, baixar e voltar versões dos envios, criar, ligar, desligar, fazer backup e ver a senha dos bancos de dados ou enviar e apagar arquivos do Blob, crie uma chave de leitura e escrita no painel. project_limit_reached: summary: project_limit_reached value: status: error code: project_limit_reached message: >- O plano Free permite até 1 bot. Exclua um projeto ou mude de plano. limit: 1 site_not_allowed: summary: site_not_allowed value: status: error code: site_not_allowed message: >- O plano Free não inclui sites. Mude para um plano pago para hospedar sites e APIs. site_limit_reached: summary: site_limit_reached value: status: error code: site_limit_reached message: >- O plano Block permite até 2 sites. Exclua um site ou mude de plano. limit: 2 '404': description: >- O backup não existe ou não é da sua conta (a mesma resposta para os dois). content: application/json: schema: $ref: '#/components/schemas/Error' examples: not_found: summary: not_found value: status: error code: not_found message: Backup não encontrado. '409': description: >- O backup não está pronto, os servidores estão cheios, ou a conta está suspensa, no fim do beta ou sem a vaga do Free. content: application/json: schema: $ref: '#/components/schemas/Error' examples: backup_not_ready: summary: backup_not_ready value: status: error code: backup_not_ready message: >- Este backup ainda não está pronto (ou não deu certo). Espere terminar ou use outro. no_capacity: summary: no_capacity value: status: error code: no_capacity message: >- Nossos servidores estão cheios agora e não dá para liberar mais memória. Tente de novo mais tarde: estamos abrindo mais espaço. account_suspended: summary: account_suspended value: status: error code: account_suspended message: >- Sua conta está suspensa porque o Pix da renovação não foi pago, então os projetos ficam parados. Pague em Plano e cobrança: a conta volta na hora, e o que estava no ar sobe sozinho. beta_ending: summary: beta_ending value: status: error code: beta_ending message: >- Seu beta terminou e a conta está voltando ao plano Free. Espere alguns minutos e tente de novo. free_slot_lost: summary: free_slot_lost value: status: error code: free_slot_lost message: >- Sua vaga do Free acabou porque a meta de mensagens da semana no Discord não foi batida, então os projetos ficam parados. Os arquivos continuam guardados: assine um plano em Plano e cobrança para ligar de novo. account_suspended_manually: summary: account_suspended_manually value: status: error code: account_suspended_manually message: >- Sua conta foi suspensa pela equipe da Cube: Página de phishing em loja.cubehost.dev. Os projetos ficam parados e nada sobe até a suspensão sair. Fale com o suporte no Discord para resolver. '422': description: >- O backup não abriu, não tem a configuração, ou não cabe na memória do plano. Nada foi criado. content: application/json: schema: $ref: '#/components/schemas/Error' examples: insufficient_memory: summary: insufficient_memory value: status: error code: insufficient_memory message: >- Este bot pede 256 MB, mas o plano Block só tem 124 MB livres somando projetos e bancos de dados. Exclua ou reduza outro projeto ou banco, ou mude de plano, e restaure de novo. freeMemoryMb: 124 requestedMemoryMb: 256 missing_config: summary: missing_config value: status: error code: missing_config message: >- Este backup é de antes de a Cube guardar a configuração junto e não tem cube.json, então não dá para saber como iniciar o projeto. Baixe o backup e envie o .zip pelo Novo projeto, informando a linguagem e o comando de início. invalid_backup: summary: invalid_backup value: status: error code: invalid_backup message: >- Este backup não pôde ser aberto, e nada foi criado. Tente outro backup. '429': description: Limite de pedidos. Traz o cabeçalho `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' examples: rate_limit_exceeded: summary: rate_limit_exceeded value: status: error code: rate_limit_exceeded message: >- A sua conta passou do limite da API do plano Free: 10 pedidos por minuto. Espere 42 s e tente de novo. too_many_requests: summary: too_many_requests value: status: error code: too_many_requests message: >- Muitas requisições seguidas. Espere alguns segundos e tente de novo. too_many_attempts: summary: too_many_attempts value: status: error code: too_many_attempts message: Muitas tentativas. Tente de novo em 15 minutos. '503': description: >- O servidor dos projetos, o armazenamento dos backups ou as variáveis não responderam. Nada foi criado. content: application/json: schema: $ref: '#/components/schemas/Error' examples: server_unavailable: summary: server_unavailable value: status: error code: server_unavailable message: >- O servidor dos projetos não respondeu. Tente de novo em instantes. backups_unavailable: summary: backups_unavailable value: status: error code: backups_unavailable message: >- Os backups não estão disponíveis agora. Tente de novo em instantes. variables_unavailable: summary: variables_unavailable value: status: error code: variables_unavailable message: >- As variáveis de ambiente do projeto não puderam ser abertas agora. Tente de novo em instantes. '507': description: >- Os arquivos do backup não cabem no espaço de um projeto novo. Nada foi criado. content: application/json: schema: $ref: '#/components/schemas/Error' examples: restore_no_space: summary: restore_no_space value: status: error code: restore_no_space message: >- Os arquivos deste backup não cabem no espaço de um projeto novo, e nada foi criado. Baixe o backup, tire o que o projeto não usa e envie como um projeto novo. x-codeSamples: - lang: bash label: curl source: >- curl -X POST https://app.cubehosting.com.br/api/account/backups/$BACKUP_ID/restore-as-new \ -H "Authorization: Bearer $CUBE_API_KEY" - lang: javascript label: Node.js source: >- 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 - lang: python label: Python source: |- 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"]) components: parameters: BackupId: name: backupId in: path required: true description: O ID do backup (UUID), de [Listar backups](/api-reference/backups/list). schema: type: string format: uuid example: 5b0c7a4e-2f1d-4c8e-9a36-7d2b1e0f4c11 schemas: Project: type: object description: 'Um projeto: um bot ou um site.' required: - id - name - description - type - language - version - entry - command - root - memoryMb - port - subdomain - url - status - error - hasAutoRestart - consecutiveCrashes - lastExit - usage - startedAt - templateId - restoredFromBackupId - createdAt - updatedAt properties: id: type: string description: ID do projeto, 26 caracteres. name: type: string maxLength: 40 description: Nome do projeto. description: type: string maxLength: 200 description: Descrição do painel. `""` quando não tem. type: type: string enum: - bot - site language: type: string enum: - node - python - static description: >- `static` é o [site só de HTML](/hosting/static-site), servido pela Cube. version: type: string description: >- `20`, `22` ou `24` (Node.js); `3.11` ou `3.12` (Python); `""` no `static`. entry: type: - string - 'null' description: >- Arquivo principal: o arquivo que o comando roda, relativo à raiz do projeto (como `index.js` ou `src/bot.py`). Vem do `command` quando ele é só `node ` ou `python `, e muda em Configurações › Geral. `null` com um comando próprio, como `npm start`. command: type: string description: >- Comando de início, o que de fato roda. Quando é `node ` ou `python `, o painel mostra o campo vazio (vazio = roda o arquivo principal). `""` no `static`. root: type: - string - 'null' description: >- Só `static`: a pasta servida, relativa à raiz do projeto (`""` = a raiz). `null` em `node` e `python`. memoryMb: type: integer description: Memória reservada, em MB. É também o teto do processo. port: type: - integer - 'null' description: >- Só site: a porta em que o app escuta (também na variável `PORT`). `null` em bot. subdomain: type: - string - 'null' description: 'Só site: o nome em `nome.cubehost.dev`. `null` em bot.' url: type: - string - 'null' format: uri description: 'Só site: o endereço público com HTTPS. `null` em bot.' status: $ref: '#/components/schemas/ProjectStatus' error: oneOf: - $ref: '#/components/schemas/ProjectError' - type: 'null' description: O motivo, quando `status` é `error` ou `crash_loop`. hasAutoRestart: type: boolean description: '`true` nos planos pagos: o projeto volta sozinho se cair.' consecutiveCrashes: type: integer description: >- Quedas seguidas desde a última vez que rodou 60 segundos sem cair. Com 5, o projeto vai para `crash_loop`. lastExit: oneOf: - $ref: '#/components/schemas/LastExit' - type: 'null' description: A última vez que o processo terminou. usage: oneOf: - $ref: '#/components/schemas/Usage' - type: 'null' description: O uso de agora. Só com `status` `running`. startedAt: type: - string - 'null' format: date-time description: >- Quando o processo subiu (o "tempo no ar" do painel). Só com `running`. templateId: type: - string - 'null' description: >- O [template](/hosting/templates) de onde o projeto nasceu, como `discord-js-bot`. `null` num `.zip` ou pelo GitHub, e volta a `null` quando o código é trocado por outro `.zip` ou pelo GitHub. Enquanto está preenchido, o projeto só inicia com as variáveis obrigatórias do template (`missing_variables`). restoredFromBackupId: type: - string - 'null' format: uuid description: >- O backup de onde o projeto nasceu pelo [Restaurar como novo](/api-reference/backups/restore-as-new). `null` nos outros. createdAt: type: string format: date-time updatedAt: type: string format: date-time Error: type: object required: - status - code - message properties: status: type: string const: error code: type: string description: Código fixo em inglês. Veja [Códigos de erro](/errors). message: type: string description: Texto em português para mostrar a uma pessoa. additionalProperties: true ProjectStatus: type: string enum: - creating - installing - running - stopped - restarting - crash_loop - error description: >- `creating` (Enviando), `installing` (Instalando), `running` (No ar), `stopped` (Parado), `restarting` (Reiniciando), `crash_loop` (Em loop de erro), `error` (Com erro). ProjectError: type: object required: - code - message properties: code: type: string enum: - install_failed - install_timeout - install_out_of_memory - install_interrupted - start_failed - process_exited - crash_loop description: >- Veja [Estados de erro do projeto](/errors#estados-de-erro-do-projeto). message: type: string description: Explicação em português. LastExit: type: object required: - code - isOutOfMemory - exitedAt properties: code: type: integer description: O código de saída do processo. isOutOfMemory: type: boolean description: '`true` se o processo passou da memória do projeto.' exitedAt: type: string format: date-time Usage: type: object required: - memoryMb - cpuPercent - networkInBps - networkOutBps properties: memoryMb: type: integer description: Memória em uso, em MB. cpuPercent: type: number description: Uso de processador. 100 = um núcleo inteiro. networkInBps: type: integer description: Rede recebida, em bytes por segundo. networkOutBps: type: integer description: Rede enviada, em bytes por segundo. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Chave de API da Cube (`cube_…`), criada no painel em **Chaves de API**. Mande como `Authorization: Bearer cube_…`. ````