Skip to main content
POST
curl
Envie o .zip como multipart/form-data no campo file. A configuração vem do cube.json na raiz do .zip, ou dos campos do formulário.
1

Envio

A Cube confere o tamanho, extrai o .zip e valida a configuração. Se algo estiver errado, nada é criado e a resposta diz o motivo.
2

Instalação

O projeto nasce em installing. As dependências são instaladas e o build roda, se houver. Acompanhe pelos logs com source=build.
3

Pronto

Com start=true, o projeto sobe sozinho (running). Sem ele, fica stopped até você iniciar.
Guarde tokens em variáveis de ambiente, não no .zip. Para um bot que precisa do token para entrar, crie o projeto sem start, defina as variáveis e depois inicie.

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_….

Corpo

multipart/form-data
file
file
obrigatório

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

start
enum<string>
padrão:false

true inicia o projeto assim que a instalação terminar.

Opções disponíveis:
true,
false
name
string

Nome do projeto. Vale se o cube.json não tiver name; sem nenhum, vira o nome do arquivo.

Required string length: 1 - 40
type
enum<string>

Mesmo significado da chave do cube.json.

Opções disponíveis:
bot,
site
language
enum<string>

Com language e command, o formulário vale e o cube.json é ignorado.

Opções disponíveis:
node,
python
version
string

20, 22 ou 24 (Node.js); 3.11 ou 3.12 (Python).

command
string

Comando de início, numa linha só.

Maximum string length: 500
memoryMb
integer

Memória em MB. Mínimo 100 (bot) ou 512 (site).

Intervalo obrigatório: x >= 100
port
integer

Só site. Padrão 8080.

Intervalo obrigatório: 1024 <= x <= 65535
subdomain
string

Só site. Sem ele, a Cube gera um.

build
string

Comando de build. Ausente = automático; vazio = sem build.

Maximum string length: 500

Resposta

Projeto criado, instalando as dependências.

project
object
obrigatório

Um projeto: um bot ou um site.