# Organization API: Organizations & Members: Reviews

> The 2 Organization API operations for reviews.

Source: https://www.coritan.com/docs/api/reference/organizations/organizations-members/reviews/

Part of [Organizations & Members](/docs/api/reference/organizations/organizations-members/).

## Operations

| Method | Path | Summary |
| --- | --- | --- |
| GET | [`/api/v1/orgs/{org_slug}/reviews`](#op-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`](#op-put-api-v1-orgs-org-slug-reviews) | Change the Trustpilot review settings |

### Read the Trustpilot review settings and how the invitations are doing {#op-get-api-v1-orgs-org-slug-reviews}

`GET /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

| Name | In | Type | Required |
| --- | --- | --- | --- |
| `org_slug` | path | string | yes |

#### Responses

| Status | Meaning |
| --- | --- |
| `200` | Success. |
| `422` | The request is not valid. `detail` lists each problem. |

### Change the Trustpilot review settings {#op-put-api-v1-orgs-org-slug-reviews}

`PUT /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

| Name | In | Type | Required |
| --- | --- | --- | --- |
| `org_slug` | path | string | yes |

#### Request body

`application/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

| Status | Meaning |
| --- | --- |
| `200` | Success. |
| `422` | The request is not valid. `detail` lists each problem. |