Pular para o conteúdo principal
POST
Adicionar um domínio personalizado para o armazenamento de blob
Adiciona um subdomínio, como cdn.example.com, que serve os arquivos públicos de blob da conta. Crie um registro CNAME desse hostname apontando para cname_target e o registro TXT de verification, depois chame Verificar um domínio personalizado. A quantidade de domínios depende do plano: 0 abaixo do Enterprise-4, depois 1, 3 e 10. Retorna 201. Escopo: blob:write.
string
obrigatório
Somente o subdomínio, sem esquema nem caminho.
string
Servir somente esta pasta no domínio. Omita-o para servir a conta inteira.
boolean
O padrão é false. Quando true, o domínio serve arquivos .html, .htm, .xhtml, .svg e .xml no navegador com o tipo real, em sandbox. Veja Domínios personalizados.
string
O ID do workspace, quando o blob pertence a um workspace. A chamada atua sobre o blob do proprietário do workspace e exige a permissão blob:read do workspace (blob:manage nas rotas que alteram dados). Deixe de fora para atuar sobre o seu próprio blob.

Exemplo de requisição

Resposta

object
O domínio, ainda como pending até que o CNAME seja encontrado e o registro TXT de posse seja verificado. Ele só passa a active depois dos dois. Responde com 201.

Respostas de erro

string
O código de erro que indica o motivo da falha. Valores possíveis:
  • AUTH_TOKEN_MISSING (401): o cabeçalho Authorization não foi enviado.
  • API_KEY_INVALID (401): a chave de API não existe, foi revogada ou o segredo não confere.
  • API_KEY_SCOPE_DENIED (403): a chave não tem o escopo que esta rota exige (blob:read ou blob:write); details.required informa qual.
  • WORKSPACE_PERMISSION_DENIED (403): somente com workspace_id: você não é membro, ou o seu papel não tem a permissão de blob.
  • WORKSPACE_NOT_FOUND (404): somente com workspace_id: não existe workspace com esse ID, ou você não é membro.
  • VALIDATION_ERROR (400): um parâmetro ou campo do corpo falhou na validação. details.path informa o campo.
  • INVALID_CUSTOM_DOMAIN_FORMAT (400): o hostname não é um subdomínio válido.
  • PLAN_RESTRICTED_FEATURE (403): o plano não tem domínios personalizados (abaixo do Enterprise-4).
  • BLOB_NAMESPACE_SUSPENDED (403): o armazenamento de blob da conta está suspenso, ou o plano expirou.
  • BLOB_CUSTOM_DOMAIN_LIMIT (409): o plano inclui domínios personalizados e o limite foi atingido.
  • BLOB_CUSTOM_DOMAIN_TAKEN (409): o hostname já está em uso.
Última modificação em 28 de outubro de 2026