Skip to content

PUT/categories/{id}

Replace category

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

Parameters 1

NameTypeDescription
idrequiredpath · integerResource identifier

ReturnsCategory

AcceptsCategoryInput

Bearer token required

Response examples

200Category replaced

application/json example derived from schema

{
  "id": 1,
  "name": "Electronics",
  "slug": "electronics",
  "description": "Gadgets, devices, and electronic accessories",
  "image": "https://picsum.photos/seed/cat1/300/200",
  "productCount": 5,
  "createdAt": "2022-01-06T04:19:58.076Z"
}
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"
  }
}

Released under the MIT License.