> 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.24.1 Release Notes

This release window covers four small, focused changes. Worklists are now a supported item type in search input UI blocks. A `derivedFrom` field on assay schemas is being deprecated. A new alpha endpoint enables programmatic rotation of OAuth2 client secrets for app definitions. The webhook envelope gains a required `channel` field to distinguish between the `events` and `app_signals` delivery channels.

### What's changing?

#### Added

* **Alpha** (`v2/alpha`): New endpoint `POST /app-definitions/{app_def_id}/generate-oauth2-client-secret` to regenerate the OAuth2 client secret for a Benchling app definition; returns a new `AppClientSecret` model containing `clientSecret` and `id`.

#### Changed

* **Stable / default**: `SearchInputUiBlockItemType` gains a new `WORKLIST` enum value, enabling worklists as a search input item type in UI blocks.

#### Removed

* Nothing removed.

#### Fixed / Deprecated

* **Webhooks v0 stable**: `WebhookEnvelopeV0` now reflects the `channel` field (enum: `events`, `app_signals`) identifying the delivery channel for each webhook.
* `derived_from` on `AssayResultSchema`, `AssayRunSchema`, and `BaseAssaySchema` (stable + default tiers) is now marked deprecated: "This feature is no longer supported."