This should be documented in the "Developing heka plugins" section as well, just like the restarting interface is documented so that someone creating a heka plugin/decoder knows its available.