⚠️ Apply VAS services
items_apply_vasApply promotion services (slugs) and stickers to a published listing for increased visibility. Charges are irreversible; always confirm available options and prices before application.
Instructions
Applies ONE OR MORE promotion services (slugs) and/or stickers to a published listing (apply_vas, v2 — the current method). ⚠️ MONEY: charges money; irreversible. The response contains the IDs of the purchase operations for status tracking. The preferred replacement for the deprecated items_put_item_vas (a single service) and items_put_item_vas_package_v2 (a package). Within one request each service is applied only once; stickers are available only with the "XL listing" service, no more than three. First check the available slugs/stickers and price via items_post_vas_prices, and confirm with the user.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slugs | Yes | Slugs of the promotion services to apply, e.g. ["highlight","xl"] (at least 1; available ones from items_post_vas_prices). | |
| dryRun | No | v0.7.0: if true — returns a preview of the HTTP request without calling the Avito API. Safe for inspecting exactly what would be done. Default: the value of AVITO_MCP_DRY_RUN_DEFAULT (usually false). | |
| itemId | Yes | ID of the published listing the services are applied to. | |
| stickers | No | Sticker IDs (integers), no more than 3; available only with the "XL listing" service. | |
| idempotencyKey | No | v0.7.0: optional key for duplicate protection. A repeat call with the same key within AVITO_MCP_IDEMPOTENCY_TTL_SEC returns the cached result. The same key with different args returns a conflict error. Keys are stored as bounded SHA-256 fingerprints. |