> 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.

## SDK Version 1.18.0 Release Notes

Version 1.18.0 of the Benchling SDK adds support for new API endpoints and model properties, and removes deprecated code.

### What’s Changing?

### Added

* New service `benchling.v2.stable.instrument_queries`. See API reference for [Instrument Queries](https://benchling.com/api/reference#/Instrument%20Queries).
* New beta service `benchling.v2.beta.app_definitions`. See API reference for [App Definitions](https://benchling.com/api/v2-beta/reference#/App%20Definitions) .
* New beta service `benchling.v2.beta.analyses`. See API reference for [Analyses](https://benchling.com/api/v2-beta/reference#/Analyses).
* New beta service `benchling.v2.beta.audit`. See API reference for [Audit](https://benchling.com/api/v2-beta/reference#/Audit).
* New alpha service `benchling.v2.alpha.assemblies`. See API reference for [Assemblies](https://benchling.com/api/v2-alpha/reference#/Assemblies) .
* In `benchling.v2.beta.entries`, added a beta version of `update_entry`. Unlike the stable version, this allows you to update custom fields. See API reference for [Update a notebook entry's metadata](https://benchling.com/api/v2-beta/reference#/Entries/updateEntry).
* In `benchling_sdk.models.Container`, `ContainerWithCoordinates`, `ContainerUpdate`, and `Well`, new property `role` (with corresponding class `ExperimentalWellRole`).
* In `benchling_sdk.models.webhooks.v0`, new webhook class `CanvasCreatedWebhookV2Beta`.
* In `benchling_api_client.v2.beta.models.benchling_app_manifest_features_item.BenchlingAppManifestFeaturesItem`, new property `locations`, for specifying whether a canvas for a feature can be embedded in a notebook entry or entry template.
* In `benchling.sdk.models.EntitySchemaType`, added the value `RNA_SEQUENCE` which was mistakenly omitted from the API spec.
* In workflow node classes such as `benchling_sdk.models.WorkflowTaskNodeDetails`, added the property `node_type`.

### Changed

* In `benchling_sdk.models.WorkflowOutput`, the `task` property has been renamed to `workflow_task`. The `task` name was a mistake in both the SDK and the OpenAPI spec; both have now been fixed to match the actual data that the Benchling API has always returned.
* In `benchling_api_client.v2.beta.models.collaboration.Collaboration`, some properties had incorrect type hints indicating that they might be `None`. In reality, these properties are never null so `None` is no longer in the type hints.

### Removed

* Removed `benchling.v2.beta.organizations` and `benchling.v2.beta.teams`. These services were previously promoted to the stable API.
* In `benchling.v2.beta.entries`, removed `create_entry`. This was already deprecated in the API and had no differences from the stable version.
* Removed `benchling_sdk.apps.config.helpers` and `benchling_sdk.apps.config.mock_config`. These were obsolete, left over from the old v1 app configuration APIs which were previously removed.

### Fixed

* Fixed the deserialization of workflow node classes such as `benchling_sdk.models.WorkflowTaskNodeDetails`. Previously, these items were always being converted to the class `WorkflowOutputNodeDetails` regardless of the actual node type.

Version 1.18.0 of the Benchling SDK is now live! Find the SDK in [PyPI](https://pypi.org/project/benchling-sdk/1.18.0/) .