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

# Reviews overview

> Write, update, and publish visit reviews after an appointment

Use the Reviews API when a customer writes feedback on a completed visit, or
when you list and update reviews the caller is allowed to see.

## What you do first

1. [Create a review](/api-reference/reviews/create-a-review) on a completed
   appointment the customer attended.
2. [List review tags](/api-reference/reviews/list-review-tags) if your UI offers
   structured tags with the free-text review.
3. [Get a review](/api-reference/reviews/get-a-review) or
   [list reviews](/api-reference/reviews/list-reviews) for display.
4. [Update a review](/api-reference/reviews/update-a-review) or
   [delete a review](/api-reference/reviews/delete-a-review) while it is still
   pending approval.

## States that matter

| State    | What it means for the next call                                           |
| -------- | ------------------------------------------------------------------------- |
| Pending  | Customer can still edit or withdraw; customers do not see it publicly yet |
| Approved | Visible on the barber's public reviews                                    |
| Rejected | Stays hidden from customers                                               |

Barbers approve or reject through the Barbers domain, not these write paths.

## When a call fails

Failures come back as problem documents. Open the `type` link for the cause,
the fix, and whether retrying is safe. Common ones include a duplicate review,
an appointment that is not completed, and a caller who is not the appointment
customer.

## Related paths

* Barber approve/reject lives under [Barbers](/api-reference/Barbers/overview).
* Completed visits live under [Appointments](/api-reference/Appointments/overview).