Skip to main content
PATCH
curl
Cada arquivo do Blob é público ou privado:
  • Público: o arquivo ganha o publicUrl, como https://cdn.cubehost.dev/q7Rf2kLm9xA1/logo.png. O link é fixo, não vence e abre sem chave: a imagem abre no navegador (bom para o avatar de um bot, o banner de um site ou um anexo numa mensagem), e o resto baixa como anexo.
  • Privado (o padrão pela API e pela CLI): só abre por link temporário, que vence.
Tornar privado derruba o link público na hora: quando a resposta chega, o link já responde 404. Tornar público de novo volta o mesmo link. Apagar o arquivo também tira os links do ar.
Já quer o arquivo público no envio? Mande visibility: "public" em Pedir o envio: o publicUrl vem na confirmação.

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

Parâmetros de caminho

id
string
obrigatório

O ID do arquivo do Blob (26 caracteres), de Listar arquivos do Blob.

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
Exemplo:

"01JA3F7K2M9P4R6T8V0X1Z3B5D"

Corpo

application/json
visibility
enum<string>
obrigatório
Opções disponíveis:
public,
private

Resposta

O arquivo, com a visibilidade nova.

object
object
obrigatório