Organization API: Organizations & Members: Reviews
The 2 Organization API operations for reviews.
Part of Organizations & Members.
Operations
Section titled Operations| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/orgs/{org_slug}/reviews |
Read the Trustpilot review settings and how the invitations are doing |
| PUT | /api/v1/orgs/{org_slug}/reviews |
Change the Trustpilot review settings |
Read the Trustpilot review settings and how the invitations are doing
Section titled Read the Trustpilot review settings and how the invitations are doingGET /api/v1/orgs/{org_slug}/reviews
The Trustpilot review settings, and how the review invitation emails are doing.
Needs the Admin or Owner role. enabled is whether the storefront asks signed-in customers for a review,
review_url the Trustpilot link it opens (null for none), min_account_age_days how old an account is
before it asks, and dismiss_days how long it stays quiet after a customer closes the prompt. The
invitation is the email flow review_invite, which uses the same link. invitations holds enabled
(the flow's own switch), the number of its messages scheduled, sent, skipped and failed (all 0
until the flow has run) and last_sent_at.
Parameters
Section titled Parameters| Name | In | Type | Required |
|---|---|---|---|
org_slug |
path | string | yes |
Responses
Section titled Responses| Status | Meaning |
|---|---|
200 |
Success. |
422 |
The request is not valid. detail lists each problem. |
Change the Trustpilot review settings
Section titled Change the Trustpilot review settingsPUT /api/v1/orgs/{org_slug}/reviews
Change the review settings. Send only what changes.
Needs the Admin or Owner role. review_url must start with https:// and be on trustpilot.com, at most
500 characters, and the prompt cannot be turned on without one. min_account_age_days is 0 to 365 and
dismiss_days 1 to 365. A value that does not fit answers 422 with detail, the sentence to show, and
field, the setting it belongs to. The answer is the one GET gives, with changed listing the settings
that differ from before. Saving what is already saved changes nothing and writes no audit entry. A change
is recorded as reviews.updated, and the storefront applies it to new page loads within a minute.
Parameters
Section titled Parameters| Name | In | Type | Required |
|---|---|---|---|
org_slug |
path | string | yes |
Request body
Section titled Request bodyapplication/json (required)
| Field | Type | Required | Description |
|---|---|---|---|
enabled |
boolean or null | no | Turn the review prompt on or off. It needs review_url, and an on switch with no link answers 422. |
review_url |
string or null | no | Your Trustpilot review link. It starts with https:// and is on trustpilot.com, at most 500 characters. Null or empty removes it. |
min_account_age_days |
integer or null | no | How many days old an account is before the prompt asks, 0 to 365. The default is 1. |
dismiss_days |
integer or null | no | How many days the prompt stays quiet after a customer closes it, 1 to 365. The default is 30. |
Responses
Section titled Responses| Status | Meaning |
|---|---|
200 |
Success. |
422 |
The request is not valid. detail lists each problem. |