---
title: "Update a page."
method: PUT
path: "/authoring/v1/sites/{site-id}/pages/{page-id}"
tags: ["Authoring sites"]
---

# Update a page.

`PUT /authoring/v1/sites/{site-id}/pages/{page-id}`

Updates the page metadata specified by `page-id` in the site specified by `site-id`.
Move of a page to a different parent or repositioning with other sibling pages is not supported, use the move endpoint instead.
The full page metadata must be supplied, partial updates are not supported.
<br />User roles: admin, manager, editor

## Path parameters

- `site-id` string, uuid, required
- `page-id` string, uuid, required

## Query parameters

- `forceOverride` boolean

## Request body

- object — Update of Page Metadata
  - `name` string — The name of the page.
  - `id` string — The ID of the page item.
  - `rev` string — (Optional) The revision of the document.
  - `position` string — The position of the page relative to its sibling pages. Position is an integer value starting at 0.
  - `description` string — Page description.
  - `layoutId` string — Page layout template ID.
  - `contentId` string — The ID of the page content item this item represents.
  - `contentTypeId` string — The ID of the page content type.
  - `segment` string — Friendly URL segment.
  - `title` string — Page title.
  - `parentId` string — (Optional) The ID of the parent page. This should not be set if the new page is to be a root page. Otherwise, set this field to the ID of the parent page.
  - `classification` string — this is always `page`
  - `hideFromNavigation` boolean — (Optional) This controls the visibility of the page in the site navigation menu. Set it to `true` to hide the page. The default setting (if this field is not supplied) is `false`. If to `true` set on a parent page, it will override the corresponding flags in all descendant pages. Therefore, hiding a page will hide all its descendants in the site navigation menu.

## Response `200`

Page successfully updated.

- object — Page Metadata
  - `id` string — The ID of the page item.
  - `rev` string — The current revision of the document.
  - `name` string — The name of the page item.
  - `contentId` string — The ID of the page content item this item represents.
  - `contentTypeId` string — The ID of the page content type.
  - `position` string — Position relative to sibling pages giving the order of the pages. Position is an integer value starting at 0.
  - `description` string — Page description.
  - `layoutId` string — Page layout template ID.
  - `segment` string — Friendly URL segment.
  - `title` string — Page title.
  - `parentId` string — Not present if root page otherwise id of parent page
  - `classification` string — This is always `page`
  - `lastModified` string — The last modified date of this page in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ. This field is read only.
  - `lastModifierId` string — This is the user id of the user that modified the page. This field is read only
  - `created` string — The creation date of this page in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ. This field is read only
  - `creatorId` string — This is the user id of the user that created the page. This field is read only.
  - `hideFromNavigation` boolean — This controls the visibility of the page in the site navigation menu. If set to `true` this page is hidden. If set to `true` on a parent page, it will override the corresponding flags in all descendant pages. Therefore, hiding a page will hide all its descendants in the site navigation menu.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `409` — Conflict
- `429` — Too Many Requests
- `default` — Unexpected error

---

[API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/revisions/677305266d89/schema)