> ## 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 um backup > Troca os arquivos do projeto pelos do backup, sem ligar nada sozinho. Precisa da chave de **leitura e escrita**. O projeto para antes da troca e termina **parado**: confira os arquivos e ligue com [Iniciar](/api-reference/projects/start). As dependências só reinstalam se o `package.json` ou o `requirements.txt` mudou. ## Erros comuns | Código | HTTP | O que fazer | | ------------------------------------------------------------------ | ---- | -------------------------------------------------------------- | | [`project_busy`](/errors#param-project-busy) | 409 | O projeto está sendo enviado ou instalado. Espere terminar. | | [`backup_not_ready`](/errors#param-backup-not-ready) | 409 | Use um backup com `status` `ready`. | | [`insufficient_permission`](/errors#param-insufficient-permission) | 403 | Use uma chave de leitura e escrita. | | [`invalid_backup`](/errors#param-invalid-backup) | 422 | O backup não abriu: os arquivos ficam como estavam. Use outro. | | [`restore_no_space`](/errors#param-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](/errors). ## OpenAPI ````yaml POST /projects/{id}/backups/{backupId}/restore 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 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: Avisos - name: Conta paths: /projects/{id}/backups/{backupId}/restore: post: tags: - Backups summary: Restaurar um backup description: >- Troca os arquivos do projeto pelos do backup, pelo mesmo caminho seguro do painel: o projeto para antes, as dependências só reinstalam se o manifesto mudou, e ele termina **parado** (você liga quando conferir). Precisa da chave de **leitura e escrita**. Só backups `ready`. operationId: restoreBackup parameters: - $ref: '#/components/parameters/ProjectId' - $ref: '#/components/parameters/BackupId' responses: '202': description: >- Arquivos trocados pelos do backup. O projeto passa por `installing` e termina **parado**: quem liga é você. content: application/json: schema: $ref: '#/components/schemas/InstallStarted' example: 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 '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: restaurar pede a de leitura e escrita.' 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. Crie uma chave de leitura e escrita em Chaves de API. '404': description: O projeto ou o backup não existe ou não é da sua conta. 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 projeto está sendo preparado, o backup não está pronto, ou a conta está suspensa. content: application/json: schema: $ref: '#/components/schemas/Error' examples: project_busy: summary: project_busy value: status: error code: project_busy message: >- O projeto está sendo preparado ou já tem outra ação em andamento. Espere terminar. 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. '422': description: 'O backup não abriu: os arquivos ficam como estavam.' content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalid_backup: summary: invalid_backup value: status: error code: invalid_backup message: 'O backup não abriu inteiro: nada foi restaurado.' '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_attempts: summary: too_many_attempts value: status: error code: too_many_attempts message: Muitas tentativas. Tente de novo em 15 minutos. '503': description: 'Sem resposta no meio: o projeto fica parado.' content: application/json: schema: $ref: '#/components/schemas/Error' examples: server_unavailable: summary: server_unavailable value: status: error code: server_unavailable message: >- Não deu para confirmar a restauração: o projeto ficou parado. Confira os arquivos antes de ligar. '507': description: 'Sem espaço em disco para a troca: nada mudou.' content: application/json: schema: $ref: '#/components/schemas/Error' examples: restore_no_space: summary: restore_no_space value: status: error code: restore_no_space message: >- Não há espaço para restaurar este backup agora: os arquivos ficaram como estavam. components: parameters: ProjectId: name: id in: path required: true description: >- O ID do projeto (26 caracteres). Aparece no painel, no topo do projeto, e em `GET /projects`. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ example: 01J8Z3W6N0Q4Y7V2K5T9D1H3XA 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: InstallStarted: type: object required: - project - isReinstallingDependencies properties: project: $ref: '#/components/schemas/Project' isReinstallingDependencies: type: boolean description: >- `true` quando as dependências vão ser instaladas de novo; `false` quando só o build (se houver) roda. 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 Project: type: object description: 'Um projeto: um bot ou um site.' required: - id - name - description - type - language - version - entry - command - memoryMb - port - subdomain - url - status - error - hasAutoRestart - consecutiveCrashes - lastExit - usage - startedAt - 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 version: type: string description: '`20`, `22` ou `24` (Node.js); `3.11` ou `3.12` (Python).' 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). 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`. createdAt: type: string format: date-time updatedAt: type: string format: date-time 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_…`. ````