Updated the API Spec according to :
https://issues.couchbase.com/browse/CBL-1649
https://issues.couchbase.com/browse/CBL-1651
https://issues.couchbase.com/browse/CBL-1652
https://issues.couchbase.com/browse/CBL-1653
https://issues.couchbase.com/browse/CBL-1840