clarity updates to the upload-api doc