List Folder Longpoll
A longpoll endpoint to wait for changes on an account. In conjunction with [list_folder/continue](api:dropbox-api:POST/2/files/list_folder/continue),
this call gives you a low-latency way to monitor an account for file changes. The connection
will block until there are changes available or a timeout occurs. This endpoint is useful
mostly for client-side apps.
**Required scope:** `files.metadata.read`
**Endpoint format:** [RPC](https://docs.dropboxapi.com/dropbox-api/docs/technical-reference/request-response-formats#rpc-endpoints)
**Authentication:** [No Authentication](https://docs.dropboxapi.com/dropbox-api/docs/auth-types#no-authentication), [Dropbox-API-Select-Admin (Whole Team)](https://docs.dropboxapi.com/dropbox-api/docs/auth-types#admin-authentication-via-dropbox-api-select-admin)
Request
This endpoint expects an object.
cursor
A cursor as returned by list_folder or list_folder/continue. Cursors
retrieved by setting ListFolderArg.include_media_info to true are
not supported.
timeout
A timeout in seconds. The request will block for at most this length
of time, plus up to 90 seconds of random jitter added to avoid the
thundering herd problem. Care should be taken when using this
parameter, as some network infrastructure does not support long
timeouts.
Response headers
X-Dropbox-Request-Id
A unique identifier for the request, useful for debugging and support.
Response
Successful response
changes
Indicates whether new changes are available. If true, call list_folder/continue to retrieve the changes.
backoff
If present, backoff for at least this many seconds before calling list_folder/longpoll again.
Errors
401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error