Add API documentation for PUT and DELETE on nested endpoints

[#73431654]

Signed-off-by: Joseph Palermo <jpalermo@pivotallabs.com>
Improve Api Doc example titles

[#73431654]

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