Skip to content

Review routes: update

The Review Verbs update as api.sb routes, with inputs, result, refusals and an example.

Reference for Review, one group of Review routes.

Review.update

Changes the given properties of a Review. Verb page.

Text
PATCH /{namespace}/reviews/{id}

Path: id. Body, as JSON: the other inputs. Emits Review.updated.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Review.
ratingintegerThe score, from 1 to 5.
bodytextThe reviewer’s words.
venuestringThe venue it was posted on, by id; empty for the Startup’s own Site.
displayConsentbooleanTrue once the reviewer agreed it may be shown on the Startup’s own Pages. Never randomized.
customerCustomerThe Customer who wrote it, when known.

Returns

OutputTypeRequiredDescription
reviewReviewrequiredThe Review.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X PATCH https://api.sb/leaseline.app/reviews/review_1XPL2xTlfx \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rating":1}'
JSON
{
  "api": "https://api.sb/leaseline.app",
  "review": {
    "$id": "https://api.sb/leaseline.app/reviews/review_1XPL2xTlfx",
    "$type": "Review",
    "rating": 1,
    "status": "submitted"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "Review.update",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}