add REST documentation for search module

I'd prefer if the required ones could come before the optional ones in this list.

Also, any reason we can't use the `[...]` notation for optional model parameters like we do in the `@REST` directives? /cc @stuartf