list_folder limit is not documented

[Artem K.]

I cannot find in the documentation for http endpoint https://api.dropboxapi.com/2/files/list_folder the maximum number of files that is retrieved in one call. From the fact it returns has_more property in the response, I assume there must be a limit. I would like to know what that limit is.

[Greg-DB]

We don't guarantee any particular page size, and I believe it can vary in practice. Apps should always just check has_more and call back to /files/list_folder/continue if it's true, and so on.

[Artem K.]

Understood, thank you

[Tom B.38]

I understand that there is no guarantee. However I would like to test my /files/list_folder/continue logic. Can we get a rough estimate? Or is there a way for me to set the limit for testing purposes?

[Greg-DB]

If I recall correctly, I believe you should get multiple pages after around 1,000 items. There isn't a way to force the limit though.

[Tom B.38]

Thanks, I'll give that a go.

[Tom B.38]

For anyone else looking. I got a second page at 2000 files exactly. Guess YMMV though.

[Greg-DB]

I just wanted to follow up here to let you know that you can now set an approximate limit on the list_folder page size using the "limit" parameter:

https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder

Hope this helps!