fixed

Support for clearing quantity values when using `/containers:bulk-update` endpoint

Update: The rollout date of this change has been updated; the change will now go live on November 1st 2023. The behavior of the /containers:bulk-update endpoint is being updated to support clearing quantity values when null values are provided.

What’s changing?

Previously, when using the Bulk Update Containers endpoint, providing null values for the quantity field (e.g. "quantity": {"value": null, "units": null}) would result in the update being treated as if quantity were absent from the request entirely. This behavior is inconsistent with other areas of the Containers API; instead of clearing the quantity, this endpoint currently ignores these values.

Here is an example request body that demonstrates what providing these null values looks like:

{
  "containers": [
    {
      //...
      "quantity": {
        "units": null,
        "value": null
      },
      //...
    }
  ]
}

With this fix, explicitly providing null values for quantity will clear the container quantity (if there is one). This update properly differentiates between omitting quantity and explicitly providing null values, and brings the endpoint behavior in line with the rest of the API (e.g. PATCH /containers/{container_id}).

When is this happening?

This change will go live on September 29th 2023 November 1st 2023; if you have integrations that interact with the inventory, consider confirming that null values are used properly.