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

## Deprecating alpha App Configuration APIs

All `v2-alpha` app configuration endpoints are now officially deprecated; these endpoints will be fully sunset on **December 15th.**

### What’s changing?

With the full release of [App Configuration](/docs/app-configuration), Benchling has promoted the related APIs from alpha to either beta or stable. Now that endpoints for all relevant functionallity are generally available, the corresponding alpha endpoints are being deprecated. While alpha functionality is generally subject to change at any time, these features have been widely used in their current form for long enough advanced warning is warranted. The following list of endpoints represent functionality that has been promoted from alpha; each endpoint listed is now deprecated, and where applicable a link to the promoted beta/stable endpoint in included:

##### Promoted to stable

* `POST v2-alpha/app-configuration-items` - [link](https://benchling.com/api/reference#/Apps/createAppConfigurationItem)
* `GET v2-alpha/app-configuration-items/<item_id>` - [link](https://benchling.com/api/reference#/Apps/getAppConfigurationItemById)
* `PATCH v2-alpha/app-configuration-items/<item_id>` - [link](https://benchling.com/api/reference#/Apps/getAppConfigurationItemById)
* `POST v2-alpha/app-configuration-items:bulk-create` - [link](https://benchling.com/api/reference#/Apps/bulkCreateAppConfigurationItems)
* `POST v2-alpha/app-configuration-items:bulk-update` - [link](https://benchling.com/api/reference#/Apps/bulkUpdateAppConfigurationItems)
* `GET v2-alpha/apps` - [link](https://benchling.com/api/reference#/Apps/listBenchlingApps)
* `POST v2-alpha/apps` - [link](https://benchling.com/api/reference#/Apps/createBenchlingApp)
* `GET v2-alpha/apps/<app_id>` - [link](https://benchling.com/api/reference#/Apps/getBenchlingAppByID)
* `PATCH v2-alpha/apps/<app_id>` - [link](https://benchling.com/api/reference#/Apps/patchBenchlingApp)
* `POST v2-alpha/apps:archive` - [link](https://benchling.com/api/reference#/Apps/archiveBenchlingApps)
* `POST v2-alpha/apps:unarchive` - [link](https://benchling.com/api/reference#/Apps/unarchiveBenchlingApps)
* `GET v2-beta/apps/<app_id>/configuration` - no stable replacement; use `app-configuration-items` endpoints

##### Promoted to beta

* `GET v2-alpha/apps/<app_id>/manifest.yaml` - [link](https://benchling.com/api/v2-beta/reference#/Apps/getBenchlingAppManifest)
* `PUT v2-alpha/apps/<app_id>/manifest.yaml` - [link](https://benchling.com/api/v2-beta/reference#/Apps/putBenchlingAppManifest)

### When is this happening?

The listed alpha endpoints are currently deprecated, and will be fully sunset on **December 15th**. Please update any integrations to leverage the newly promoted beta or stable endpoints before that time.