v14

OpenAPI 3.1.02026-08-03122113375.9 KB
user-reviews

Update review

Revise an existing authored review.

Use this endpoint when a user edits rating/comment after posting.

Rules:

  • Caller must be the original author.
  • Reviews are single-revision only; additional revisions return 409.
  • Updated content is sanitized before persistence.

Side effects:

  • Recalculates and persists reviewed-user rating aggregates when rating changes.
put/user/reviews/{id}

Path parameters

idstring required

Review ID

Review ID

Request body

ratinginteger required

Rating between 1 and 5

contentstring

Optional textual feedback

Response

Review

idstring required

Unique identifier for the review

ratinginteger required

Rating given in the review

contentstring

Optional textual feedback

revisionsinteger required

Number of times the review has been revised

createdAtstring nullable

Timestamp when the review was created