public function metadata($path = '', $fileLimit = 10000, $hash = false, $list = true, $includeDeleted = false, $rev = null, $locale = null, $sandbox = false)
        {
            // build url
            $url = '1/metadata/';
            $url .= ($sandbox) ? 'sandbox/' : 'dropbox/';
            $url .= trim((string) $path, '/');

            // build parameters
            $parameters                                 = null;
            $parameters['file_limit']                   = (int) $fileLimit;
            if((bool) $hash) $parameters['hash']        = '';
            $parameters['list']                         = ($list) ? 'true' : 'false';
            if((bool) $includeDeleted)
                $parameters['include_deleted']          = 'true';
            if($rev !== null) $parameters['rev']        = (string) $rev;
            if($locale !== null) $parameters['locale']  = (string) $locale;

            // make the call
            return (array) $this->doCall($url, $parameters);
        }