PUT/products/{id}

Replace product

Full replacement. All mutable fields overwritten. Triggers `products.updated` webhook.

Parameters 1

Name	Type	Description
idrequired	path · integer	Resource identifier

ReturnsProduct

AcceptsProductInput

Bearer token required

Response examples

200Product replaced

application/json example derived from schema

{
  "id": 1,
  "categoryId": 4,
  "name": "Desk Lamp",
  "description": "Ultra-fast connectivity with rock-solid reliability.",
  "price": 161.28,
  "originalPrice": 231.38,
  "currency": "USD",
  "stock": 257,
  "sku": "SKU-00001",
  "rating": 4.4,
  "reviewCount": 188,
  "image": "https://picsum.photos/seed/prod1/400/400",
  "images": [
    "https://picsum.photos/seed/prod1-0/400/400",
    "https://picsum.photos/seed/prod1-1/400/400",
    "https://picsum.photos/seed/prod1-2/400/400",
    "https://picsum.photos/seed/prod1-3/400/400",
    "https://picsum.photos/seed/prod1-4/400/400"
  ],
  "weight": 9.19,
  "dimensions": {
    "width": 33.4,
    "height": 40,
    "depth": 14.6
  },
  "isAvailable": true,
  "isFeatured": false,
  "tags": [
    "backend"
  ],
  "createdAt": "2024-05-30T01:37:26.059Z",
  "updatedAt": "2026-12-15T02:55:19.943Z"
}

400400 — invalid input or malformed JSON

application/json

{
  "error": {
    "status": 400,
    "message": "Request body required"
  }
}

404404 — resource not found

application/json

{
  "error": {
    "status": 404,
    "message": "users #999 not found"
  }
}

Try ItMock API v2.0.1

Code examples

curl -X PUT -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' -d '{
  "categoryId": 1,
  "name": "Wireless earbuds",
  "price": 79.99,
  "sku": "SKU-01001",
  "stock": 100
}' 'https://api.rodin.dev/mock/products/{id}'

fetch("https://api.rodin.dev/mock/products/{id}", {
  method: "PUT",
  headers: {
      "Authorization": "Bearer <TOKEN>",
      "Content-Type": "application/json"
    },
  body: "{\n  \"categoryId\": 1,\n  \"name\": \"Wireless earbuds\",\n  \"price\": 79.99,\n  \"sku\": \"SKU-01001\",\n  \"stock\": 100\n}",
})
  .then((response) => response.json())
  .then((data) => console.log(data))

import requests

url = "https://api.rodin.dev/mock/products/{id}"
headers = {
    "Authorization": "Bearer <TOKEN>",
    "Content-Type": "application/json"
}
data = "{\n  \"categoryId\": 1,\n  \"name\": \"Wireless earbuds\",\n  \"price\": 79.99,\n  \"sku\": \"SKU-01001\",\n  \"stock\": 100\n}"

response = requests.put(url, headers=headers, data=data)
print(response.json())

Authentication

Authentication

Bearer token

Paste cURL

Server:

https://api.rodin.dev/mockhttp://localhost:3002

Body:

{ "categoryId": 1, "name": "Wireless earbuds", "price": 79.99, "sku": "SKU-01001", "stock": 100 }