Add API documentation for PUT and DELETE on nested endpoints

[#73431654]

Signed-off-by: Joseph Palermo <jpalermo@pivotallabs.com>