Update a review

POST https://api.tamio.com/v2/reviews/update/{uuid}

Updates an existing product review identified by its UUID. All core fields (rating, text, name) are required. The image can be replaced, removed (set to null), or left unchanged (omit the field).

Path Parameters

uuid string*

UUID of the review to update.

Body Parameters

product string*

UUID of the product being reviewed.

rating integer*

Star rating (0–5).

review_text string*

Main review content.

name string*

Name of the reviewer.

image string

UUID of an image asset to attach, null to remove, or omit to leave unchanged.

customer_review boolean

Whether this is a verified customer review.

created_at string

Custom creation timestamp (ISO 8601 string or Unix timestamp as string, up to 26 characters).

external_review string

URL to an external review document or image (PDF or image URL).

external_link string

External URL related to the review.

Responses

200 Review updated

Review updated

status integer

review Review

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`1002`	Review not found, product not found, or image asset not found

status integer

error string

error_code integer

401 Missing or invalid API key

Create a review

Delete a review

/reviews/update/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/reviews/update/{uuid}", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     "product": "123e4567-e89b-12d3-a456-426614174000",
9     "rating": 4,
10     "review_text": "Updated review — still a great product.",
11     "name": "Jane Smith",
12     "image": "bbb24567-e89b-12d3-a456-426614174000",
13     "customer_review": false,
14     "created_at": "2024-07-20T14:00:00Z",
15     "external_review": "https://example.com/updated-review.pdf",
16     "external_link": "https://google.com/maps/review/xyz"
17   })
18 });
19 const data = await response.json();

1 require "uri"
2 require "net/http"
3 require "json"
4 
5 url = URI("https://api.tamio.com/v2/reviews/update/{uuid}")
6 
7 https = Net::HTTP.new(url.host, url.port)
8 https.use_ssl = true
9 
10 request = Net::HTTP::Post.new(url)
11 request["Accept"] = "application/json"
12 request["Authorization"] = "Bearer YOUR_API_KEY"
13 request["Content-Type"] = "application/json"
14 request.body = {
15   product: "123e4567-e89b-12d3-a456-426614174000",
16   rating: 4,
17   review_text: "Updated review — still a great product.",
18   name: "Jane Smith",
19   image: "bbb24567-e89b-12d3-a456-426614174000",
20   customer_review: false,
21   created_at: "2024-07-20T14:00:00Z",
22   external_review: "https://example.com/updated-review.pdf",
23   external_link: "https://google.com/maps/review/xyz"
24 }.to_json
25 
26 response = https.request(request)
27 puts response.read_body

Responses

{
  "status": 200,
  "review": {
    "id": "999e4567-e89b-12d3-a456-426614174000",
    "object": "review",
    "name": "John Doe",
    "locale": "en",
    "review_text": "Excellent product, highly recommended!",
    "rating": 5,
    "created_at": 1718444400,
    "image": "https://cdn.tamio.com/assets/review-photo.jpg",
    "external_review": "https://example.com/review-screenshot.png",
    "external_link": "https://trustpilot.com/review/abc123",
    "product": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Premium Widget"
    },
    "customer": {
      "id": "223e4567-e89b-12d3-a456-426614174000",
      "name": "Jane Smith",
      "email": "[email protected]"
    },
    "customer_review": true,
    "invoice": {
      "prefix": "INV",
      "number": 1042,
      "date_bought": 1717000000
    }
  }
}

1	const response = await fetch("https://api.tamio.com/v2/reviews/update/{uuid}", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	"product": "123e4567-e89b-12d3-a456-426614174000",
9	"rating": 4,
10	"review_text": "Updated review — still a great product.",
11	"name": "Jane Smith",
12	"image": "bbb24567-e89b-12d3-a456-426614174000",
13	"customer_review": false,
14	"created_at": "2024-07-20T14:00:00Z",
15	"external_review": "https://example.com/updated-review.pdf",
16	"external_link": "https://google.com/maps/review/xyz"
17	})
18	});
19	const data = await response.json();

1	require "uri"
2	require "net/http"
3	require "json"
4
5	url = URI("https://api.tamio.com/v2/reviews/update/{uuid}")
6
7	https = Net::HTTP.new(url.host, url.port)
8	https.use_ssl = true
9
10	request = Net::HTTP::Post.new(url)
11	request["Accept"] = "application/json"
12	request["Authorization"] = "Bearer YOUR_API_KEY"
13	request["Content-Type"] = "application/json"
14	request.body = {
15	product: "123e4567-e89b-12d3-a456-426614174000",
16	rating: 4,
17	review_text: "Updated review — still a great product.",
18	name: "Jane Smith",
19	image: "bbb24567-e89b-12d3-a456-426614174000",
20	customer_review: false,
21	created_at: "2024-07-20T14:00:00Z",
22	external_review: "https://example.com/updated-review.pdf",
23	external_link: "https://google.com/maps/review/xyz"
24	}.to_json
25
26	response = https.request(request)
27	puts response.read_body