Atualize as variações do seu imóvel

Depois de publicar seu imóvel com variações, pode ser que você queira modificar alguma variação, adicionar uma nova à sua publicação ou alterar o estoque disponível ou o preço. Neste guia, mostramos como realizar essas mudanças.

Adicionar novas variações

Para incluir uma nova variação em um item já publicado — por exemplo, se uma nova unidade entrou em estoque —, é possível fazer isso por meio de uma requisição POST ao item. Nesse post, na propriedade variations, deve ser incluída a nova variação que se deseja criar. Exemplo:

curl -X POST 
-H 'Authorization: Bearer $ACCESS_TOKEN' 
-H 'Content-Type: application/json' 
-d '{
    "attribute_combinations": [
      {
        "id": "TOTAL_AREA",
        "value_name": "90 m²"
      },
      {
        "id": "PARKING_LOTS",
        "value_name": "3"
      },
      {
        "id": "BEDROOMS",
        "value_name": "5"
      },
      {
        "id": "FULL_BATHROOMS",
        "value_name": "3"
      }
    ],
    "price": 125000000,
    "available_quantity": 8,
    "sold_quantity": 0
  }' 
https://api.mercadolibre.com/items/MLA658778048/variations

Você receberá uma resposta com status 201 - Created, com o corpo semelhante ao visto em Consulte sua publicação com variações, mas agora incluindo a nova variação publicada.

Modificar variações

Agora que você já aprendeu a publicar e consultar itens com variações, além de adicionar novas, também pode atualizar o estoque, preços ou qualquer outro atributo. Para isso, envie uma requisição PUT ao endpoint /items, de forma muito semelhante ao que foi mostrado na guia Atualize seu imóvel. No corpo da requisição, adicione, dentro do array variations [], o id da variação juntamente com os dados que deseja atualizar. Veja um exemplo supondo que queremos modificar o preço e o estoque das variações:

curl -X PUT 
-H 'Authorization: Bearer $ACCESS_TOKEN' 
-H 'Content-Type: application/json' 
-d '{
  "variations": [
    {
      "id": 1789456123,
      "available_quantity": 10,
      "price": 110000000
    },
    {
      "id": 123456789,
      "available_quantity": 10,
      "price": 115000000
    }
  ]
}' 
https://api.mercadolibre.com/items/MLC2913388294

Parâmetros

Parâmetro	Tipo	Opcional	Valores
ACCESS_TOKEN	string	Não	Lembre-se de utilizar o token que você gerou no ponto 4.3 do guia “Passos Rápidos para Publicar um Imóvel de Teste”.
ITEM_ID	String	Não	ID do item obtido como resposta ao publicar o imóvel.
variations	Array	Não	Array com as variações a serem modificadas.
id	Integer	Não	ID da variação a ser modificada.
price	Integer	Sim	Preço ou outro atributo que deseja atualizar para a variação informada.

Você receberá uma resposta com status 200 - OK, com o corpo semelhante ao de uma nova publicação de imóvel, mostrando os dados atualizados das variações.

Excluir uma variação

Assim como é possível atualizar seu imóvel adicionando novas variações, também é possível excluir uma variação específica, conforme o exemplo a seguir:

curl -X DELETE 
-H 'Authorization: Bearer $ACCESS_TOKEN' 
https://api.mercadolibre.com/items/$ITEM_ID/variations/$VARIATION_ID

Parâmetros

Parâmetro	Tipo	Opcional	Valores
ACCESS_TOKEN	string	Não	Lembre-se de utilizar o token gerado no ponto 4.3 do guia “Passos Rápidos para Publicar um Imóvel de Teste”.
ITEM_ID	String	Não	ID do item publicado.
VARIATION_ID	INTEGER	Não	ID da variação que será excluída.

Ao enviar a solicitação, você receberá uma resposta com status 200 - OK. O conteúdo será semelhante ao obtido ao consultar as variações, mostrando as que permanecem disponíveis após a exclusão.

Se precisar de mais detalhes sobre este tema, consulte o guia de variações gerais para produtos.

Leituras recomendadas

• Ciclo de vida das publicações
• Qualidade das publicações

Atualizações de versão

Esta seção fornece informações sobre as atualizações da API, incluindo:

Histórico de alterações

Data	Versão	Descrição
08/11/2025	1.0	Publicação inicial