How are max limits on the CQL search REST API currently decided?

I’ve noticed the same CQL query in different Confluence Cloud instances enforce a different max limit. I’m aware the limits themselves aren’t part of the API specification and are subject to change without deprecation notification which means you can’t rely on them staying the same.

  • Can anybody give insight into what factors are causing the different max limits across different Confluence instances?
    (NOTE: there aren’t any expansions used in the example)

  • Also is there a reason a next link isn’t included in _links?
    (the other REST resources have this and it would make it easier to walk all the results)

e.g.
/rest/api/search?cql=type = page and space.key = ABC&limit=1000&excerpt=none

// https://abc.atlassian.net/wiki
"start": 0,
"limit": 1000,
"size": 500, // <--- 1000 ignored, max appears to be 500
"totalSize": 4028
// https://xyz.atlassian.net/wiki
"start": 0,
"limit": 1000,
"size": 1000, // <--- 1000 respected
"totalSize": 3401
4 Likes