single thumbnail API support; spec refactoring