Setting the file. One moment.
Subchapter 19.131
references/sites/send-feedback-to-wix.mdMarkdown4 KBView on GitHub
Feedback reaches the Wix teams that own the APIs, docs, recipes and tooling. It is about the experience of building with Wix, not the user’s site content, and it is not support.
Sending is the user’s call; offering is yours. Offer once per issue, in plain prose, and send only after the user says yes.
When you offer, invite the user to add their own words. Never send without a yes, never twice for the same issue, and never for a single transient error.
Wix receives free text. A bare sentence can’t be triaged, so send a summary of the whole run in four parts.
Provenance, as labeled lines; drop the ones that don’t apply:
Agent / model: <the agent and model you are>
Wix tooling: <Wix MCP, Wix CLI, REST from a shell, ...>
Recipes: <the recipes this run followed>
Wix products and APIs: <Stores, headless drop, the upload tool, ...>
Site: <metaSiteId> · dashboard: <url> · live: <url>
Other ids: <request ids, upload ids, execution ids>Narrative:
Friction points, the heart of it. For each: the step or endpoint, the HTTP status and error text, the request id, what you expected, and what you did instead. Add your best guess at where the fault lives, from API behavior, API schema, API docs, docs articles or examples, a recipe, the Wix MCP, Wix tooling, or unsure, and say whether you confirmed it. “Unsure” beats a wrong guess.
Bottom line: one or two sentences naming the most important problem and its impact.
Show the user the final wording before sending. Leave out tokens, API keys and credentials, and any personal data the feedback doesn’t need.
The call identifies the user, so it takes a user identity: a token from
npx @wix/cli@latest token, or account scope in a script. A site-scoped token
is refused as anonymous.
curl -sS -X POST "https://www.wixapis.com/mcp-serverless/v1/headless-feedback" \
-H "Authorization: Bearer $ACCESS_TOKEN" -H 'Content-Type: application/json' \
-d '{"message":"<the composed message>"}'In an ExecuteWixAPI script, with the message as one text file in the files
param:
async function run() {
return await wix.request({ scope: 'account', method: 'POST',
url: 'https://www.wixapis.com/mcp-serverless/v1/headless-feedback',
body: { message: files[0].content } });
}| Response | Meaning |
|---|---|
200 with {} | Sent. Tell the user. |
500 “Unable to determine target user id, anonymous messages are not allowed” | The token was site-scoped. Get a user token and send once more. |
401 or 403 | The CLI login expired. Run npx @wix/cli@latest login, get a new token, and send once more. If it fails again, show the user the response. |