#598 updated docummentation for several APIv2 resources