Excluir produto
Envia um produto para a lixeira (exclusão suave), de onde ele pode ser restaurado por 30 dias, e libera o SKU.
Use esta operação quando um item saiu definitivamente do catálogo e você quer tirá-lo da loja, das listas e da busca. A exclusão não apaga o registro: ela o marca como excluído e o envia para a lixeira. Um administrador pode restaurá-lo no painel por 30 dias; depois disso a limpeza automática o remove de vez. Os vínculos do produto (categorias, características, imagens, faixas de preço) são preservados, para a restauração devolver o produto completo.
Ao excluir, a plataforma também emite o evento product.deleted, que alimenta a busca (o item some dos resultados) e os webhooks da loja. O SKU do produto excluído fica livre para ser usado por outro produto.
/api/v1/admin/products/{id}AdminExclui um produto
Autenticação: Authorization: Bearer <token> de um usuário administrador com o privilégio manage_catalog. O usuário que excluiu fica registrado na lixeira.
Path parameters
iduuidobrigatórioExemplo de requisição
curl -X DELETE "$BASE_URL/api/v1/admin/products/0497b6a8-c868-43be-ac21-2abddd24cd3c" \
-H "Authorization: Bearer $TOKEN"Resposta
{ "message": "product deleted" }Campos da resposta
messagestringproduct deleted (texto em inglês, como o servidor devolve).Erros
| Status | Quando | Corpo |
|---|---|---|
| 401 | Sem credenciais, chave inválida ou token expirado | {"error":"invalid or expired token"} |
| 403 | Usuário sem permissão de escrita | {"error":"insufficient privileges","required":"manage_catalog"} |
| 429 | Limite de requisições | {"error":"rate limit exceeded","detail":"too many requests, please try again later"} |
| 500 | Produto que não existe ou já foi excluído, ou {id} que não é UUID. Por limitação conhecida a API responde 500 nestes casos, e não 404 ou 400 | {"error":"failed to delete product","detail":"product not found"} |