Delete COMPOSITION mentions preceding_version_uid

Delete COMPOSITION mentions preceding_version_uid in the description but it is not used as If-Match request header.

If If-Match with preceding_version_uid is required, then the Header Parameters section should be added.

Delete directory is using If-Match with preceding_version_uid. It also uses ETag to prevent simultaneous updates of a resource from overwriting each other.

Why is Delete composition using uid_based_id in the url instead of If-Match with preceding_version_uid?

Is this because Update COMPOSITION was used as a starting point for “Delete composition”? It looks to me that uid_based_id path parameter was kept and If-Match was removed, taking ETag with it.

Some further observations if helpful:

  • “Delete COMPOSITION” returns 409 Conflict when supplied uid_based_id doesn’t match the latest version.
  • “Delete DIRECTORY” returns 412 Precondition Failed when If-Match request header doesn’t match the latest version.
  • “Update COMPOSITION” returns 412 Precondition Failed when If-Match request header doesn’t match the latest version.
  • “Update directory” returns 412 Precondition Failed when If-Match request header doesn’t match the latest version.

“Delete COMPOSITION” does not follow the pattern when the supplied version UID does not match the latest version.