more docs on filtering and auth
auto gen api boilerplate