> This page is for Developer Documentation.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.benchling.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.benchling.com/_mcp/server.

## 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](https://benchling.com/api/reference#/Containers/bulkUpdateContainers), 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:

```json
{
  "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.