---
title: "Bulk Create DNA sequences"
method: POST
path: "/dna-sequences:bulk-create"
tags: ["dnaSequences"]
---

# Bulk Create DNA sequences

`POST /dna-sequences:bulk-create`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/dna-sequences:bulk-create`
- Auth: HTTP bearer

Bulk Create DNA sequences. Limit of 1000 DNA Sequences per request.

## Request body

- DnaSequencesBulkCreateRequest
  - `dnaSequences` DnaSequenceBulkCreate[]
    - `aliases` string[]: Aliases to add to the DNA sequence
    - `annotations` DnaAnnotation[]: Annotations to create on the DNA sequence.
      - `color` string: Hex color code used when displaying this feature in the UI.
      - `customFields` SequenceFeatureCustomField[]
        - `name` string: Name of the custom field
        - `value` string: Value of the custom field
      - `name` string
      - `notes` string
      - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
      - `start` integer: 0-based inclusive start index.
      - `strand` integer
      - `type` string
    - `authorIds` string[]: IDs of users to set as the DNA sequence's authors.
    - `bases` string, required: Base pairs for the DNA sequence.
    - `customFields` CustomFields
    - `fields` Fields
    - `folderId` string: ID of the folder containing the entity. Can be left empty when registryId is present.
    - `isCircular` boolean, required: Whether the DNA sequence is circular or linear.
    - `name` string, required: Name of the DNA sequence.
    - `parts` DnaSequencePart[]
      - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
      - `sequenceId` string
      - `start` integer: 0-based inclusive start index.
      - `strand` integer
    - `primers` Primer[]
      - `bases` string
      - `bindPosition` integer
      - `color` string
      - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
      - `name` string
      - `oligoId` string
      - `overhangLength` integer
      - `start` integer: 0-based inclusive start index.
      - `strand` integer
    - `schemaId` string: ID of the DNA sequence's schema.
    - `translations` Translation[]: Translations to create on the DNA sequence. Translations are specified by either a combination of 'start' and 'end' fields, or a list of regions. Both cannot be provided.
      - `color` string: Hex color code used when displaying this feature in the UI.
      - `customFields` SequenceFeatureCustomField[]
        - `name` string: Name of the custom field
        - `value` string: Value of the custom field
      - `name` string
      - `notes` string
      - `aminoAcids` string
      - `coerceStartCodonToMethionine` boolean: Whether to override the translation of the start codon to Methionine. Has no effect when the start codon already translates to Methionine.
      - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
      - `geneticCode` 'STANDARD' | 'VERTEBRATE_MITOCHONDRIAL' | 'YEAST_MITOCHONDRIAL' | 'MOLD_PROTOZOAN_COELENTERATE_MITOCHONDRIAL_MYCOPLASMA_SPIROPLASMA' | 'INVERTEBRATE_MITOCHONDRIAL' | 'CILIATE_DASYCLADACEAN_HEXAMITA_NUCLEAR' | 'ECHINODERM_FLATWORM_MITOCHONDRIAL' | 'EUPLOTID_NUCLEAR' | 'BACTERIAL_ARCHAEAL_PLANT_PLASTID' | 'ALTERNATIVE_YEAST_NUCLEAR' | 'ASCIDIAN_MITOCHONDRIAL' | 'ALTERNATIVE_FLATWORM_MITOCHONDRIAL' | 'CHLOROPHYCEAN_MITOCHONDRIAL' | 'TREMATODE_MITOCHONDRIAL' | 'SCENEDESMUS_OBLIQUUS_MITOCHONDRIAL' | 'THRAUSTOCHYTRIUM_MITOCHONDRIAL' | 'RHABDOPLEURIDAE_MITOCHONDRIAL' | 'CANDIDATE_DIVISION_SR1_GRACILIBACTERIA' | 'PACHYSOLEN_TANNOPHILUS_NUCLEAR' | 'MESODINIUM_NUCLEAR' | 'PERITRICH_NUCLEAR' | 'CEPHALODISCIDAE_MITOCHONDRIAL_UAA_TYR': The genetic code to use when translating the nucleotide sequence into amino acids.
      - `regions` TranslationRegionsItems[]
        - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
        - `start` integer: 0-based inclusive start index.
      - `start` integer: 0-based inclusive start index.
      - `strand` integer
    - `entityRegistryId` string: Entity registry ID to set for the registered entity. Cannot specify both entityRegistryId and namingStrategy at the same time.
    - `namingStrategy` 'NEW_IDS' | 'IDS_FROM_NAMES' | 'DELETE_NAMES' | 'SET_FROM_NAME_PARTS' | 'REPLACE_NAMES_FROM_PARTS' | 'KEEP_NAMES' | 'REPLACE_ID_AND_NAME_FROM_PARTS': Specifies the behavior for automatically generated names when registering an entity. - NEW_IDS: Generate new registry IDs - IDS_FROM_NAMES: Generate registry IDs based on entity names - DELETE_NAMES: Generate new registry IDs and replace name with registry ID - SET_FROM_NAME_PARTS: Generate new registry IDs, rename according to name template, and keep old name as alias - REPLACE_NAMES_FROM_PARTS: Generate new registry IDs, and replace name according to name template - KEEP_NAMES: Keep existing entity names as registry IDs - REPLACE_ID_AND_NAME_FROM_PARTS: Generate registry IDs and names according to name template
    - `registryId` string: Registry ID into which entity should be registered. this is the ID of the registry which was configured for a particular organization To get available registryIds, use the [/registries endpoint](https://docs.benchling.com/docs/api/v2/benchling-api/registry/list-registries) Required in order for entities to be created directly in the registry.

## Response `202`

This endpoint launches a [long-running task](https://docs.benchling.com/docs/api/v2/benchling-api/tasks/get-task) and returns the Task ID of the launched task.
When successful, the task returns a full list of [DNA Sequence](https://docs.benchling.com/docs/api/v2/benchling-api/dna-sequences/get-dna-sequence) resources that were created.

- AsyncTaskLink
  - `taskId` string

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/benchling/apis/benchling-api-2.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api-2/revisions/01d2fa8523cd?raw)