> ## Documentation Index > Fetch the complete documentation index at: https://developers.partoo.co/llms.txt > Use this file to discover all available pages before exploring further. # Update a review > Update the state of a review to treated/not_treated ## OpenAPI ````yaml /assets/openapi/openapi-bundled.yaml put /reviews/{review_id} openapi: 3.1.0 info: title: Partoo Rest API version: v2 license: name: © Copyright Partoo url: https://www.partoo.co/en/gtu-api/ x-logo: url: >- https://partoo-client-images.s3.amazonaws.com/logo-partoo-restapi-white.png description: > ## Introduction The Partoo Rest API allows you to automate all the actions that are possible to do in the Partoo Web Application. The Partoo Rest API can be used for many different purposes: - Create/update/delete your businesses & users if you are a client. - Create/subscribe/manage organizations, businesses & users if you are a reseller. - Retrieve data on businesses you have access to if you are a publisher. - ... servers: - url: https://api.partoo.co/v2 description: Production server - url: https://api.sandbox.partoo.co/v2 description: Sandbox server (dev environment for clients & partners) security: - ApiKeyAuth: [] paths: /reviews/{review_id}: put: tags: - Reviews summary: Update a review description: | Update the state of a review to treated/not_treated operationId: updateReview parameters: - in: path name: review_id required: true schema: $ref: '#/components/schemas/ReviewId' requestBody: required: true content: application/json: schema: description: Request body to post a reply type: object required: - review_id - state properties: state: description: Reply state type: string enum: - treated - not_treated responses: '200': description: OK content: application/json: schema: allOf: - $ref: '#/components/schemas/Review' - properties: state: example: treated '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' components: schemas: ReviewId: type: integer description: Review id example: 34 Review: description: Business Review on partner type: object properties: key: type: string org_id: $ref: '#/components/schemas/OrgId' id: $ref: '#/components/schemas/ReviewId' business_id: $ref: '#/components/schemas/BusinessId' partner: $ref: '#/components/schemas/ReviewPublisherLabel' partner_id: $ref: '#/components/schemas/ReviewPublisherId' author_name: $ref: '#/components/schemas/ReviewAuthorName' date: $ref: '#/components/schemas/ReviewCreateDate' update_date: $ref: '#/components/schemas/ReviewUpdateDate' delete_date: $ref: '#/components/schemas/ReviewDeleteDate' rating: $ref: '#/components/schemas/ReviewRating' recommended: $ref: '#/components/schemas/ReviewRecommended' title: $ref: '#/components/schemas/ReviewTitle' content: $ref: '#/components/schemas/ReviewBody' state: $ref: '#/components/schemas/ReviewState' link: $ref: '#/components/schemas/ReviewLink' comments: $ref: '#/components/schemas/Comment' tags: type: array description: Tags associated to the review items: $ref: '#/components/schemas/Tag' media_links: type: array description: > Array of Google photo URLs associated with the review. Populated when `with_media_links=true` query parameter is used. Empty array if no associated media found or if `with_media_links=false`. items: type: string format: uri example: - https://lh3.googleusercontent.com/gpms... - https://lh3.googleusercontent.com/gpms-cs-s/AB8u6HYwO... OrgId: description: Unique identifier of an organization in Partoo. type: integer example: 42 BusinessId: description: Business id type: string example: 5409c35a97bbc544d8e26737 ReviewPublisherLabel: type: string description: Publisher label enum: - google_my_business - facebook - tripadvisor ReviewPublisherId: type: string description: Review id on publisher example: accounts/114063712393225091258/locations/74805271119400652054 ReviewAuthorName: type: string description: | The author name of the review. **Note:** Replies don't have an author. example: Castorche ReviewCreateDate: type: string description: Review creation date format: datetime example: '2017-07-01T16:10:23.156000+02:00' ReviewUpdateDate: type: string description: Review update date format: datetime example: '2017-08-01T19:15:54.256000+02:00' ReviewDeleteDate: type: string description: Review deletion date (only specified if the review has been deleted) format: datetime ReviewRating: type: integer description: Review rating (can be null) maximum: 5 minimum: 0 example: 3 ReviewRecommended: type: boolean description: Review recommended (can be null) ReviewTitle: type: string description: Review title ReviewBody: type: string description: 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... ReviewState: type: string description: Reply state enum: - treated - not_treated - deleted ReviewLink: type: string format: uri description: Link to review on publisher platform Comment: description: Reply to a review type: object properties: id: $ref: '#/components/schemas/CommentId' partner_id: $ref: '#/components/schemas/ReviewPublisherId' created: $ref: '#/components/schemas/CreatedDate' author_name: $ref: '#/components/schemas/ReviewAuthorName' content: $ref: '#/components/schemas/CommentBody' date: type: string description: Comment date format: datetime example: '2017-08-01T19:15:54.256000+02:00' update_date: type: string format: datetime description: | Comment update date. Only specified if the comment was updated example: '2017-08-01T19:15:54.256000+02:00' can_edit: type: boolean description: | If the current user can or cannot edit a reply **Note:** This applies on Facebook replies only. A reply left by an external user on Facebook cannot be edited. example: true review_id: $ref: '#/components/schemas/ReviewId' parent_id: $ref: '#/components/schemas/ParentId' user_id: type: string description: | User id of the comment author example: 123456789abcdef2f60c42ff is_reply_suggestion: type: boolean description: | If AI reply suggestion was used to generate this comment replies: type: array items: $ref: '#/components/schemas/Comment' description: | List of replies to this comment Tag: description: Tag type: object properties: id: $ref: '#/components/schemas/TagId' label: description: The label of the tag allOf: - $ref: '#/components/schemas/TagLabel' color: $ref: '#/components/schemas/TagColor' CommentId: type: integer description: Comment id example: 82938 CreatedDate: type: string description: Creation date on Partoo format: datetime example: '2019-08-01T19:15:54.256000+02:00' CommentBody: type: string description: Reply content example: Merci ❤️ ParentId: type: integer description: | id of the parent comment. Is only specified if the comment is a reply to another comment **Note:** This applies on Facebook replies only. TagId: description: Tag id type: integer example: 25 TagLabel: description: > The label of the tag Must be <= 30 characters and cannot contain a comma (commas will be ignored) type: string example: food TagColor: description: The color of the tag, in hexadecimal representation type: string enum: - '#808080' - '#9B7CDB' - '#F47FBE' - '#4D4D4D' - '#9E6957' - '#2F8DE4' - '#37CED0' - '#53C944' - '#B1DA34' - '#F78234' - '#F4BD38' - '#992842' example: '#808080' responses: '401': description: You are not authenticated content: application/json: schema: description: Error that occurs when you are not authenticated type: object properties: errors: type: object description: The detail of the error encountered properties: authentication: type: string default: User not authenticated '403': description: | You are not allowed to perform this action content: application/json: schema: description: > Error that occurs when you are authenticated but you are trying to perform an action you are not allowed to perform type: object properties: errors: type: object description: The detail of the error encountered properties: authorization: type: string default: Operation not allowed '404': description: Resource does not exist content: application/json: schema: description: >- Error that occcurs when you are trying to reach a resource that does not exist type: object properties: errors: type: object description: The detail of the error encountered properties: json: type: string default: Resource not found securitySchemes: ApiKeyAuth: description: > 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. type: apiKey in: header name: x-APIKey ````