Document errors and exceptions for REST API

Added possible errors and exceptions to all the REST API calls in
the docs, under the "Errors" heading for each call

Closes-Bug: #1386798

Change-Id: Id427624a0dc8e223ce1e01e0c7df8aad6a81c5ad