Where are the PUTs? POST /inbound/faxes/{id}/mark - Mark as read/unread
Shouldn't that be a PUT on /inbound/faxes/{id}? Seems like you're updating the representation of the fax, not performing some non-idempotent action (like a resend, which can easily justify a POST).
In general though, I think the API looks good. I'm sure it's much better than the SOAP equivalent!
Where are the PUTs? POST /inbound/faxes/{id}/mark - Mark as read/unread
Shouldn't that be a PUT on /inbound/faxes/{id}? Seems like you're updating the representation of the fax, not performing some non-idempotent action (like a resend, which can easily justify a POST).
In general though, I think the API looks good. I'm sure it's much better than the SOAP equivalent!