When a rest api action saves an object as part of results, the cached generated file uses a call to __set_state to restore the object.

If this method is not declared in the class of this returned object, a fatal error ensues...

This should be at least documented