# Pages

The Pages API lets you create and manage the pages of your sites.
Learn more about [Pages](https://doc.sitecore.com/xmc/en/users/xm-cloud/pages.html).

## Retrieve a page

 - [GET /api/v1/pages/{pageId}](https://api-docs.sitecore.com/xmc/pages-api/pages/retrievepage.md): Fetches information about a page (including statistics, template, layout, publishing and workflow information).

## Update field values

 - [PATCH /api/v1/pages/{pageId}](https://api-docs.sitecore.com/xmc/pages-api/pages/updatefields.md): Updates values of existing fields for a specific page.

## Delete a page

 - [DELETE /api/v1/pages/{pageId}](https://api-docs.sitecore.com/xmc/pages-api/pages/deletepage.md): Deletes a page.

## Retrieve a page state

 - [GET /api/v1/pages/{pageId}/state](https://api-docs.sitecore.com/xmc/pages-api/pages/retrievepagestate.md): Fetches basic information about a page (identifier, display name and revision) and optionally workflow, layout and version data.

## Search for pages

 - [GET /api/v1/pages/search](https://api-docs.sitecore.com/xmc/pages-api/pages/search.md): Fetches a list of pages and folders whose name or display name match the search criteria, while applying filters and language options.

## Retrieve insert options

 - [GET /api/v1/pages/{pageId}/insertoptions](https://api-docs.sitecore.com/xmc/pages-api/pages/retrieveinsertoptions.md): Fetches the list of possible templates which are compatible insert options for a page.

## Retrieve page versions

 - [GET /api/v1/pages/{pageId}/versions](https://api-docs.sitecore.com/xmc/pages-api/pages/retrievepageversions.md): Fetches the list of page versions.

## Add a version to a page

 - [POST /api/v1/pages/{pageId}/versions](https://api-docs.sitecore.com/xmc/pages-api/pages/addpageversions.md): Creates a new version of a page.

## List live variant identifiers for a page

 - [GET /api/v1/pages/{pageId}/live/variants](https://api-docs.sitecore.com/xmc/pages-api/pages/listpagevariants.md): Fetches the identifiers of currently active personalization variants for a page.

## Check if a page is published to Edge

 - [GET /api/v1/pages/{pageId}/live](https://api-docs.sitecore.com/xmc/pages-api/pages/getlivepagestate.md): Checks if the requested page is published to Edge.

## Create a page

 - [POST /api/v1/pages](https://api-docs.sitecore.com/xmc/pages-api/pages/createpage.md): Creates a new page.

## Save a page layout

 - [POST /api/v1/pages/{pageId}/layout](https://api-docs.sitecore.com/xmc/pages-api/pages/savelayout.md): Updates the layout of a page.

## Save page fields

 - [POST /api/v1/pages/{pageId}/fields](https://api-docs.sitecore.com/xmc/pages-api/pages/savefields.md): Updates the fields of a page.

## Duplicate a page

 - [POST /api/v1/pages/{pageId}/duplicate](https://api-docs.sitecore.com/xmc/pages-api/pages/duplicatepage.md): Creates a copy of a page.

## Rename a page

 - [POST /api/v1/pages/{pageId}/rename](https://api-docs.sitecore.com/xmc/pages-api/pages/renamepage.md): Changes the name of a page.

## Add a page version

 - [POST /api/v1/pages/{pageId}/version](https://api-docs.sitecore.com/xmc/pages-api/pages/addpageversion.md): Creates a new version of a page.

## Delete a version of a page

 - [DELETE /api/v1/pages/{pageId}/versions/{versionNumber}/{language}](https://api-docs.sitecore.com/xmc/pages-api/pages/deletepageversions.md): Deletes the specified version of a page.