Issue/21881 document resource type

Supersedes #1799 with some additional documentation of error responses.