Reviews

Reviews are used to evaluate Products and Channels.

On the tutorial page you can find some instructions on how to use Reviews to rate Products and Channels.

Representations

Review

ReviewDraft

ReviewPagedQueryResponse

ReviewRatingStatistics

ReviewReference

ReviewResourceIdentifier

Review

`id` String	Unique identifier of the Review.
`version` Int	Current version of the Review.
`key` String	User-defined unique identifier of the Review.
`uniquenessValue` String	Must be unique among Reviews. For example, if this value is set to Customer `id` + Product `id`, only one Review per Customer and per Product is allowed.
`locale` Locale	Language in which the content of the Review is written.
`authorName` String	Name of the author.
`title` String	Title of the Review.
`text` String	Content of the Review.
`target` Can be ProductReference, or ChannelReference	Identifies the target of the Review. Can be a Product or a Channel, specified as ProductReference or ChannelReference, respectively. (oneOf): `ProductReference,ChannelReference`
`includedInStatistics` Boolean	Indicates if this Review is taken into account in the ratings statistics of the target. A Review is per default used in the statistics, unless the Review is in a state that does not have the role `ReviewIncludedInStatistics`. If the role of a State is modified after the calculation of this field, the calculation is not updated.
`rating` Int	Rating of the Product or Channel. Minimum: `-100`Maximum: `100`
`state` StateReference	State of the Review. Used for approval processes, see Review approval process for details.
`customer` CustomerReference	Customer who created the Review.
`custom` CustomFields	Custom Fields of the Review.
`createdAt` DateTime	Date and time (UTC) the Review was initially created.
`createdBy`BETA CreatedBy	IDs and references that created the Review.
`lastModifiedAt` DateTime	Date and time (UTC) the Review was last updated.
`lastModifiedBy`BETA LastModifiedBy	IDs and references that last modified the Review.

Example: json

{
  "id": "919d5ab5-bf99-4bda-a6fd-ab3ee8123456",
  "version": 1,
  "includedInStatistics": true,
  "authorName": "John Doe",
  "title": "Incredible",
  "text": "Best product ever",
  "rating": 5,
  "target": {
    "typeId": "product",
    "id": "8fddacac-6ef5-4e66-af6e-124452123456"
  },
  "customer": {
    "typeId": "customer",
    "id": "8a8b3e43-b9b0-4b30-8c27-58148123456"
  },
  "custom": {
    "type": {
      "typeId": "type",
      "id": "3939dd9c-0884-4bfa-99c2-40b426123456"
    },
    "fields": {
      "authorMail": "john.doe@example.com"
    }
  },
  "createdAt": "2016-10-20T06:48:53.829Z",
  "lastModifiedAt": "2016-10-20T06:48:53.829Z"
}

ReviewDraft

When creating a new Review, at least one of title, text or rating should be set.

`key` String	User-defined unique identifier for the Review.
`uniquenessValue` String	If set, this value must be unique among Reviews. For example, if you want to have only one Review per Customer and per Product, you can set the value to Customer `id` + Product `id`.
`locale` Locale	Language in which the content of the Review is written.
`authorName` String	Name of the author.
`title` String	Title of the Review.
`text` String	Content of the Review.
`target` Can be ProductResourceIdentifier, or ChannelResourceIdentifier	Identifies the target of the Review. Can be a Product or a Channel, specified as ProductResourceIdentifier or ChannelResourceIdentifier, respectively. (oneOf): `ProductResourceIdentifier,ChannelResourceIdentifier`
`state` StateResourceIdentifier	State of the Review. Used for approval processes, see Review approval process for details.
`rating` Int	Rating of the targeted Product or Channel. This rating can represent the number of stars, a percentage, or a like (+1)/dislike (-1). A rating is used in the ratings statistics of the targeted object, unless the Review is in a State that does not have the role `ReviewIncludedInStatistics`. Minimum: `-100`Maximum: `100`
`customer` CustomerResourceIdentifier	Customer who created the Review.
`custom` CustomFieldsDraft	Custom Fields for the Review.

Example: json

{
  "authorName": "John Doe",
  "title": "Incredible",
  "text": "Best product ever",
  "rating": 5,
  "target": {
    "typeId": "product",
    "id": "8fddacac-6ef5-4e66-af6e-124452123456"
  }
}

ReviewPagedQueryResponse

`limit` Int	Number of results requested. Default: `20`Minimum: `0`Maximum: `500`
`count` Int	Actual number of results returned.
`total` Int	Total number of results matching the query. This number is an estimation that is not strongly consistent. This field is returned by default. For improved performance, calculating this field can be deactivated by using the query parameter `withTotal=false`. When the results are filtered with a Query Predicate, `total` is subject to a limit.
`offset` Int	Number of elements skipped. Default: `0`Maximum: `10000`
`results` Array of Review	Reviews matching the query.

Example: json

{
  "limit": 20,
  "offset": 0,
  "count": 2,
  "total": 2,
  "results": [
    {
      "id": "919d5ab5-bf99-4bda-a6fd-ab3ee8123456",
      "version": 1,
      "includedInStatistics": true,
      "authorName": "John Doe",
      "title": "Incredible",
      "text": "Best product ever",
      "rating": 5,
      "target": {
        "typeId": "product",
        "id": "8fddacac-6ef5-4e66-af6e-124452123456"
      },
      "customer": {
        "typeId": "customer",
        "id": "8a8b3e43-b9b0-4b30-8c27-58148123456"
      },
      "custom": {
        "type": {
          "typeId": "type",
          "id": "3939dd9c-0884-4bfa-99c2-40b426123456"
        },
        "fields": {
          "authorMail": "john.doe@example.com"
        }
      },
      "createdAt": "2016-10-20T06:48:53.829Z",
      "lastModifiedAt": "2016-10-20T06:48:53.829Z"
    },
    {
      "id": "2f60e06c-7672-47fc-962a-1eafa1123456",
      "version": 1,
      "includedInStatistics": true,
      "authorName": ".",
      "title": ".",
      "text": ".",
      "rating": 5,
      "target": {
        "typeId": "product",
        "id": "2c155644-bcde-426c-b021-a2aab123456"
      },
      "custom": {
        "type": {
          "typeId": "type",
          "id": "3939dd9c-0884-4bfa-99c2-40b42123456"
        },
        "fields": {
          "authorMail": "."
        }
      },
      "createdAt": "2016-10-20T06:51:26.795Z",
      "lastModifiedAt": "2016-10-20T06:51:26.795Z"
    }
  ]
}

ReviewRatingStatistics

`averageRating` Float	Average rating of one target This number is rounded with 5 decimals.
`highestRating` Float	Highest rating of one target
`lowestRating` Float	Lowest rating of one target
`count` Int	Number of ratings taken into account
`ratingsDistribution` Object	Full distribution of the ratings. The keys are the different ratings and the values are the count of reviews having this rating. Only the used ratings appear in this object.

ReviewReference

Reference to a Review.

`id` String	Unique identifier of the referenced Review.
`typeId` ReferenceTypeId	`review` Type of referenced resource.
`obj` Review	Contains the representation of the expanded Review. Only present in responses to requests with Reference Expansion for Reviews.

ReviewResourceIdentifier

ResourceIdentifier to a Review. Either id or key is required. If both are set, an InvalidJsonInput error is returned.

`id` String	Unique identifier of the referenced Review. Required if `key` is absent.
`key` String	User-defined unique identifier of the referenced Review. Required if `id` is absent.
`typeId` ReferenceTypeId	`review` Type of referenced resource. If given, it must match the expected ReferenceTypeId of the referenced resource.

Get Review

Get Review by ID

GET

https://api.{region}.commercetools.com/{projectKey}/reviews/{id}

OAuth 2.0 Scopes:

view_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`id` String	`id` of the Review.

Query parameters:

expand

Expansion

The parameter can be passed multiple times.

Response:

200

Review

asapplication/json

Request Example:cURL

curl --get https://api.{region}.commercetools.com/{projectKey}/reviews/{id} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

200 Response Example: Reviewjson

{
  "id": "919d5ab5-bf99-4bda-a6fd-ab3ee8123456",
  "version": 1,
  "includedInStatistics": true,
  "authorName": "John Doe",
  "title": "Incredible",
  "text": "Best product ever",
  "rating": 5,
  "target": {
    "typeId": "product",
    "id": "8fddacac-6ef5-4e66-af6e-124452123456"
  },
  "customer": {
    "typeId": "customer",
    "id": "8a8b3e43-b9b0-4b30-8c27-58148123456"
  },
  "custom": {
    "type": {
      "typeId": "type",
      "id": "3939dd9c-0884-4bfa-99c2-40b426123456"
    },
    "fields": {
      "authorMail": "john.doe@example.com"
    }
  },
  "createdAt": "2016-10-20T06:48:53.829Z",
  "lastModifiedAt": "2016-10-20T06:48:53.829Z"
}

Get Review by Key

GET

https://api.{region}.commercetools.com/{projectKey}/reviews/key={key}

OAuth 2.0 Scopes:

view_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`key` String	`key` of the Review.

Query parameters:

expand

Expansion

The parameter can be passed multiple times.

Response:

200

Review

asapplication/json

Request Example:cURL

curl --get https://api.{region}.commercetools.com/{projectKey}/reviews/key={key} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

200 Response Example: Reviewjson

{
  "id": "919d5ab5-bf99-4bda-a6fd-ab3ee8123456",
  "version": 1,
  "includedInStatistics": true,
  "authorName": "John Doe",
  "title": "Incredible",
  "text": "Best product ever",
  "rating": 5,
  "target": {
    "typeId": "product",
    "id": "8fddacac-6ef5-4e66-af6e-124452123456"
  },
  "customer": {
    "typeId": "customer",
    "id": "8a8b3e43-b9b0-4b30-8c27-58148123456"
  },
  "custom": {
    "type": {
      "typeId": "type",
      "id": "3939dd9c-0884-4bfa-99c2-40b426123456"
    },
    "fields": {
      "authorMail": "john.doe@example.com"
    }
  },
  "createdAt": "2016-10-20T06:48:53.829Z",
  "lastModifiedAt": "2016-10-20T06:48:53.829Z"
}

Query Reviews

GET

https://api.{region}.commercetools.com/{projectKey}/reviews

OAuth 2.0 Scopes:

view_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.

Query parameters:

`where` QueryPredicate	The parameter can be passed multiple times.
`sort` Sort	The parameter can be passed multiple times.
`expand` Expansion	The parameter can be passed multiple times.
`limit` Int	Number of results requested. Default: `20`
`offset` Int	Number of elements skipped. Default: `0`
`withTotal` Boolean	Controls the calculation of the total number of query results. Set to `false` to improve query performance when the `total` is not needed. Default: `true`
`var.<varName>` String	Predicate parameter values. The parameter can be passed multiple times.

Response:

200

ReviewPagedQueryResponse

asapplication/json

Request Example:cURL

curl --get https://api.{region}.commercetools.com/{projectKey}/reviews -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

200 Response Example: ReviewPagedQueryResponsejson

{
  "limit": 20,
  "offset": 0,
  "count": 2,
  "total": 2,
  "results": [
    {
      "id": "919d5ab5-bf99-4bda-a6fd-ab3ee8123456",
      "version": 1,
      "includedInStatistics": true,
      "authorName": "John Doe",
      "title": "Incredible",
      "text": "Best product ever",
      "rating": 5,
      "target": {
        "typeId": "product",
        "id": "8fddacac-6ef5-4e66-af6e-124452123456"
      },
      "customer": {
        "typeId": "customer",
        "id": "8a8b3e43-b9b0-4b30-8c27-58148123456"
      },
      "custom": {
        "type": {
          "typeId": "type",
          "id": "3939dd9c-0884-4bfa-99c2-40b426123456"
        },
        "fields": {
          "authorMail": "john.doe@example.com"
        }
      },
      "createdAt": "2016-10-20T06:48:53.829Z",
      "lastModifiedAt": "2016-10-20T06:48:53.829Z"
    },
    {
      "id": "2f60e06c-7672-47fc-962a-1eafa1123456",
      "version": 1,
      "includedInStatistics": true,
      "authorName": ".",
      "title": ".",
      "text": ".",
      "rating": 5,
      "target": {
        "typeId": "product",
        "id": "2c155644-bcde-426c-b021-a2aab123456"
      },
      "custom": {
        "type": {
          "typeId": "type",
          "id": "3939dd9c-0884-4bfa-99c2-40b42123456"
        },
        "fields": {
          "authorMail": "."
        }
      },
      "createdAt": "2016-10-20T06:51:26.795Z",
      "lastModifiedAt": "2016-10-20T06:51:26.795Z"
    }
  ]
}

Check if Review exists

Check if Review exists by ID

HEAD

https://api.{region}.commercetools.com/{projectKey}/reviews/{id}

Checks if a Review exists for a given id. Returns a 200 OK status if the Review exists or a 404 Not Found otherwise.

OAuth 2.0 Scopes:

view_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`id` String	`id` of the Review.

Response:

200

Request Example:cURL

curl --head https://api.{region}.commercetools.com/{projectKey}/reviews/{id} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

Check if Review exists by Key

HEAD

https://api.{region}.commercetools.com/{projectKey}/reviews/key={key}

Checks if a Review exists for a given key. Returns a 200 OK status if the Review exists or a 404 Not Found otherwise.

OAuth 2.0 Scopes:

view_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`key` String	`key` of the Review.

Response:

200

Request Example:cURL

curl --head https://api.{region}.commercetools.com/{projectKey}/reviews/key={key} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

Check if Review exists by Query Predicate

HEAD

https://api.{region}.commercetools.com/{projectKey}/reviews

Checks if a Review exists for a given Query Predicate. Returns a 200 OK status if any Reviews match the Query Predicate or a 404 Not Found otherwise.

OAuth 2.0 Scopes:

view_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.

Query parameters:

where

QueryPredicate

Query Predicates on Reviews are limited to Text, Enum, Boolean, Number, Date, Time, and DateTime attribute types.

The parameter can be passed multiple times.

Response:

200

Request Example:cURL

curl --head https://api.{region}.commercetools.com/{projectKey}/reviews -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

Create Review

POST

https://api.{region}.commercetools.com/{projectKey}/reviews

OAuth 2.0 Scopes:

manage_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.

Query parameters:

expand

Expansion

The parameter can be passed multiple times.

Request Body:ReviewDraftasapplication/json

Response:

201

Review

asapplication/json

Request Example:cURL

curl https://api.{region}.commercetools.com/{projectKey}/reviews -i \
--header "Authorization: Bearer ${BEARER_TOKEN}" \
--header 'Content-Type: application/json' \
--data-binary @- << DATA 
{
  "authorName" : "John Doe",
  "title" : "Incredible",
  "text" : "Best product ever",
  "rating" : 5,
  "target" : {
    "typeId" : "product",
    "id" : "8fddacac-6ef5-4e66-af6e-124452123456"
  }
}
DATA

201 Response Example: Reviewjson

{
  "id": "919d5ab5-bf99-4bda-a6fd-ab3ee8123456",
  "version": 1,
  "includedInStatistics": true,
  "authorName": "John Doe",
  "title": "Incredible",
  "text": "Best product ever",
  "rating": 5,
  "target": {
    "typeId": "product",
    "id": "8fddacac-6ef5-4e66-af6e-124452123456"
  },
  "customer": {
    "typeId": "customer",
    "id": "8a8b3e43-b9b0-4b30-8c27-58148123456"
  },
  "custom": {
    "type": {
      "typeId": "type",
      "id": "3939dd9c-0884-4bfa-99c2-40b426123456"
    },
    "fields": {
      "authorMail": "john.doe@example.com"
    }
  },
  "createdAt": "2016-10-20T06:48:53.829Z",
  "lastModifiedAt": "2016-10-20T06:48:53.829Z"
}

This method produces the Review Created Message.

Update Review

Update Review by ID

POST

https://api.{region}.commercetools.com/{projectKey}/reviews/{id}

OAuth 2.0 Scopes:

manage_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`id` String	`id` of the Review.

Query parameters:

expand

Expansion

The parameter can be passed multiple times.

Request Body:

application/json

`version` Int	The expected version of the review on which the changes should be applied. If the expected version does not match the actual version, a 409 Conflict will be returned.
`actions` Array of ReviewUpdateAction	The list of update actions to be performed on the review.

Response:

200

Review

asapplication/json

Request Example:cURL

curl https://api.{region}.commercetools.com/{projectKey}/reviews/{id} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}" \
--header 'Content-Type: application/json' \
--data-binary @- << DATA 
{
  "version" : 1,
  "actions" : [ {
    "action" : "setAuthorName",
    "authorName" : "John Doe"
  } ]
}
DATA

200 Response Example: Reviewjson

{
  "id": "919d5ab5-bf99-4bda-a6fd-ab3ee8123456",
  "version": 1,
  "includedInStatistics": true,
  "authorName": "John Doe",
  "title": "Incredible",
  "text": "Best product ever",
  "rating": 5,
  "target": {
    "typeId": "product",
    "id": "8fddacac-6ef5-4e66-af6e-124452123456"
  },
  "customer": {
    "typeId": "customer",
    "id": "8a8b3e43-b9b0-4b30-8c27-58148123456"
  },
  "custom": {
    "type": {
      "typeId": "type",
      "id": "3939dd9c-0884-4bfa-99c2-40b426123456"
    },
    "fields": {
      "authorMail": "john.doe@example.com"
    }
  },
  "createdAt": "2016-10-20T06:48:53.829Z",
  "lastModifiedAt": "2016-10-20T06:48:53.829Z"
}

Update Review by Key

POST

https://api.{region}.commercetools.com/{projectKey}/reviews/key={key}

OAuth 2.0 Scopes:

manage_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`key` String	`key` of the Review.

Query parameters:

expand

Expansion

The parameter can be passed multiple times.

Request Body:

application/json

`version` Int	The expected version of the review on which the changes should be applied. If the expected version does not match the actual version, a 409 Conflict will be returned.
`actions` Array of ReviewUpdateAction	The list of update actions to be performed on the review.

Response:

200

Review

asapplication/json

Request Example:cURL

curl https://api.{region}.commercetools.com/{projectKey}/reviews/key={key} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}" \
--header 'Content-Type: application/json' \
--data-binary @- << DATA 
{
  "version" : 1,
  "actions" : [ {
    "action" : "setAuthorName",
    "authorName" : "John Doe"
  } ]
}
DATA

200 Response Example: Reviewjson

{
  "id": "919d5ab5-bf99-4bda-a6fd-ab3ee8123456",
  "version": 1,
  "includedInStatistics": true,
  "authorName": "John Doe",
  "title": "Incredible",
  "text": "Best product ever",
  "rating": 5,
  "target": {
    "typeId": "product",
    "id": "8fddacac-6ef5-4e66-af6e-124452123456"
  },
  "customer": {
    "typeId": "customer",
    "id": "8a8b3e43-b9b0-4b30-8c27-58148123456"
  },
  "custom": {
    "type": {
      "typeId": "type",
      "id": "3939dd9c-0884-4bfa-99c2-40b426123456"
    },
    "fields": {
      "authorMail": "john.doe@example.com"
    }
  },
  "createdAt": "2016-10-20T06:48:53.829Z",
  "lastModifiedAt": "2016-10-20T06:48:53.829Z"
}

Update actions

Set Key

`action` String	`"setKey"`
`key` String	Value to set. If empty, any existing value will be removed.

Example: json

{
  "action": "setKey",
  "key": "myReviewKey"
}

Set Author Name

`action` String	`"setAuthorName"`
`authorName` String	Value to set. If empty, any existing value will be removed.

Example: json

{
  "action": "setAuthorName",
  "authorName": "myAuthorName"
}

Set Customer

`action` String	`"setCustomer"`
`customer` CustomerResourceIdentifier	Value to set. If empty, any existing value will be removed.

Example: json

{
  "action": "setCustomer",
  "customer": {
    "typeId": "customer",
    "id": "0c2eaad4-833c-43c1-98a4-5d03f57e9329"
  }
}

Set Rating

This update action produces the ReviewRatingSet Message.

`action` String	`"setRating"`
`rating` Int	Value to set. If empty, any existing value will be removed. Minimum: `-100`Maximum: `100`

Example: json

{
  "action": "setRating",
  "rating": 60
}

Set Target

`action` String	`"setTarget"`
`target` Can be ProductResourceIdentifier, or ChannelResourceIdentifier	Value to set, specified as ProductResourceIdentifier or ChannelResourceIdentifier, respectively. If empty, any existing value will be removed. (oneOf): `ProductResourceIdentifier,ChannelResourceIdentifier`

Example: json

{
  "action": "setTarget",
  "target": {
    "typeId": "product",
    "id": "{{product-id}}"
  }
}

Set Text

`action` String	`"setText"`
`text` String	Value to set. If empty, any existing value will be removed.

Example: json

{
  "action": "setText",
  "text": "reviewText"
}

Set Title

`action` String	`"setTitle"`
`title` String	Value to set. If empty, any existing value will be removed.

Example: json

{
  "action": "setTitle",
  "title": "reviewTitle"
}

Set Locale

`action` String	`"setLocale"`
`locale` Locale	Value to set. If empty, any existing value will be removed.

Example: json

{
  "action": "setLocale",
  "locale": "en-US"
}

Transition State

Transition to a new State. This update action produces the Review State Transition Message.

`action` String	`"transitionState"`
`state` StateResourceIdentifier	Value to set. If there is no State yet, the new State must be an initial State. If the existing State has `transitions` set, there must be a direct transition to the new State. If `transitions` is not set, no validation is performed. If the new State does not have the role `ReviewIncludedInStatistics`, the Review is not taken into account in the ratings statistics of the target.
`force` Boolean	Switch validations on or off.

Example: json

{
  "action": "transitionState",
  "state": {
    "typeId": "state",
    "id": "{{state-id}}"
  }
}

Set Custom Type

`action` String	`"setCustomType"`
`type` TypeResourceIdentifier	Defines the Type that extends the Review with Custom Fields. If absent, any existing Type and Custom Fields are removed from the Review.
`fields` FieldContainer	Sets the Custom Fields fields for the Review.

Example: json

{
  "action": "setCustomType",
  "type": {
    "id": "{{type-id}}",
    "typeId": "type"
  },
  "fields": {
    "exampleStringField": "TextString"
  }
}

Set CustomField

`action` String	`"setCustomField"`
`name` String	Name of the Custom Field.
`value` CustomFieldValue	If `value` is absent or `null`, this field will be removed if it exists. Removing a field that does not exist returns an InvalidOperation error. If `value` is provided, it is set for the field defined by `name`.

Example: json

{
  "action": "setCustomField",
  "name": "exampleStringField",
  "value": "TextString"
}

Delete Review

Delete Review by ID

DELETE

https://api.{region}.commercetools.com/{projectKey}/reviews/{id}

OAuth 2.0 Scopes:

manage_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`id` String	`id` of the Review.

Query parameters:

`version` Int	Last seen version of the resource.
`expand` Expansion	The parameter can be passed multiple times.
`dataErasure` Boolean	To erase all related personal data in compliance with GDPR, set to `true`. Default: `false`

Response:

200

Review

asapplication/json

Request Example:cURL

curl -X DELETE https://api.{region}.commercetools.com/{projectKey}/reviews/{id}?version={version} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

200 Response Example: Reviewjson

{
  "id": "919d5ab5-bf99-4bda-a6fd-ab3ee8123456",
  "version": 1,
  "includedInStatistics": true,
  "authorName": "John Doe",
  "title": "Incredible",
  "text": "Best product ever",
  "rating": 5,
  "target": {
    "typeId": "product",
    "id": "8fddacac-6ef5-4e66-af6e-124452123456"
  },
  "customer": {
    "typeId": "customer",
    "id": "8a8b3e43-b9b0-4b30-8c27-58148123456"
  },
  "custom": {
    "type": {
      "typeId": "type",
      "id": "3939dd9c-0884-4bfa-99c2-40b426123456"
    },
    "fields": {
      "authorMail": "john.doe@example.com"
    }
  },
  "createdAt": "2016-10-20T06:48:53.829Z",
  "lastModifiedAt": "2016-10-20T06:48:53.829Z"
}

Delete Review by Key

DELETE

https://api.{region}.commercetools.com/{projectKey}/reviews/key={key}

OAuth 2.0 Scopes:

manage_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`key` String	`key` of the Review.

Query parameters:

`version` Int	Last seen version of the resource.
`expand` Expansion	The parameter can be passed multiple times.
`dataErasure` Boolean	To erase all related personal data in compliance with GDPR, set to `true`. Default: `false`

Response:

200

Review

asapplication/json

Request Example:cURL

curl -X DELETE https://api.{region}.commercetools.com/{projectKey}/reviews/key={key}?version={version} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

200 Response Example: Reviewjson

{
  "id": "919d5ab5-bf99-4bda-a6fd-ab3ee8123456",
  "version": 1,
  "includedInStatistics": true,
  "authorName": "John Doe",
  "title": "Incredible",
  "text": "Best product ever",
  "rating": 5,
  "target": {
    "typeId": "product",
    "id": "8fddacac-6ef5-4e66-af6e-124452123456"
  },
  "customer": {
    "typeId": "customer",
    "id": "8a8b3e43-b9b0-4b30-8c27-58148123456"
  },
  "custom": {
    "type": {
      "typeId": "type",
      "id": "3939dd9c-0884-4bfa-99c2-40b426123456"
    },
    "fields": {
      "authorMail": "john.doe@example.com"
    }
  },
  "createdAt": "2016-10-20T06:48:53.829Z",
  "lastModifiedAt": "2016-10-20T06:48:53.829Z"
}

Reviews

Representations.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Review.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

ReviewDraft.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

ReviewPagedQueryResponse.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

ReviewRatingStatistics.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

ReviewReference.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

ReviewResourceIdentifier.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Get Review.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Get Review by ID.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Get Review by Key.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Query Reviews.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Check if Review exists.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Check if Review exists by ID.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Check if Review exists by Key.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Check if Review exists by Query Predicate.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Create Review.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Update Review.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Update Review by ID.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Update Review by Key.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Update actions.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Set Key.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Set Author Name.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Set Customer.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Set Rating.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Set Target.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Set Text.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Set Title.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Set Locale.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Transition State.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Set Custom Type.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Set CustomField.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Delete Review.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Delete Review by ID.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Delete Review by Key.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Representations

Review

ReviewDraft

ReviewPagedQueryResponse

ReviewRatingStatistics

ReviewReference

ReviewResourceIdentifier

Get Review

Get Review by ID

Get Review by Key

Query Reviews

Check if Review exists

Check if Review exists by ID

Check if Review exists by Key

Check if Review exists by Query Predicate

Create Review

Update Review

Update Review by ID

Update Review by Key

Update actions

Set Key

Set Author Name

Set Customer

Set Rating

Set Target

Set Text

Set Title

Set Locale

Transition State

Set Custom Type

Set CustomField

Delete Review

Delete Review by ID

Delete Review by Key