Skip to navigation
Benchling APISolvent

Create Solvent

Beta

Create a solvent in the tenant’s solvent library.

Salts and solvents require the salt/solvent forms feature to be enabled on your tenant; contact your Benchling representative to turn it on. Creating a solvent requires tenant admin permissions. The solvent structure is immutable after creation. The combined salt and solvent library is limited to 2000 non-archived items, and each structure is limited to 50 atoms. An optional code must be unique (case-insensitive) across all salts and solvents in the tenant. Within the solvent library, names must be unique (case-insensitive) and each structure may appear only once; a salt may reuse a solvent’s name or structure. Archived solvents still reserve their name and structure, so an archived match must be unarchived rather than recreated.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

EARLY-ACCESSstringOptional

Set to true to access beta operations via /api/v3.

Request

This endpoint expects an object.
namestringRequired

The name of the solvent. Must be unique (case-insensitive) within the solvent library.

smilesstringRequired
The SMILES of the solvent's neutral form. The canonical SMILES and molecular formula are derived from it. Immutable after creation.
codestring or nullOptional

Optional configurable identifier for this solvent (e.g., “H2O”). Must be unique (case-insensitive) across all salts and solvents in the tenant.

Response

Created
__typenamestringOptional
archiveReasonstring or nullOptional
archivedbooleanOptional
calculatedMolecularWeightdouble or nullOptional
The molecular weight of the solvent.
canonicalSmilesstringOptional
The SMILES representation of the solvent after standardization.
codestring or nullOptional

Optional company-specific identifier for this solvent (e.g., “MH”, “DH”). Unique across both salts and solvents within a tenant.

createdAtstringOptional
idstringOptional
modifiedAtstringOptional
molecularFormulastringOptional

The molecular formula (e.g., “H2O”).

molfilestringOptional
The molfile representation of the solvent.
namestringOptional

Errors

400
Solvent Create Request Bad Request Error
403
Solvent Create Request Forbidden Error
404
Solvent Create Request Not Found Error
409
Solvent Create Request Conflict Error
429
Solvent Create Request Too Many Requests Error
500
Solvent Create Request Internal Server Error