Enviar novo código

curl

curl https://app.cubehosting.com.br/api/projects/$PROJECT_ID/code \
  -H "Authorization: Bearer $CUBE_API_KEY" \
  -F "file=@meu-bot.zip"

import { openAsBlob } from 'node:fs';

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const form = new FormData();
form.set('file', await openAsBlob('meu-bot.zip'), 'meu-bot.zip');

const res = await fetch(`${API}/projects/${process.env.PROJECT_ID}/code`, {
  method: 'POST',
  headers,
  body: form,
});
const { project, isReinstallingDependencies } = await res.json();
console.log(project.status, isReinstallingDependencies);

import os
import requests

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

with open("meu-bot.zip", "rb") as zip:
    r = requests.post(
        f"{API}/projects/{os.environ['PROJECT_ID']}/code",
        headers=headers,
        files={"file": ("meu-bot.zip", zip, "application/zip")},
        timeout=300,
    )
r.raise_for_status()
print(r.json())

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

POST

projects

{id}

code

curl

curl https://app.cubehosting.com.br/api/projects/$PROJECT_ID/code \
  -H "Authorization: Bearer $CUBE_API_KEY" \
  -F "file=@meu-bot.zip"

import { openAsBlob } from 'node:fs';

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const form = new FormData();
form.set('file', await openAsBlob('meu-bot.zip'), 'meu-bot.zip');

const res = await fetch(`${API}/projects/${process.env.PROJECT_ID}/code`, {
  method: 'POST',
  headers,
  body: form,
});
const { project, isReinstallingDependencies } = await res.json();
console.log(project.status, isReinstallingDependencies);

import os
import requests

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

with open("meu-bot.zip", "rb") as zip:
    r = requests.post(
        f"{API}/projects/{os.environ['PROJECT_ID']}/code",
        headers=headers,
        files={"file": ("meu-bot.zip", zip, "application/zip")},
        timeout=300,
    )
r.raise_for_status()
print(r.json())

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

Atualiza o código de um projeto que já existe, como faria um deploy no CI. A configuração do projeto não muda.

O .zip novo substitui a pasta inteira do projeto (só as dependências instaladas ficam). Arquivos que o seu app criou, como um banco SQLite, somem se não estiverem no .zip.

Deploy a cada push (GitHub Actions)

Guarde uma chave de leitura e escrita como segredo CUBE_API_KEY e o ID do projeto como variável CUBE_PROJECT_ID:

.github/workflows/deploy.yml

name: Deploy na Cube
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Compactar
        run: zip -r projeto.zip . -x "node_modules/*" ".git/*" ".github/*"
      - name: Enviar
        run: |
          curl --fail-with-body \
            https://app.cubehosting.com.br/api/projects/${{ vars.CUBE_PROJECT_ID }}/code \
            -H "Authorization: Bearer ${{ secrets.CUBE_API_KEY }}" \
            -F "file=@projeto.zip"

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"

Corpo

multipart/form-data

file

obrigatório

O .zip com o código novo. Até 5 MB no Free e 10 MB nos planos pagos.

Resposta

Código recebido. O projeto passa por installing e volta ao estado que você deixou.

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

Controle

Logs e métricas

Variáveis de ambiente

Deploy a cada push (GitHub Actions)

Autorizações

Parâmetros de caminho

Corpo

Resposta

​Deploy a cada push (GitHub Actions)

Autorizações

Parâmetros de caminho

Corpo

Resposta

Deploy a cada push (GitHub Actions)