User Space Over Quota Exception

The Java SDK v1.8.2 is for API v1, which is deprecated:

https://blogs.dropbox.com/developers/2016/06/api-v1-deprecated/

You should instead use the latest version, which uses API v2:

https://www.dropbox.com/developers/documentation/java

When using that, if you try to upload to an account that's currently over quota, you'll get an UploadErrorException indicating the issue. Specifically, it will have an UploadError.path with a WriteError.isInsufficientSpace.

In code, that means you can do something like this:

        } catch (UploadErrorException ex) {
            System.err.println("Error uploading to Dropbox: " + ex.getMessage());
            if (ex.errorValue.isPath()) {
                if (ex.errorValue.getPathValue().getReason().isInsufficientSpace()) {
                    System.err.println("Couldn't upload because the account has insufficient space.");
                }
            }

To check the available space, you can use getSpaceUsage. The returned values are documented in SpaceUsage.