add REST documentation for mediacore module

That's what I understood from @stuartf (that swagger requires body parameters to be defined this way). Perhaps he can suggest an alternative. (And I thought it was a bit weird as well.)