---
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}`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/goacoustic/apis/acoustic-content-api/docs/authoring/v1/sites/:site-id/pages/:page-id/put.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/goacoustic/apis/acoustic-content-api.md) - [All operations](https://skmtc.dev/goacoustic/apis/acoustic-content-api/llms.txt) - [OpenAPI document](https://skmtc.dev/goacoustic/apis/acoustic-content-api/revisions/677305266d89?raw)