Pular para o conteúdo principal
POST
Copiar ou mover um objeto de blob
Copia um objeto de blob para um novo path na mesma conta, ou o move quando move é true. Uma movimentação mantém o id do objeto e altera apenas o path, então não aumenta o armazenamento. Uma cópia cria um novo objeto com um novo id, e os seus bytes contam para a cota. Escopo: blob:write.
string
obrigatório
ID do objeto a ser copiado ou movido.
string
obrigatório
Caminho de destino, com as mesmas regras de Enviar em uma requisição.
boolean
true move o objeto e mantém o seu ID. Padrão false: cópia.
boolean
Substitui um objeto que já existe em path. Padrão false.
boolean
Insere um sufixo aleatório antes da extensão. Padrão false.
boolean
Somente em cópias: quando path está ocupado, inclusive pelo próprio objeto de origem, salva a cópia como nome-1.ext, nome-2.ext e assim por diante, em vez de retornar BLOB_OBJECT_ALREADY_EXISTS. Padrão false. Não pode ser combinado com overwrite e é ignorado em uma movimentação.
string
public ou private para o novo objeto. Padrão: a visibilidade do objeto de origem.
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 objeto no novo caminho.

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.
  • BLOB_NAMESPACE_SUSPENDED (403): o armazenamento de blob da conta está suspenso, ou o plano expirou. Uploads e outras gravações são recusados desde o início do período de carência de 72 horas.
  • VALIDATION_ERROR (400): um parâmetro ou campo do corpo falhou na validação. details.path informa o campo.
  • BLOB_OBJECT_NOT_FOUND (404): o source não existe nesta conta.
  • BLOB_OBJECT_ALREADY_EXISTS (409): path está ocupado e overwrite não é true.
  • STORAGE_QUOTA_EXCEEDED (403): uma cópia ultrapassaria a cota de blob do plano. Movimentações não aumentam o armazenamento, então não são bloqueadas por ele.
  • BLOCKED_FILE_TYPE (422): a extensão de destino está bloqueada ou não é permitida pela regra da pasta.
Última modificação em 28 de outubro de 2026