removed rotate_secret as a client action
collapsed _links
refactored update/create/read responses
cleaned up response sections
updated delete semantics, udpated update semantics