Skip to navigation
Benchling APISalt

Update Salt

Beta

Update a salt’s name or code, or archive/unarchive it via the archived field. The salt structure is immutable and cannot be changed after creation. A new name must be unique (case-insensitive) within the salt library.

Authentication

AuthorizationBearer

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

Path parameters

salt_idstringRequired
ID of the Salt.

Headers

EARLY-ACCESSstringOptional

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

Request

This endpoint expects an object.
archiveReasonstringOptional
archivedbooleanOptional
codestring or nullOptional

Configurable identifier for this salt. Must be unique (case-insensitive) across all salts and solvents in the tenant.

namestringOptional

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

Response

OK
__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 Update Request Bad Request Error
403
Salt Update Request Forbidden Error
404
Salt Update Request Not Found Error
409
Salt Update Request Conflict Error
429
Salt Update Request Too Many Requests Error
500
Salt Update Request Internal Server Error