What parameters does PUT /V1/categories/:id accept?

This endpoint accepts 1 parameter: category (Magento\Catalog\Api\Data\CategoryInterface) required.

What does PUT /V1/categories/:id return?

The endpoint returns Magento\Catalog\Api\Data\CategoryInterface.

PUTCatalog · Magento 2.4.9 Admin · Magento_Catalog::categories

PUT /V1/categories/:id

Q: What does the PUT /V1/categories/:id endpoint do in Magento 2?

PUT /V1/categories/:id is a Magento 2 REST endpoint in the Catalog module. Create category service. Requires an admin Bearer token with ACL Magento_Catalog::categories.

Q: Does PUT /V1/categories/:id require authentication?

This endpoint requires an admin Bearer token with ACL: Magento_Catalog::categories.

PUT /V1/categories/:id is a Magento 2 REST endpoint in the Catalog module. Create category service. Requires an admin Bearer token with ACL Magento_Catalog::categories.

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

Magento\Catalog\Api\Data\CategoryInterface

Service contract

Magento\Catalog\Api\CategoryRepositoryInterface::save

Authorization

Admin Bearer token with ACL:

Magento_Catalog::categories

Body parameters

category Magento\Catalog\Api\Data\CategoryInterface Required

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Authorization

Bearer <ACCESS_TOKEN> admin token with ACL: Magento_Catalog::categories

Path

/V1/categories/:id

Body

{
  "category": {
    "available_sort_by": [
      {}
    ],
    "children": "",
    "created_at": "",
    "custom_attributes": [
      {
        "attribute_code": "",
        "value": ""
      }
    ],
    "extension_attributes": {},
    "id": 0,
    "include_in_menu": false,
    "is_active": false,
    "level": 0,
    "name": "",
    "parent_id": 0,
    "path": "",
    "position": 0,
    "updated_at": ""
  }
}