v46

latestOpenAPI 3.0.0raw.githubusercontent.com2026-04-201720164.6 KB
SKU approval settings

Activate autoApprove in marketplace's account

This endpoint enables the autoapprove rule to a marketplace's whole Received SKUs module. Once enabling the rule, received SKUs will be automatically approved on your store, regardless of the seller.

For the autoapprove rule to work as expected, the approval Matcher score should be set up as 80 (default value), but you can configure a different number through the field Score in Save Account's Approval Settings.

Permissions

Any user or API key must have at least one of the appropriate License Manager resources to be able to successfully run this request. Otherwise, they will receive a status code 403 error. These are the applicable resources for this endpoint:

ProductCategoryResource
ChannelsUI resourcesSave suggestion rules
SuggestionSuggestion resourcesMain access

There are no applicable predefined roles for this resource list. You must create a custom role and add at least one of the resources above in order to use this endpoint.

To learn more about machine authentication at VTEX, see Authentication overview.

❗ To prevent integrations from having excessive permissions, consider the best practices for managing API keys when assigning License Manager roles to integrations.

put/suggestions/configuration/autoapproval/toggle

Path parameters

accountNamestring required
Example:apiexamples

Name of the VTEX account that belongs to the marketplace. All data extracted, and changes added will be posted into this account.

Headers

Content-Typestring required

Describes the type of the content being sent.

Acceptstring required

HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand

Request body

Enabledboolean required

Insert true if you wish to activate the autoapprove rule for an entire marketplace account. Insert false if you wish to deactivate it. Be aware that once enabling the setting through this request, all received SKUs will be automatically approved on your store, regardless of the seller, or the Matcher Score.

Example request

{
  "Enabled": true
}

Response

OK

Enabledboolean

If the autoapprove setting is active (true) or not (false).