PTTV-54 Finished update:api implementation with detailed request and response DTO JSDoc and closer match with code generated by old Bob