Well, it's  been there since the early days of the REST API, @andrerom... as said, it does need refactoring.

The only thing that can be done here is remove the @todo comment :-)