Produtos
Atualizar um produto
Atualiza um produto.
Atualiza um
product com semântica de merge: campos ausentes ficam como
estão; envie null para limpar campos opcionais. metadata e
marketing_features, quando enviados, substituem a lista/objeto inteiro.
A resposta direta não carrega diff; quem precisa de diff lê o webhook
product.updated.
Autenticação
A API key da própria organização atua diretamente. A API key de plataforma exige o headerOrganization: <organization_id> apontando para uma organização
conectada ativa.
Parâmetros de caminho
Attributes
Todos os campos são opcionais.Aponta o
default_price_id para outro preço existente do mesmo produto.
Envie null para limpar.Nova imagem. Use a URL retornada por
POST /v1/files com
purpose=product_image. Envie null para limpar. URLs externas não são
aceitas.Substitui completamente a lista de recursos de marketing quando enviado.
No máximo 15 itens; cada
name até 80 caracteres. Envie [] para
limpar.Resposta
200 OK com o objeto product completo (mesmo shape de
GET /v1/products/:id).
Erros comuns
Webhook
A atualização disparaproduct.updated
com o product completo em data.object e o diff em data.previous_attributes.
