Aplicar as mudanças

curl

curl -X POST "https://app.cubehosting.com.br/api/projects/$PROJECT_ID/apply" \
  -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}/projects/${process.env.PROJECT_ID}/apply`, {
  method: 'POST',
  headers,
});
console.log((await res.json()).project.status); // installing

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}/projects/{os.environ['PROJECT_ID']}/apply",
    headers=headers,
    timeout=60,
)
r.raise_for_status()
print(r.json()["project"]["status"])

{
  "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",
    "installCommand": null,
    "root": null,
    "systemPackages": [],
    "memoryMb": 256,
    "port": null,
    "subdomain": null,
    "url": null,
    "internalHost": "cube-t9d1h3xa",
    "status": "installing",
    "error": null,
    "hasAutoRestart": true,
    "consecutiveCrashes": 0,
    "lastExit": null,
    "usage": null,
    "startedAt": null,
    "templateId": null,
    "restoredFromBackupId": null,
    "createdAt": "2026-09-26T18:00:00.000Z",
    "updatedAt": "2026-09-26T18:01:10.000Z"
  },
  "isReinstallingDependencies": false
}

POST

projects

{id}

apply

curl

curl -X POST "https://app.cubehosting.com.br/api/projects/$PROJECT_ID/apply" \
  -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}/projects/${process.env.PROJECT_ID}/apply`, {
  method: 'POST',
  headers,
});
console.log((await res.json()).project.status); // installing

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}/projects/{os.environ['PROJECT_ID']}/apply",
    headers=headers,
    timeout=60,
)
r.raise_for_status()
print(r.json()["project"]["status"])

{
  "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",
    "installCommand": null,
    "root": null,
    "systemPackages": [],
    "memoryMb": 256,
    "port": null,
    "subdomain": null,
    "url": null,
    "internalHost": "cube-t9d1h3xa",
    "status": "installing",
    "error": null,
    "hasAutoRestart": true,
    "consecutiveCrashes": 0,
    "lastExit": null,
    "usage": null,
    "startedAt": null,
    "templateId": null,
    "restoredFromBackupId": null,
    "createdAt": "2026-09-26T18:00:00.000Z",
    "updatedAt": "2026-09-26T18:01:10.000Z"
  },
  "isReinstallingDependencies": false
}

Depois de mexer nos arquivos, aplica as mudanças: reinstala só se o manifesto mudou. A CLI faz isso com cube apply. Permissão da chave: projects:deploy (Chaves de API).

Erros comuns

Código	HTTP	O que fazer
`insufficient_scope`	403	A chave não tem a permissão da rota (`requiredScope` diz qual): marque em Chaves de API › Editar permissões.
`account_suspended`	409	Pague a renovação em Plano e cobrança.
`account_suspended_manually`	409	Fale com o suporte no Discord.
`beta_ending`	409	Espere alguns minutos: a conta está voltando ao Free.
`project_busy`	409	Espere o envio ou a instalação em curso terminar.
`variables_unavailable`	503	Tente de novo em instantes. Nada foi alterado.

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_…. Cada rota pede uma permissão da chave (o escopo no security da rota, como files:write); sem ela, 403 insufficient_scope com o requiredScope. Veja Chaves de API.

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"

Resposta

A instalação começou (o projeto fica installing).

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

Templates

Controle

Logs e métricas

Análise

Variáveis de ambiente

Arquivos

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