Skip to main content
PUT
/
reviews
/
{review_id}
Update a review
curl --request PUT \
  --url https://api.partoo.co/v2/reviews/{review_id} \
  --header 'Content-Type: application/json' \
  --header 'x-APIKey: <api-key>' \
  --data '{
  "state": "treated"
}'
{
  "key": "<string>",
  "org_id": 42,
  "id": 34,
  "business_id": "5409c35a97bbc544d8e26737",
  "partner": "google_my_business",
  "partner_id": "accounts/114063712393225091258/locations/74805271119400652054",
  "author_name": "Castorche",
  "date": "2017-07-01T16:10:23.156000+02:00",
  "update_date": "2017-08-01T19:15:54.256000+02:00",
  "delete_date": "<string>",
  "rating": 3,
  "recommended": true,
  "title": "<string>",
  "content": "Magasin un peu vieillot , mais personnel très sympathique, nombreuses références en rayons , un très bon choix côté vin...",
  "state": "treated",
  "link": "<string>",
  "comments": {
    "id": 82938,
    "partner_id": "accounts/114063712393225091258/locations/74805271119400652054",
    "created": "2019-08-01T19:15:54.256000+02:00",
    "author_name": "Castorche",
    "content": "Merci ❤️",
    "date": "2017-08-01T19:15:54.256000+02:00",
    "update_date": "2017-08-01T19:15:54.256000+02:00",
    "can_edit": true,
    "review_id": 34,
    "parent_id": 123,
    "user_id": "123456789abcdef2f60c42ff",
    "is_reply_suggestion": true,
    "replies": [
      {}
    ]
  },
  "tags": [
    {
      "id": 25,
      "label": "food",
      "color": "#808080"
    }
  ]
}

Authorizations

x-APIKey
string
header
required

The authentication system on Partoo API is using API Key that should be put in the header of the request (the name of the header is x-APIKey). An api_key is linked to a user. This user's role will give you different access level to the API features.

Path Parameters

review_id
integer
required

Review id

Example:

34

Body

application/json

Request body to post a reply

state
enum<string>
required

Reply state

Available options:
treated,
not_treated

Response

OK

Business Review on partner

key
string
org_id
integer

Organization id

Example:

42

id
integer

Review id

Example:

34

business_id
string

Business id

Example:

"5409c35a97bbc544d8e26737"

partner
enum<string>

Publisher label

Available options:
google_my_business,
facebook,
tripadvisor
partner_id
string

Review id on publisher

Example:

"accounts/114063712393225091258/locations/74805271119400652054"

author_name
string

The author name of the review.

Note: Replies don't have an author.

Example:

"Castorche"

date
string<datetime>

Review creation date

Example:

"2017-07-01T16:10:23.156000+02:00"

update_date
string<datetime>

Review update date

Example:

"2017-08-01T19:15:54.256000+02:00"

delete_date
string<datetime>

Review deletion date (only specified if the review has been deleted)

rating
integer

Review rating (can be null)

Required range: 0 <= x <= 5
Example:

3

Review recommended (can be null)

title
string

Review title

content
string

Review body content

Example:

"Magasin un peu vieillot , mais personnel très sympathique, nombreuses références en rayons , un très bon choix côté vin..."

state
enum<string>

Reply state

Available options:
treated,
not_treated,
deleted
Example:

"treated"

Link to review on publisher platform

comments
object

Reply to a review

tags
object[]

Tags associated to the review