I think you just need to have a response schema that allows both formats

when I've had APIs like that, I've ended up splitting into different endpoints

e.g. one endpoint per command instead of one command endpoint that accepts a :command :frobnulate parameter

because that allows for better swagger docs, basically

and better coercion error messages

yeah, that makes sense, thanks!