Pular para o conteúdo principal
GET
curl
Cada .zip enviado (pelo painel, pela CLI ou pela API) aparece aqui e fica guardado como versão: isRestorable diz se ainda dá para baixar e voltar para ele, e isCurrent marca o que está no projeto agora (depois de voltar, a versão da volta). O plano define quantas ficam (versionLimit), as usadas por último (activatedAt: o envio ou a volta mais recente), por até 30 dias (retentionDays). A lista traz os 20 últimos e, além deles, toda versão ainda guardada. apiKeyName diz qual chave enviou (null quando foi pelo painel). Guia completo em Versões e voltar atrás.

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

deployments:read

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"

Resposta

O histórico e as regras do plano.

deployments
object[]
obrigatório

Os 20 últimos e as versões ainda guardadas, do mais novo para o mais antigo.

versionLimit
integer
obrigatório

Quantas versões (.zip enviados) o plano guarda por projeto, as usadas por último: Free 2 (a de agora e a anterior), Block 3, Stack 5, Tower 7, Fortress 10, Monolith 14.

retentionDays
integer
obrigatório

Por quantos dias no máximo uma versão fica guardada.