[SD-668] Updated User API to reflect AD Changes
Update apiary.apib

Replaced "readonly" with "_readonly" as per Petr's comments
Merge remote-tracking branch 'siva/master'