FUL-266 - add interface to flamingo + correct documentation