Skip to main content
PUT
curl
Manda um arquivo cru, em partes de até 16 MB, com o mesmo uploadId em cada uma. Com o último byte, o arquivo vai para o lugar. A CLI faz isso com cube files put. Permissão da chave: files:write (Chaves de API).

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.

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"

Parâmetros de consulta

path
string
obrigatório

Caminho relativo à raiz do projeto, sem / no começo (ex.: src/index.js).

Maximum string length: 4096
uploadId
string
obrigatório
Pattern: ^[A-Za-z0-9_-]{8,64}$
offset
integer
obrigatório
Intervalo obrigatório: x >= 0
totalBytes
integer
obrigatório
Intervalo obrigatório: 0 <= x <= 524288000
shouldOverwrite
enum<string>
padrão:false
Opções disponíveis:
true,
false

Corpo

application/octet-stream

A parte, até 16 MB.

Resposta

A parte chegou; com o último byte, o arquivo está no lugar.

path
string
obrigatório
isComplete
boolean
obrigatório
receivedBytes
integer

Até aqui (sem o fim).

sizeBytes
integer

Com o fim.