Issue a write note request to either create or replace a note, as applicable. If the named note does not exist, proceed as for a create note request. If the note does exist, proceed as for a replace request.

The write request is useful in cases where the existence of the note is immaterial to the application. For some applications, the existence (or not) of a note conveys information that helps ensure that the application is operating as expected. Such an application might use a create request in contexts where the note is not expected to exist. If the note does exist, the application relies on the request being rejected to detect this unexpected state. Similarly, the application might use a replace request in contexts where the note is supposed to exist. If the note does not exist, the application relies on the request being rejected to detect this unexpected state. If the application does not have such requirements, or perhaps does not have them for certain notes, the write request is a simple way to accomplish a "create if not exist else replace" behavior. Using combinations of create and replace requests to achieve the same behavior is more complicated in the general case.