Skip to navigation
Benchling APISalt

Create Salt

Beta

Create a salt in the tenant’s salt 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 salt requires tenant admin permissions. The salt 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 salt library, names must be unique (case-insensitive) and each structure may appear only once; a solvent may reuse a salt’s name or structure. Archived salts 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 salt. Must be unique (case-insensitive) within the salt library.

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

Optional configurable identifier for this salt (e.g., “HCl”). 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 salt.
canonicalSmilesstringOptional
The SMILES representation of the salt after standardization.
codestring or nullOptional

Optional configurable identifier for this salt (e.g., “HCl”, “MS”). Unique across both salts and solvents within a tenant.

createdAtstringOptional
idstringOptional
modifiedAtstringOptional
molecularFormulastringOptional

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

molfilestringOptional
The molfile representation of the salt.
namestringOptional

Errors

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