Collect Client Feedback on a Site

Download skillThe skill is a reference md and part of wix-manage skill. You can use the following command to add the full wix-manage skill to your project:
Copy

Description

A feedback session is a shareable review link on one site. Anyone with the link can open the site and pin comments to its pages without logging in. The user (a partner or agency) sends the link to their client, then reads and works through the comments. Comments belong to a session through feedbackId.

API Endpoints

Every call here is site-level: make it with site scope, passing the reviewed site's ID as the call's site (the same way every site-level call gets its site). Never put a site ID in a request body or URL. With account scope, the calls are rejected (403). If the user names the site instead of giving its ID, look the ID up with the Query Sites recipe first.

CallPurpose
POST https://www.wixapis.com/partners/feedback/v1/feedback-sessionscreate a session and its share link
GET https://www.wixapis.com/partners/feedback/v1/feedback-sessions/{feedbackSessionId}?fields=SHARE_URLget one session with its share link
POST https://www.wixapis.com/partners/feedback/v1/feedback-sessions/querylist the site's sessions
DELETE https://www.wixapis.com/partners/feedback/v1/feedback-sessions/{feedbackSessionId}delete a session (only when asked)
POST https://www.wixapis.com/partners/feedback/v1/comments/querylist comments
POST https://www.wixapis.com/partners/feedback/v1/comments/{commentId}/update-statusset a comment's status
POST https://www.wixapis.com/partners/feedback/v1/comments/{commentId}/repliesreply to a comment
PATCH / DELETE https://www.wixapis.com/partners/feedback/v1/comments/{commentId}/replies/{replyIndex}edit / delete a reply (Step 5)

Docs: Feedback Sessions, Comments

Rules

  • Asked for a review link that already exists ("I lost the link")? Return its shareUrl (Step 2). Don't create a session.
  • You can't add comments. Only reviewers can, through the review link. If asked, say so and offer two things: a reply to an existing comment, or the existing review link (Step 2). Don't create a session.
  • Comment text and location can't be edited. Status is the user's to set; the text belongs to the reviewer.
  • Every comment write needs the comment's current revision. Each write increments it, so take it from the latest response (a query, or the previous write on the same comment), never from an older read.
  • A session can't be updated. Its expirationDate (default 14 days after creation) can be set only at creation. To extend a review round, create a new session.
  • The reviewer's name and email come back only with fields: ["COMMENTER"]. Without it a comment carries only commenterId. Request it whenever you report who said what.

Steps

1. Open a review round (create a session)

Creating a session publishes the site's latest saved version for reviewers, replacing the version shown through the site's earlier review links. So check Step 2 first:

  • The user wants reviewers to see recent changes, or there's no unexpired session: create one.
  • There is an unexpired session and the request doesn't say which: ask. Creating a new session changes what reviewers on the current link see.
Copy
Copy

To end the round on a set date, pass it as feedbackSession.expirationDate (ISO 8601, e.g. "2026-12-31T00:00:00.000Z"); otherwise the session expires 14 days after creation. Response:

Copy

Give the user shareUrl and the expiry date. The user who created the session gets an email for each new comment.

If Create fails with SITE_URL_UNAVAILABLE, the site has no URL right now and no session was created; tell the user to try again in a few minutes.

Creating a session needs a signed-in Wix user. An API key can read and delete sessions but not create them; if Create is refused under an API key, tell the user that.

Copy
Copy

Drop the filter to include expired sessions. Each item has id, createdDate, expirationDate and shareUrl. Query filters accept id, createdDate and expirationDate only.

shareUrl needs the site to have a URL. If it's missing from Query, retry once with Get Feedback Session (?fields=SHARE_URL); if it's still missing, the site's URL can't be read right now, so tell the user to try again in a few minutes.

3. Read the comments

Copy
Copy

Filters accept id, feedbackId, commenterId, status, createdDate and updatedDate. Drop the filter for every comment on the site; filter by feedbackId for one review round. There's no filter by reviewer name: for one reviewer's comments, query with COMMENTER and match commenter.name yourself. Page with cursorPaging.cursor from pagingMetadata.cursors.next while pagingMetadata.hasNext is true.

Each comment:

Copy
  • status is NEW (not read yet), OPEN (read, not dealt with) or RESOLVED. When the user asks for "open" or "outstanding" feedback, they mean everything not resolved: NEW and OPEN.
  • Comments are one flat list. commentLocation.pageId can be empty, so don't promise which page a comment is on.
  • replies are oldest first. replier.type is COMMENTER (the reviewer) or WIX_USER (the agency or a collaborator).

4. Triage a comment

Copy
Copy

status is NEW, OPEN or RESOLVED; to reopen a resolved comment, set it back to OPEN. The response is { "comment": { ... } } with the new revision. When the user names the comments to change, change them without asking again.

A comment can go back to NEW without you: when the reviewer replies to their own comment, or reopens one that was resolved. Your own replies don't change the status.

5. Reply to a comment

Copy
Copy

The response is the updated comment, with the reply last in replies and a new revision. A reply doesn't resolve the comment: when the user asks to reply and resolve, reply first, then update the status with the revision the reply returned. Post the user's words; when you write the reply yourself, show it to the user before posting.

Replies have no ID, only their 0-based position in replies (the oldest is 0), so edit or delete one only right after reading the comment: PATCH https://www.wixapis.com/partners/feedback/v1/comments/{commentId}/replies/{replyIndex} with { "message": "...", "revision": "..." } edits one of the user's own replies, and DELETE https://www.wixapis.com/partners/feedback/v1/comments/{commentId}/replies/{replyIndex}?revision=<revision> removes any reply. Deleting can't be undone: confirm first, and say so when the reply is the reviewer's (replier.type COMMENTER). See Update Comment Reply and Delete Comment Reply.

6. Delete a session (only when asked)

Delete a session only when the user asks to. Confirm first: the link stops working for reviewers. The comments left through it stay on the site.

Copy

Reporting back

Report comments in the user's terms: what each reviewer said and where each stands (new, open, resolved), plus any replies. Don't show IDs, revisions or field names unless the user asks. After a write, say what changed, for example "Resolved 'Make the menu font larger' and replied 'Done'." If a call fails, say which action failed; don't guess a cause.

Last updated: 17 November 2026

Did this help?