hbb api ref simplified using dynamic gemini objects