Parar um projeto

curl

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

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']}/stop", 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": "stopped",
    "error": null,
    "hasAutoRestart": true,
    "consecutiveCrashes": 0,
    "lastExit": {
      "code": 143,
      "isOutOfMemory": false,
      "exitedAt": "2026-09-26T19:30:00.000Z"
    },
    "usage": null,
    "startedAt": null,
    "createdAt": "2026-09-26T18:00:00.000Z",
    "updatedAt": "2026-09-26T18:01:10.000Z"
  }
}

POST

projects

{id}

stop

curl

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

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']}/stop", 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": "stopped",
    "error": null,
    "hasAutoRestart": true,
    "consecutiveCrashes": 0,
    "lastExit": {
      "code": 143,
      "isOutOfMemory": false,
      "exitedAt": "2026-09-26T19:30:00.000Z"
    },
    "usage": null,
    "startedAt": null,
    "createdAt": "2026-09-26T18:00:00.000Z",
    "updatedAt": "2026-09-26T18:01:10.000Z"
  }
}

Para o projeto e desliga o reinício automático até o próximo início. O processo recebe o aviso para encerrar e tem 10 segundos para terminar o que está fazendo. Parar funciona inclusive com a conta suspensa. Só não dá durante o envio e a instalação (409 project_busy). A memória do projeto continua reservada: para liberar, diminua a memória ou exclua o projeto pelo painel.

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