Confluence Rest API V2 - Struggling to create a page with the new editor

Confluence Development Confluence Cloud
, , ,
1

Hey Dev Community,
I’m running into a bit of a head-scratcher with the new Confluence API and thought I’d reach out to all of you for some help.

Previously, we could create a page using the editor v2, by sending some metadata with the post request on this path

With API V2 things have changed, and the tricks we used doesn’t work anymore :cry:
It seems impossible to post a page with editor v2 with the page api.
Am I missing something, or is it the API ?

3 Likes
2

Can you share the request body you have used? When I create a page with /wiki/api/v2/pages and the following request body, it uses the v2 editor by default:

{
  "spaceId": "...",
  "status": "current",
  "title": "API page",
  "parentId": "...",
  "body": {
    "representation": "storage",
    "value": "Created with the v2 API"
  }
}

This is the editor content property of the new page:

{
  "id": "...",
  "key": "editor",
  "value": "v2",
  ...
}
1 Like
3

Yes sure

{
    "spaceId": "...",
    "status": "current",
    "title": "Interesting page title",
    "parentId": "...",
    "body": {
        "representation": "storage",
        "value": "some html stuff"
    }
}

So basically it’s the same payload except for the body value which is some encoded HTML. Maybe this is it, I’ll look into it.

Thank you for your response, by the way.

4

It appears that the solution to my scenario involves sending the inner content of the HTML body rather than the body as a whole.

So instead of sending:

{
    "spaceId": "...",
    "status": "current",
    "title": "Interesting page title",
    "parentId": "...",
    "body": {
        "representation": "storage",
        "value": "<body><p>The page content</p></body>"
    }
}

We’ll have to send:

{
    "spaceId": "...",
    "status": "current",
    "title": "Interesting page title",
    "parentId": "...",
    "body": {
        "representation": "storage",
        "value": "<p>The page content</p>"
    }
}
1 Like
5

You can force the legacy editor (v1) or the new editor (v2) by setting/updating the “editor” content property.

You cannot set content properties with the V2 REST API (as far as I know) during page creation. Therefore, you have to create the page first and then check if the “editor” property already exists. If it does, update it; otherwise, create it.

I believe this to be the better solution if you want to force the editor choice. Many other HTML tags, besides <body>, can trigger the legacy editor. Additionally, Confluence might change their legacy-detection code in the future.

Here is some pseudo-code:

// Step 1: Create the page
page = post("https://{your-domain}/wiki/api/v2/pages", {
  "spaceId": "...",
  "status": "current",
  "title": "Interesting page title",
  "parentId": "...",
  "body": {
    "representation": "storage",
    "value": "<p>The page content</p>"
  }
});

// Step 2: Search for the "editor" property
search_for_editor_properties = get(`https://{your-domain}/wiki/api/v2/pages/${page.id}/properties?key=editor`);

if (search_for_editor_properties.results.length === 0) {
  // Step 3: If the editor property does not exist, create it
  post(`https://{your-domain}/wiki/api/v2/pages/${page.id}/properties`, {
    "key": "editor",
    "value": "v2"
  });
} else {
  // Step 4: If the editor property exists, update it
  const editor_property = search_for_editor_properties.results[0];
  put(`https://{your-domain}/wiki/api/v2/pages/${page.id}/properties/${editor_property.id}`, {
    "key": "editor",
    "value": "v2",
    "version": {
      "number": editor_property.version.number + 1
    }
  });
}

So my current process is:

  1. Create a draft
  2. Set the editor property (using the method above)
  3. Set the content
  4. Publish

This works very reliably but it is a pain that I now need to make multiple calls with the V2 REST API for something that I was able to do with one call with the old V1 API. Together with all the retry logic I have, this is very reliable but also very cumbersome. I’m just lucky that in my application, execution time isn’t really an issue.

3 Likes
6

Hey man I know this is old but thank you so much I was struggling so hard with this old editor problem cause I’m passing the body on a HTML, and I fund another problem if u pass a very large HTML, it triggers the old editor, but this approach works flawless.

7

Thanks for the workaround of setting the property via additional API calls. It’s sad that this is necessary and I hope Atlassian will fix their V2 API for page creation.