How to update Confluence page status (Outdated, In Progress) via REST API

Question

I am trying to update the page status of a Confluence page using REST APIs. Currently, I am able to fetch the page status successfully using the following API: 
GET /wiki/rest/api/content/{pageId}/state.

This API returns the current status of the page (for example: Outdated, In progress, etc.), and it works as expected. However, when I try to update the page status using the following API: 
PUT /wiki/rest/api/content/{pageId}/state

I receive the error below: Invalid status 'Outdated'. The status must be one of [current, draft]. From the error message, it appears that this API only supports updating the content state (current or draft), and not the page status values that are visible in the Confluence UI (such as Outdated, In progress, Ready for review, etc.).

My questions are:

* Is there any REST API available to update the Confluence page status (the same status shown in the UI)?

* If yes, which API should be used to update statuses like Outdated or In progress?

Any guidance or clarification would be greatly appreciated.

Ashesh Talukdar · Answer

Hi @Hari Krishna

Thanks for your response. As you mentioned, we can't update those statuses via api, and I initially thought the same. However, today I found an approach that allows updating the page status using the content state api and it worked.

API-

PUT /wiki/rest/api/content/{pageId}/state?status=current
Accept: application/json
Content-Type: applicaiton/json
body: {"name":"In progress"}

Main thing here is the URL must use either current or draft and we can specify our custom status inside body!

Hari Krishna · Answer

Hi @Ashesh Talukdar ,

No, you can’t update the Confluence page status (Outdated, In Progress, etc.) using REST API.

Why because:

The API you are using (/content/{id}/state) works only for the content state, which supports only:

" current " " draft "

The page status shown in the Confluence UI (Outdated, In Progress, Ready for review, etc.) is different and is not exposed for update via REST API.

So:

You can fetch the page status

You cannot update the page status using REST APIs

What you can do instead :

Change the page status manually in the Confluence UI

Use alternatives such as:

Labels

Page properties

Marketplace apps if automation is required

This is a current Confluence limitation, not an issue with your API call.