v14

OpenAPI 3.1.02026-08-03122113375.9 KB
user-reviews

Create review

Create a new review authored by the authenticated user.

Use this endpoint after a qualifying interaction (for example an order flow) when collecting user feedback.

Validation and moderation:

  • Review must pass source/actor validation checks.
  • Review text is sanitized before persistence.
  • Empty content after sanitization is treated as no comment.

Responses:

  • Returns 201 with the created authored review.
  • Returns 403 when the review is not valid for the source/user combination.
post/user/reviews

Request body

reviewedUserIdstring required

ID of the user being reviewed

ratinginteger required

Rating between 1 and 5

contentstring

Optional textual feedback

Response

Review created

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