> ## Documentation Index
> Fetch the complete documentation index at: https://docs.feedspace.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Reviews

> Tools for managing reviews and testimonials in your Feedspace workspace.

These tools let you browse, filter, update, and organize your collected reviews, including text, video, audio, and social reviews.

## Available Tools

| Tool                   | Description                                                                 | Try asking                                              |
| ---------------------- | --------------------------------------------------------------------------- | ------------------------------------------------------- |
| `get_reviews`          | Fetch all your reviews, page by page                                        | "Show me all reviews in my workspace"                   |
| `filter_reviews`       | Filter reviews by type, sentiment, star rating, form, label, or keyword     | "Find all 5-star text reviews with positive sentiment"  |
| `get_filter_options`   | See available filter options: forms, labels, and import sources             | "What filter options are available for my reviews?"     |
| `get_review`           | Get the full details of a single review                                     | "Show me the details of text review 14067"              |
| `update_review`        | Update a review's rating, title, text, or date, plus the reviewer's details | "Update the title of this review to 'Great Experience'" |
| `favourite_review`     | Mark or unmark a review as favourite                                        | "Favourite this text review"                            |
| `get_review_summary`   | Get the total number of reviews in the workspace                            | "How many reviews do I have in total?"                  |
| `batch_update_reviews` | Bulk favourite, unfavourite, assign labels, or remove labels                | "Favourite all my 5-star reviews"                       |

## Identifying a Review

Most review tools need **two** values together, because a review id is only unique within its type:

* `reviewType`: one of `text`, `video`, `audio`, or `social`
* `reviewId`: the id returned by `get_reviews`, `filter_reviews`, or `get_review`

`batch_update_reviews` takes a list of these pairs, so you can mix review types in a single call.

<Note>
  Widgets and Wall of Love pages use a different identifier: `feed_identifier`, a single string that looks like `feed-video-item-428`. Use that when passing reviews to `create_widget`, `update_widget`, `create_page`, or `update_page`.
</Note>

## Filtering Notes

* `filter_reviews` accepts `reviewTypes` (`video`, `audio`, `text`, `social`), `starRatings` (1 to 5), `sentiment` (`positive`, `neutral`, `negative`), `formIds`, `reviewLabelIds`, `importedSourceIds`, and a `search` keyword.
* Handy boolean filters: `favourite`, `reviewWithComment`, and `hasCompanyLogo` (useful when picking reviews for a Company Logo Slider widget).
* `perPage` is capped at 100, but the backend currently returns a fixed page size of 15 and may ignore the value.
* `get_review_summary` returns only a total count. For per-type or per-rating numbers, use `filter_reviews` and read the pagination total.

<Note>
  Ratings on social reviews (including most imported ones) cannot be changed through `update_review`, matching the behaviour of the web app. Reviewer fields that the original form did not capture are quietly skipped.
</Note>