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

## \[SUNSET] DNA, RNA, AA Sequences, Enzymes, Codon Usage Tables v2-alpha, v2-beta and v2-experimental Endpoints

A number of `v2-experimental`, `v2-alpha` and `v2-beta` endpoints for DNA Sequences, DNA oligos, RNA oligos, AA Sequences, Enzymes, and Codon Usage Tables will be sunset on **June 3, 2024**. Please use their stable `v2` equivalents instead.

### What’s changing?

A number of `v2-experimental`,  `v2-alpha` and `v2-beta` stability endpoints will be sunset in favor of their `v2` stable equivalents. Each of these endpoints has a promoted `v2` counterparts, so no functionality is being lost. A list of each endpoint and it's `v2` stable counterpart is below:

| Endpoint removed                                      | Equivalent v2 endpoint                                                                                                       |
| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| /v2-alpha/aa-sequences:back-translate                 | [/v2/aa-sequences:back-translate](https://benchling.com/api/reference#/AA%20Sequences/backTranslate)                         |
| /v2-beta/aa-sequences:find-matching-regions           | [/v2/aa-sequences:find-matching-regions](https://benchling.com/api/reference#/AA%20Sequences/findMatchingRegionsAaSequences) |
| /v2-beta/aa-sequences:match-amino-acids               | [/v2/aa-sequences:match-amino-acids](https://benchling.com/api/reference#/AA%20Sequences/matchAminoAcidsAaSequences)         |
| /v2-experimental/aa-sequences:match-amino-acids       | [/v2/aa-sequences:match-amino-acids](https://benchling.com/api/reference#/AA%20Sequences/matchAminoAcidsAaSequences)         |
| /v2-beta/aa-sequences:search-amino-acids              | [/v2/aa-sequences:search-amino-acids](https://benchling.com/api/reference#/AA%20Sequences/searchAaSequences)                 |
| /v2-experimental/aa-sequences:search-amino-acids      | [/v2/aa-sequences:search-amino-acids](https://benchling.com/api/reference#/AA%20Sequences/searchAaSequences)                 |
| /v2-beta/aa-sequences/\{entity\_registry\_id}:upsert  | [/v2/aa-sequences/\{entity\_registry\_id}:upsert](https://benchling.com/api/reference#/AA%20Sequences/upsertAaSequence)      |
| /v2-beta/aa-sequences:bulk-upsert                     | [/v2/aa-sequences:bulk-upsert](https://benchling.com/api/reference#/AA%20Sequences/bulkUpsertAASequences)                    |
| /v2-alpha/codon-usage-tables                          | [/v2/codon-usage-tables](https://benchling.com/api/reference#/Codon%20Usage%20Tables/listCodonUsageTables)                   |
| /v2-alpha/enzymes                                     | [/v2/enzymes](https://benchling.com/api/reference#/Enzymes/listEnzymes)                                                      |
| /v2-alpha/dna-sequences:optimize-codons               | [/v2/dna-sequences:optimize-codons](https://benchling.com/api/reference#/DNA%20Sequences/optimizeCodons)                     |
| /v2-alpha/dna-sequences:find-matching-regions         | [/v2/dna-sequences:find-matching-regions](https://benchling.com/api/reference#/DNA%20Sequences/findMatchingRegions)          |
| /v2-beta/dna-sequences/\{entity\_registry\_id}:upsert | [/v2/dna-sequences/\{entity\_registry\_id}:upsert](https://benchling.com/api/reference#/DNA%20Sequences/upsertDNASequence)   |
| /v2-beta/dna-sequences:bulk-upsert                    | [/v2/dna-sequences:bulk-upsert](https://benchling.com/api/reference#/DNA%20Sequences/bulkUpsertDnaSequences)                 |
| /v2-beta/dna-oligos/\{entity\_registry\_id}:upsert    | [/v2/dna-oligos/\{entity\_registry\_id}:upsert](https://benchling.com/api/reference#/DNA%20Oligos/upsertDNAOligo)            |
| /v2-beta/dna-oligos:bulk-upsert                       | [/v2/dna-oligos:bulk-upsert](https://benchling.com/api/reference#/DNA%20Oligos/bulkUpsertDnaOligos)                          |
| /v2-beta/rna-oligos/\{entity\_registry\_id}:upsert    | [/v2/rna-oligos/\{entity\_registry\_id}:upsert](https://benchling.com/api/reference#/RNA%20Oligos/upsertRNAOligo)            |
| /v2-beta/rna-oligos:bulk-upsert                       | [/v2/rna-oligos:bulk-upsert](https://benchling.com/api/reference#/RNA%20Oligos/bulkUpsertRnaOligos)                          |
| /v2-alpha/rna-oligos/\{oligo\_id} \[GET]              | [/v2/rna-oligos/\{oligo\_id} \[GET\]](https://benchling.com/api/reference#/RNA%20Oligos/getRNAOligo)                         |
| /v2-alpha/rna-oligos/\{oligo\_id} \[PATCH]            | [/v2/rna-oligos/\{oligo\_id} \[PATCH\]](https://benchling.com/api/reference#/RNA%20Oligos/updateRNAOligo)                    |
| /v2-alpha/rna-oligos \[GET]                           | [/v2/rna-oligos \[GET\]](https://benchling.com/api/reference#/RNA%20Oligos/listRNAOligos)                                    |
| /v2-alpha/rna-oligos \[POST]                          | [/v2/rna-oligos \[POST\]](https://benchling.com/api/reference#/RNA%20Oligos/createRNAOligo)                                  |
| /v2-alpha/rna-oligos:bulk-create                      | [/v2/rna-oligos:bulk-create](https://benchling.com/api/reference#/RNA%20Oligos/bulkCreateRNAOligos)                          |

### When is this happening?

Stable `v2` endpoints are available now! The `v2-alpha`, `v2-beta` and `v2-experimental` endpoints are currently marked deprecated, and will be fully sunset on **June 3, 2024**