Pular para o conteúdo principal
PATCH
Atualizar imagem
Altera o name e/ou a description da imagem. Nada é construído nem reiniciado: a imagem mantém o ID e as versões, e os apps criados a partir dela continuam rodando. Envie apenas os campos que quer alterar; pelo menos um é obrigatório. Imagens da plataforma (owner: "system") não podem ser alteradas. Precisa do escopo images:write quando chamado com uma chave de API. Em um workspace, você precisa de permissão para gerenciar os apps do workspace.
string
obrigatório
O ID da imagem.
string
Se a imagem pertencer a um workspace, o ID do workspace.
string
O novo nome: de 1 a 50 caracteres, único entre as imagens do dono. Enviar o nome atual não é erro. Um nome já usado por outra imagem sua falha com VALIDATION_ERROR, com path igual a name.
string | null
A nova descrição, de até 128 caracteres (texto livre). null ou uma string vazia a remove.

Resposta

object
A imagem atualizada.

Respostas de erro

string
O código de erro que indica o motivo da falha. Valores possíveis:
  • API_KEY_SCOPE_DENIED: A chave de API não tem o escopo necessário (403).
  • VALIDATION_ERROR: O corpo está vazio, o nome não tem de 1 a 50 caracteres, o nome já é usado por outra imagem sua (path é name), a descrição passa de 128 caracteres, ou o nome ou a descrição têm caracteres de controle (400).
  • ACCESS_DENIED: A imagem é da plataforma, que não pode ser alterada (403).
  • IMAGE_NOT_FOUND: A imagem não existe ou você não tem acesso a ela (404).
  • INTERNAL_SERVER_ERROR: Falha inesperada (500).
Última modificação em 28 de outubro de 2026