---
title: "Create Store Review"
method: POST
path: "/v1/stores/{store_id}/reviews"
tags: ["Store Reviews"]
---

# Create Store Review

`POST /v1/stores/{store_id}/reviews`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/v1/stores/{store_id}/reviews`
- Auth: OAuth 2 (password, token URL `/v1/auth/login`)

Create a new review for a store. Users can only have one review per store.

## Path parameters

- `store_id` integer, required

## Request body

- StoreReviewIn: Fields a client may send when creating a store review.
  - `rating` integer, required: Overall store rating (1-5 stars)
  - `comment` string, nullable: Optional review comment

## Response `201`

Successful Response

- StoreReviewOut: What the API returns.
  - `rating` integer, required: Overall store rating (1-5 stars)
  - `comment` string, nullable: Optional review comment
  - `id` integer, required
  - `store_id` integer, required
  - `user_id` integer, required
  - `user` AppSchemasReviewUserBasic: Basic user info for review author display.
    - `id` integer, required
    - `username` string, nullable
    - `email` string, nullable
  - `helpful_count` integer
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/rubenayla/apis/partle-api.md) · [All operations](https://skmtc.dev/rubenayla/apis/partle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rubenayla/apis/partle-api/revisions/628cce2acee5?raw)