# Release of new endpoints for Confluence REST API v2

**URL:** <https://community.developer.atlassian.com/t/release-of-new-endpoints-for-confluence-rest-api-v2/65242>\
**Category:** Confluence Cloud Announcements\
**Tags:** new-feature, rest-api-v2, rest-api\
**Created:** [January 17, 2023, 7:37pm UTC](https://community.developer.atlassian.com/t/release-of-new-endpoints-for-confluence-rest-api-v2/65242 "2023-01-17T19:37:02Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![SimonKliewer](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/simonkliewer/32/42734_2.png) [@SimonKliewer](https://community.developer.atlassian.com/u/SimonKliewer)\
**Post date:** [January 17, 2023, 7:37pm UTC](https://community.developer.atlassian.com/t/release-of-new-endpoints-for-confluence-rest-api-v2/65242/1 "2023-01-17T19:37:02Z")

</div>

We are excited to announce new endpoints ready for use in version 2 of the Confluence REST API.

These granular endpoints correlate to more specific functions and allow you to be intentional about how you interact with Confluence data. Content is broken down into specific types - so you can work with pages, blog posts, and more as discrete entities.

When retrieving bulk content, these granular endpoints also offer faster speeds (up to 30x). Our new cursor-based pagination allows quick iteration through content.

The following endpoints are now available:

- Attachment
  - [Get attachments for blog post](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-attachment/#api-blogposts-id-attachments-get)
  - [Get attachments for custom content](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-attachment/#api-custom-content-id-attachments-get)
  - [Get attachments for page](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-attachment/#api-pages-id-attachments-get)

- Blog Post
  - [Get blog posts for label](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-blog-post/#api-labels-id-blogposts-get)

- Comment
  - [Get footer comments for page](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-comment/#api-pages-id-footer-comments-get)
  - [Get inline comments for page](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-comment/#api-pages-id-inline-comments-get)
  - [Get footer comments for blog post](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-comment/#api-blogposts-id-footer-comments-get)
  - [Get inline comments for blog post](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-comment/#api-blogposts-id-inline-comments-get)
  - [Get children footer comments](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-comment/#api-footer-comments-id-children-get)
  - [Get children inline comments](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-comment/#api-inline-comments-id-children-get)

- Custom Content
  - [Get custom content by type](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-custom-content/#api-custom-content-get)
  - [Get custom content by id](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-custom-content/#api-custom-content-id-get)

- Label
  - [Get labels for attachment](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-label/#api-attachments-id-labels-get)
  - [Get labels for blog post](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-label/#api-blogposts-id-labels-get)
  - [Get labels for page](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-label/#api-pages-id-labels-get)

- Page
  - [Get pages for label](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-page/#api-labels-id-pages-get)

- Space
  - [Get spaces](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-space/#api-spaces-get)

- Space Properties
  - [Get space properties in space](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-space-properties/#api-spaces-space-id-properties-get)
  - [Create space property in space](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-space-properties/#api-spaces-space-id-properties-post)
  - [Get space property by id](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-space-properties/#api-spaces-space-id-properties-property-id-get)
  - [Update space property by id](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-space-properties/#api-spaces-space-id-properties-property-id-put)
  - [Delete space property by id](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-space-properties/#api-spaces-space-id-properties-property-id-delete)

- Version
  - [Get attachment versions](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-version/#api-attachments-id-versions-get)
  - [Get blog post versions](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-version/#api-blogposts-id-versions-get)
  - [Get page versions](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-version/#api-pages-id-versions-get)

Please have a look at the [changelog](https://developer.atlassian.com/changelog/#CHANGE-853) for more information or our [docs](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/) to explore the API.

This release includes support for Connect, OAuth 2.0 (3LO), and Forge apps.

We’re eager to get your feedback at this time. Please join the discussion in the Developer Community by tagging your community questions with `rest-api-v2` to surface them to our team. Let us know what use cases you’re building, as well as what feature requests and fixes you’d like to see. We’re excited to work closely with you to shape the future of this API.

---

<div class="post-metadata">

**Author:** ![anon87782987](https://avatars.discourse-cdn.com/v4/letter/a/e79b87/32.png) [@anon87782987](https://community.developer.atlassian.com/u/anon87782987)\
**Post date:** [January 18, 2023, 8:57am UTC](https://community.developer.atlassian.com/t/release-of-new-endpoints-for-confluence-rest-api-v2/65242/2 "2023-01-18T08:57:16Z")

</div>

Hi @SimonKliewer,

Very cool to see you continue working on the V2 REST API, thanks for sharing!

I have a question about the following endpoints:

- [Get blog posts for label](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-blog-post/#api-labels-id-blogposts-get)
- [Get custom content by type](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-custom-content/#api-custom-content-get)
- [Get pages for label](https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-page/#api-labels-id-pages-get)

As far as I can tell, these endpoints provide results in a global scope, without being able to further restrict the scope to e.g. specific spaces or page trees, right? In a real world scenario I can imagine this being useful only for a limited amount of use cases. This is because from my experience apps tend to operate within a scope such as a certain space or a page tree, and not so much on a global level.

In large instances, where there are hundreds of thousands of pages, the performance benefits that the V2 endpoints may bring would then be lost if apps in turn have to perform significantly more REST calls towards Confluence.

Do you maybe already have in mind adding something like `spaceKey` or `ancestorId` parameters to these types of endpoints, or are these V2 endpoints rather intended to work exclusively on a global level?

Cheers,  
Sven

---

<div class="post-metadata">

**Author:** ![SimonKliewer](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/simonkliewer/32/42734_2.png) [@SimonKliewer](https://community.developer.atlassian.com/u/SimonKliewer)\
**Post date:** [January 19, 2023, 6:45pm UTC](https://community.developer.atlassian.com/t/release-of-new-endpoints-for-confluence-rest-api-v2/65242/3 "2023-01-19T18:45:06Z")

</div>

Hi @anon87782987!

Thanks so much for the response and enthusiasm towards the new endpoints!

This is great feedback - we are in the process of both delivering new endpoints and improving our now released endpoints, so input like this is exactly what we need.

We have logged both of these suggestions and will make additional posts as these improvements are made.

Thanks so much!

---

<div class="post-metadata">

**Author:** ![MatteoGubelliniSoftC](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/matteogubellinisoftc/32/42326_2.png) [@MatteoGubelliniSoftC](https://community.developer.atlassian.com/u/MatteoGubelliniSoftC)\
**Post date:** [January 26, 2023, 9:37am UTC](https://community.developer.atlassian.com/t/release-of-new-endpoints-for-confluence-rest-api-v2/65242/4 "2023-01-26T09:37:56Z")

</div>

Hello,  
Can v2 api can be called with custom UI? I’m getting 400 responses.  
Thanks  
Matteo

---

<div class="post-metadata">

**Author:** ![system](https://global.discourse-cdn.com/atlassiandeveloper/original/3X/7/8/78672baa5ba80cd9164376457051d0eec038b082.png) [@system](https://community.developer.atlassian.com/u/system)\
**Post date:** [February 25, 2023, 9:38am UTC](https://community.developer.atlassian.com/t/release-of-new-endpoints-for-confluence-rest-api-v2/65242/5 "2023-02-25T09:38:26Z")

</div>

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.
