handler interface api styles

Closes #657