API consistency - deleting resources by patching the 'deleted' property
With merge request fix: correct the possible response status codes (404 and 409) related to organizations and datatypes endpoints 409 - Conflict were removed.
But the description for the PATCH /organizations/{organization-id}/faqs/{faq-id} endpoint remained unchanged: "An faq is deleted by defining the deleted property.
An faq MAY only be deleted once.
Attempting to change a deleted faq MUST result in a HTTP 409 - Conflict response."
Giving us a hint why this error code was introduced in the first place.
My suggestion is to add 409 - Conflict to all the PATCH operations that can delete (or revoke) resources.
Edited by Tamas Szabo