We had a customer mis-reading the switchover command documentation, putting the actual monitor section name too early in the command. Also they were using galeramon, so a switchover command does not exist in that monitor anyway.
They got a "404 not found" in both cases without any further info, and so were lost.
Looking at raw TCP traffic with Wireshark I'm seeing that there is indeed no additional content in the maxscale API reply providing further info, just a HTTP header with the 404 status, and some default header fields, e.g. maxctrl sent:
which failed as "galeramon" does not implement "switchover", only "mariadbmon" does. All that came back was:
IMHO this should definitely have an extra content section containing e.g.
"Module 'galeramon' has no command 'switchover'"
Also at first the customer used
call command Galera-Monitor switchover RHEL8-Galera-2 RHEL8-Galera-1
call command galeramon switchover Galera-Monitor RHEL8-Galera-2 RHEL8-Galera-1
so here they should have gotten something like
"No such module "Galera-Monitor", available modules are 'mariadbmon', 'galeramon', 'xpandmon' ..."
back there to help them finding the wrong command syntax used.
Whether the feedback is returned as simple plain text message, or embedded in a JSON document, I don't care either way. But some feedback beyond "something's wrong" is definitely needed