Would be good to have some kind of documentation describing how this REST endpoint works and the different values that can be provided