Iniciar um projeto

curl

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

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']}/start", 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",
    "command": "node index.js",
    "memoryMb": 256,
    "port": null,
    "subdomain": null,
    "url": null,
    "status": "running",
    "error": null,
    "hasAutoRestart": true,
    "consecutiveCrashes": 0,
    "lastExit": null,
    "usage": {
      "memoryMb": 83,
      "cpuPercent": 1.2,
      "networkInBps": 1200,
      "networkOutBps": 300
    },
    "startedAt": "2026-09-26T18:01:05.000Z",
    "createdAt": "2026-09-26T18:00:00.000Z",
    "updatedAt": "2026-09-26T18:01:10.000Z"
  }
}

POST

projects

{id}

start

curl

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

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']}/start", 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",
    "command": "node index.js",
    "memoryMb": 256,
    "port": null,
    "subdomain": null,
    "url": null,
    "status": "running",
    "error": null,
    "hasAutoRestart": true,
    "consecutiveCrashes": 0,
    "lastExit": null,
    "usage": {
      "memoryMb": 83,
      "cpuPercent": 1.2,
      "networkInBps": 1200,
      "networkOutBps": 300
    },
    "startedAt": "2026-09-26T18:01:05.000Z",
    "createdAt": "2026-09-26T18:00:00.000Z",
    "updatedAt": "2026-09-26T18:01:10.000Z"
  }
}

Liga o projeto e responde quando ele está de pé. Se ele já estava no ar, nada muda.

Só sobe o que cabe no plano: a memória deste projeto mais a dos que já estão ligados não pode passar a do plano (plan_limit_reached).
Se a última instalação falhou, envie o código de novo antes (install_pending).
Se a versão da linguagem mudou em Configurações, o projeto passa pela instalação antes de subir e a resposta é 202.

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"

Resposta

A ação terminou. O projeto vem com o status novo.

project

object

obrigatório

Um projeto: um bot ou um site.

Show child attributes

Visão geral

Projetos

Controle

Logs e métricas

Variáveis de ambiente

Autorizações

Parâmetros de caminho

Resposta