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

This endpoint accepts 1 parameter: page (Magento\Cms\Api\Data\PageInterface) required.

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

The endpoint returns Magento\Cms\Api\Data\PageInterface.

Does PUT /V1/cmsPage/:id require authentication?

This endpoint requires an admin Bearer token with ACL: Magento_Cms::save.

MageSmith

PUTCms · Magento 2.4.9 Admin · Magento_Cms::save

PUT /V1/cmsPage/:id

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

PUT /V1/cmsPage/:id is a Magento 2 REST endpoint in the Cms module. Save page. Requires an admin Bearer token with ACL Magento_Cms::save.

PUT /V1/cmsPage/:id is a Magento 2 REST endpoint in the Cms module. Save page. Requires an admin Bearer token with ACL Magento_Cms::save.

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

Returns

Magento\Cms\Api\Data\PageInterface

Service contract

Magento\Cms\Api\PageRepositoryInterface::save

Authorization

Admin Bearer token with ACL:

Magento_Cms::save

Body parameters

page Magento\Cms\Api\Data\PageInterface 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_Cms::save

Path

/V1/cmsPage/:id

Body

{
  "page": {
    "active": false,
    "content": "",
    "content_heading": "",
    "creation_time": "",
    "custom_layout_update_xml": "",
    "custom_root_template": "",
    "custom_theme": "",
    "custom_theme_from": "",
    "custom_theme_to": "",
    "id": 0,
    "identifier": "",
    "layout_update_xml": "",
    "meta_description": "",
    "meta_keywords": "",
    "meta_title": "",
    "page_layout": "",
    "sort_order": "",
    "title": "",
    "update_time": ""
  }
}