Spec Sync [Always Open]

There are many new changes in spec.  This issue will be open for any future PR to address it on rolling basis. 

Please consider sending PR which syncs spec. 

Each PR scope could be just single API endpoint or single type - to make it easily reviewable and subsequently merged. 