If you've got @RequestMapping(value = "/my/api/v1/and/{id}/something") on your class and @RequestMapping(method = POST) on your method, no documentation will be generated. You have to specify a value="", e.g. @RequestMapping(value = "", method = POST) for it to be picked up.