adding post on api definitions being the truth in the api contract