Missing API documentation for `GET /search/users`

[Eldemarkki]

There is no mention of the GET /search/users in the API spec, we should add it there along with all the parameters it requires and the response format