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

# Move a page.

`POST /authoring/v1/sites/{site-id}/pages/move`

Use this endpoint to move a page. The body of the request should be empty.
The query parameters should include the 'sourceId', 'sourceRev', 'targetPosition', the optional 'targetId' and 'targetRev'.
`sourceId` and `sourceRev` relate to the page to be moved.
`targetId` and `targetRev` relate to the destination parent page.  These are optional parameters, if not set it means the source page is to be moved to the site root.
The `targetPosition` field is required, it is an integer value starting at 0. It cannot exceed the number of child pages of the destination parent page.
If the move is successful, then the response body JSON object will contain the id and rev of the updated destination parent page (`targetId`), except in the case of moving to the site root then the response body is an empty JSON object.
A refresh of the page hierarchy is recommended after moving a page to a different parent page.
<br />User roles: admin, manager, editor

## Path parameters

- `site-id` string, uuid, required

## Query parameters

- `sourceId` string, uuid, required
- `sourceRev` string, required
- `targetId` string, uuid
- `targetRev` string
- `targetPosition` integer, required

## Response `200`

succcess.

- object — Target Parent Updated Values After Move
  - `id` string — (optional) The ID of the parent page item.
  - `rev` string — (optional) The latest revision of the parent page item document.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `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)