Ver um projeto

curl

curl https://app.cubehosting.com.br/api/projects/$PROJECT_ID \
  -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}`, { headers });
const { project } = await res.json();
console.log(project.status, project.usage?.memoryMb);

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(f"{API}/projects/{os.environ['PROJECT_ID']}", headers=headers, timeout=30)
r.raise_for_status()
project = r.json()["project"]
print(project["status"], project["usage"])

{
  "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"
  }
}

GET

projects

{id}

curl

curl https://app.cubehosting.com.br/api/projects/$PROJECT_ID \
  -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}`, { headers });
const { project } = await res.json();
console.log(project.status, project.usage?.memoryMb);

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(f"{API}/projects/{os.environ['PROJECT_ID']}", headers=headers, timeout=30)
r.raise_for_status()
project = r.json()["project"]
print(project["status"], project["usage"])

{
  "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"
  }
}

Um projeto da sua conta, com o status e o uso de agora. Útil para acompanhar a instalação depois de criar ou enviar código novo: consulte até o status sair de installing. Quando o status é error ou crash_loop, o campo error diz o motivo. Veja Estados de erro do projeto.

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

O projeto.

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