From what I can tell it looks like all of the REST endpoints only document their `200` responses–it'd be nice to also know how requests can fail.