---
title: "Update content property for page by id"
method: PUT
path: "/pages/{page-id}/properties/{property-id}"
tags: ["Content Properties"]
---

# Update content property for page by id

`PUT /pages/{page-id}/properties/{property-id}`

## Request

- Base URL: `https://no-default/wiki/api/v2`
- URL: `https://no-default/wiki/api/v2/pages/{page-id}/properties/{property-id}`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `https://auth.atlassian.com/authorize`
    - Token URL: `https://auth.atlassian.com/oauth/token` scopes: `read:page:confluence`, `write:page:confluence`

Update a content property for a page by its id. 

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
Permission to edit the page.

## Path parameters

- `page-id` integer, required
- `property-id` integer, required

## Request body

- ContentPropertyUpdateRequest
  - `key` string: Key of the content property
  - `value` unknown
  - `version` object: New version number and associated message
    - `number` integer: Version number of the new version. Should be 1 more than the current version number.
    - `message` string: Message to be associated with the new version.

## Response `200`

Returned if the content property was updated successfully.

- ContentProperty
  - `id` string: ID of the property
  - `key` string: Key of the property
  - `value` unknown
  - `version` Version
    - `createdAt` string, date-time: Date and time when the version was created. In format "YYYY-MM-DDTHH:mm:ss.sssZ".
    - `message` string: Message associated with the current version.
    - `number` integer: The version number.
    - `minorEdit` boolean: Describes if this version is a minor version. Email notifications and activity stream updates are not created for minor versions.
    - `authorId` string: The account ID of the user who created this version.

## Other responses

- `400`: Returned if an invalid request is provided.
- `401`: Returned if the authentication credentials are incorrect or missing from the request.
- `404`: Returned if the calling user does not have permission to view the specified page or the page was not found.

---

[API](https://skmtc.dev/atlassian/apis/the-confluence-cloud-rest-api-v2.md) - [All operations](https://skmtc.dev/atlassian/apis/the-confluence-cloud-rest-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/the-confluence-cloud-rest-api-v2/revisions/246e0eec8f43?raw)