---
name: suggestions
description: "Suggestions API skill. Use when working with Suggestions for suggestions. Covers 17 endpoints."
version: 1.0.0
generator: lapsh
---

# Suggestions
API version: 1.0

## Auth
ApiKey X-VTEX-API-AppKey in header | ApiKey X-VTEX-API-AppToken in header | ApiKey VtexIdclientAutCookie in header

## Base URL
https://api.vtex.com/apiexamples

## Setup
1. Set your API key in the appropriate header
2. GET /suggestions/configuration/autoapproval/toggle -- verify access

## Endpoints

17 endpoints across 1 groups. See references/api-spec.lap for full details.

### suggestions
| Method | Path | Description |
|--------|------|-------------|
| GET | /suggestions/configuration/autoapproval/toggle | Get autoApprove status in account settings |
| PUT | /suggestions/configuration/autoapproval/toggle | Activate autoApprove in marketplace's account |
| GET | /suggestions/configuration | Get account's approval settings |
| PUT | /suggestions/configuration | Save account's approval settings |
| GET | /suggestions/configuration/account/config | Get account's matcher settings |
| GET | /suggestions/configuration/seller/{sellerId} | Get seller's approval settings |
| PUT | /suggestions/configuration/seller/{sellerId} | Save seller's approval settings |
| PUT | /suggestions/configuration/autoapproval/toggle/seller/{sellerId} | Activate autoApprove setting for a seller |
| GET | /suggestions | Get all SKU suggestions |
| PUT | /suggestions/{sellerId}/{sellerSkuId} | Send SKU suggestion |
| GET | /suggestions/{sellerId}/{sellerSkuId} | Get SKU suggestion by ID |
| DELETE | /suggestions/{sellerId}/{sellerSkuId} | Delete SKU suggestion |
| GET | /suggestions/{sellerId}/{sellerskuid}/versions | Get all versions |
| GET | /suggestions/{sellerId}/{sellerskuid}/versions/{version} | Get version by ID |
| PUT | /suggestions/{sellerId}/{sellerskuid}/versions/{version}/matches/{matchid} | Match received SKUs individually |
| PUT | /suggestions/matches/action/{actionName} | Match multiple received SKUs |
| PUT | /suggestions/configuration/{sellerID}/specifications | Map seller specifications to marketplace catalog |

## Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "List all toggle?" -> GET /suggestions/configuration/autoapproval/toggle
- "List all configuration?" -> GET /suggestions/configuration
- "List all config?" -> GET /suggestions/configuration/account/config
- "Get seller details?" -> GET /suggestions/configuration/seller/{sellerId}
- "Update a seller?" -> PUT /suggestions/configuration/seller/{sellerId}
- "Update a seller?" -> PUT /suggestions/configuration/autoapproval/toggle/seller/{sellerId}
- "Search suggestions?" -> GET /suggestions
- "Update a suggestion?" -> PUT /suggestions/{sellerId}/{sellerSkuId}
- "Get suggestion details?" -> GET /suggestions/{sellerId}/{sellerSkuId}
- "Delete a suggestion?" -> DELETE /suggestions/{sellerId}/{sellerSkuId}
- "List all versions?" -> GET /suggestions/{sellerId}/{sellerskuid}/versions
- "Get version details?" -> GET /suggestions/{sellerId}/{sellerskuid}/versions/{version}
- "Update a matche?" -> PUT /suggestions/{sellerId}/{sellerskuid}/versions/{version}/matches/{matchid}
- "Update a action?" -> PUT /suggestions/matches/action/{actionName}
- "How to authenticate?" -> See Auth section

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Create/update endpoints typically return the created/updated object

## CLI

```bash
# Update this spec to the latest version
npx @lap-platform/lapsh get suggestions -o references/api-spec.lap

# Search for related APIs
npx @lap-platform/lapsh search suggestions
```

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)