How to update update content property for page by id?

Confluence Development
1

Hi everyone,

I’m currently trying to update a content property for a Confluence page using the REST API (by page ID). Still, I’ve run into several issues and haven’t been able to find any working examples or reliable guidance.

What I’m trying to do

I want to update a content property on a page using its ID via the REST API.

Issues encountered

  • I couldn’t find any complete or working sample in the official documentation.

  • The REST API documentation seems incomplete and lacks practical examples for this specific use case.

  • The actual API responses I receive do not fully match what is described in the documentation.

  • It’s unclear which endpoint and request format should be used to update (vs. create) a content property.

What I’ve tried

  • Checked the official Confluence Cloud REST API docs

  • Attempted using endpoints like:

    • wiki/api/v2/pages/1165394197/properties/1165394525

  • Tried both GET and PUT methods, but the results were inconsistent or resulted in errors

Questions

  1. What is the correct endpoint and HTTP method to update an existing content property for a page by ID?

  2. Is there a required request body format (including versioning) that is not clearly documented?

  3. Are there any working examples or recommended practices for this?

2

The endpoint https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-content-properties/#api-pages-page-id-properties-property-id-put works for me.
My Request looked like this:
PUT wiki/api/v2/pages/{pageId}/properties/{propertyId}

{
    "key":"myKey",
    "value":"myNewValue",
    "version":{
        "number":2
    }
}
3

Thank you, but if I want to change my page’s status, for example, from In progress to Ready for review, how should I compose my request body?

image
image521×426 20 KB

4

To set the content state, you have to use the v1 API: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-states/#api-group-content-states

5

Thank you, Marc, that works for me.