MIFOSX-911 Update Api doc issues

This pull have 
a) Syntax corrections for api-docs example requests
b) Data validation fix for edit client.