Pular para o conteúdo principal
POST
curl
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)

O jeito mais simples é o workflow com a CLI cube: ele respeita o .gitignore e o .cubeignore, confere o limite do plano e espera a instalação. Só com curl, guarde a chave com a permissão projects:deploy como segredo CUBE_API_KEY e o ID do projeto como variável CUBE_PROJECT_ID:
.github/workflows/deploy.yml

Erros comuns

Todos os códigos, com o formato do erro, em Códigos de erro.

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_…. Cada rota pede uma permissão da chave (o escopo no security da rota, como files:write); sem ela, 403 insufficient_scope com o requiredScope. Veja Chaves de API.

Scopes

projects:deploy

Parâmetros de caminho

id
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
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.

isReinstallingDependencies
boolean
obrigatório

true quando as dependências vão ser instaladas de novo; false quando só o build (se houver) roda.

hints
object[]
obrigatório

O que a análise do envio avisa (o compilado no lugar do código-fonte, as pastas que saíram por serem geradas no build). Vazia quando não há nada a avisar.