---
title: "Bulk Update Molecules"
method: POST
path: "/molecules:bulk-update"
tags: ["molecules"]
---

# Bulk Update Molecules

`POST /molecules:bulk-update`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/molecules:bulk-update`
- Auth: HTTP bearer

Bulk Update Molecules

## Request body

- MoleculesBulkUpdateRequest
  - `molecules` MoleculeBulkUpdate[]
    - `aliases` string[]: Aliases to add to the Molecule.
    - `authorIds` string[]: IDs of users to set as the Molecule's authors.
    - `chemicalStructure` MoleculeStructure
      - `structureFormat` 'smiles' | 'molfile': Format of the chemical structure. - smiles - molfile
      - `value` string: Chemical structure in SMILES or molfile format. Pass an empty SMILES string to create a Molecule with no defined structure (equivalent to leaving the structure blank in the app's sketcher).
    - `customFields` CustomFields
    - `fields` Fields
    - `folderId` string: ID of the folder containing the Molecule.
    - `name` string: Name of the Molecule.
    - `schemaId` string: ID of the Molecule's schema.
    - `entityRegistryId` string
    - `id` string

## 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 [Molecule](https://docs.benchling.com/docs/api/v2/benchling-api/molecules/get-molecule) resources that were updated.

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