Search start parameter removed on August 10, 2020

What changed?

In February, we posted Upcoming changes to Confluence Cloud REST APIs to modernize search which deprecates the start parameter in favor of a cursor. While the deprecation period ended on July 15, 2020, the start parameter has remained usable in the search endpoints until recently. On Monday, August 10, 2020 , we went ahead and removed the parameter from our production systems.

Why did we make this change?

As we originally indicated in our original deprecation notice, we decided to change this parameter to modernize our search API and allow us to serve search requests at much higher performance and scale than before, and operate on datasets of much larger size.

This change was delayed from its initial rollout date because of the feedback received in the initial developer community post. We spent that time reviewing and addressing the concerns that were raised. Specifically, we have confirmed that the following bugs should now be fixed in production:

  • Connect impersonation bug - reported here
  • Incorrect title highlighting bug - reported here
  • Space directory partial-match filtering bug - reported here
  • Page properties report macro rendering bug - this macro failed to render in some cases.
  • Pagination bug #1 - incorrectly indicating there are more results when there are no more
  • Pagination bug #2 - cursor mismatched with sort criteria

What do you need to do?

If you are still using the start parameter, you will need to transition to cursor. Check out the documentation for an example.

What do you do if you are having problems?

Please raise any concerns at Confluence Cloud - The Atlassian Developer Community explaining what you are seeing and we will assist you as best we can.

2 Likes

Hi David,

Thank you for the share, our customers are experiencing important lag time following the cursor change, we suggested to increase the current page size limitation as you suggested through this thread
We are looking forward to hearing back from you.

Thank you

1 Like