Rate installed app

POST/marketplace/apps/{id}/rate

Submits a star rating and optional review text for an installed marketplace app. Only tenants with an active installation of the app can submit a rating. Ratings are aggregated into the app's average_rating displayed in the marketplace listing.

Request

Path parameters

Name	Type	Required	Description
id	integer	Yes	The numeric ID of the app to rate.

Request body

Content type application/json (required).

Field	Type	Required	Description
rating	integer	Yes	Star rating from 1 (worst) to 5 (best). Minimum: 1 · Maximum: 5
review	string	No	Optional freetext review of the app. Max length: 2000

Example

{
  "rating": 5,
  "review": "Excellent integration — notifications arrive within seconds. Setup was straightforward."
}

Responses

201 Rating submitted and app average_rating updated

Content type application/json, object.

Field	Type	Required	Description
average_rating	number (float)	No	Updated aggregate average rating for the app.
rating_count	integer	No	Total number of ratings submitted for this app.

Example

{
  "average_rating": 4.7,
  "rating_count": 413
}

403 Tenant does not have an active installation of this app

422 Validation failed — rating must be 1-5

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/marketplace/apps/{id}/rate" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"rating": 5, "review": "Excellent integration — notifications arrive within seconds. Setup was straightforward."}'