Update item with the Mercado Livre API

Changes a listing and returns it. Only the fields sent change. status paused hides it, active brings it back and closed ends it for good. title and family_name only change while the listing has no sales.

Identifier
mercado_livre_update_item

The request

POST https://connect.reportei.com/api/tools/mercado_livre_update_item/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "item_id": "<item_id>"
  }
}

Your system sends your customer's connection id and the tool arguments. The headers are the same as the rest of the Connect API: your product's token and your customer's token.

Parameters

ParameterTypeRequiredDescription
item_idstringYesId of the listing, from Search items, for example MLB1828680414.
statusstringNopaused hides the listing, active reactivates a paused one and closed ends it, with no way back.Values: active, paused, closed
pricenumberNoNew price. Ignored when the listing has price automation turned on, and refused with 400 if it is the only field sent.
available_quantityintegerNoNew stock. 0 pauses a new item with substatus out_of_stock, and stock above 0 reactivates it.
titlestringNoNew title, only while the listing has no sales.
family_namestringNoNew family name, only while no listing of the family has sales. It changes every listing of the same product.
picturesarrayNoThe full list of pictures, which replaces the current one. Keep a current picture by its id and add a new one by source.
attributesarrayNoAttributes to add or change. The ones not sent stay as they are.
sale_termsarrayNoSale terms to change, such as WARRANTY_TYPE and WARRANTY_TIME.

Supported connections

Your customer connects their Mercado Livre account once, with one of the modes below. The same connection serves every tool of the toolkit.

OAuth with your product's app

You register your product's OAuth app once, with POST /api/merchants/credentials/mercado_livre, and your customer authorizes the account on a consent screen. Connect renews the token when it is about to expire.

The response

On success, Connect preserves the app's response status and body. HTTP errors returned by the app use the {error, api_error} envelope; authentication or validation can fail before execution. The X-Toolkit-Execution-Id header identifies the recorded execution, available at GET /api/tools/executions/{uuid}.

Ready for AI agents

This tool's input is a JSON Schema, available at GET /api/tools/mercado_livre_update_item. It becomes your agent's tool definition with no conversion.

Other Mercado Livre tools

See all 14 tools

Toolkits in the same category

See all 100 toolkits

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.