BEbenchling
molecules

Create a Molecule

Create a Molecule

post/molecules

Request

  • Base URL
    https://{tenant_name}.benchling.com/api/v2
  • Auth
    HTTP bearer

Request body

aliasesstring[]

Aliases to add to the Molecule.

authorIdsstring[]

IDs of users to set as the Molecule's authors.

customFieldsCustomFields
fieldsFields
folderIdstring

ID of the folder containing the entity. Can be left empty when registryId is present.

namestring required

Name of the Molecule.

schemaIdstring

ID of the Molecule's schema.

entityRegistryIdstring

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
registryIdstring

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

Required in order for entities to be created directly in the registry.

Response

Created

aliasesstring[]

Array of aliases.

apiURLstring uri

The canonical url of the Molecule in the API.

canonicalizedSmilesstring

The canonicalized chemical structure in SMILES format.

createdAtstring date-time

DateTime the Molecule was created.

customFieldsCustomFields
entityRegistryIdstring nullable

Registry ID of the Molecule if registered.

fieldsFields
folderIdstring nullable

ID of the folder that contains the Molecule.

idstring

ID of the Molecule.

modifiedAtstring date-time

DateTime the Molecule was last modified.

namestring

Name of the Molecule.

originalSmilesstring nullable

The original chemical structure supplied by the user in SMILES format. Null if the user did not originally supply SMILES.

registryIdstring nullable

Registry the Molecule is registered in.

webURLstring uri

URL of the Molecule.

Changes

No recorded changes to this operation across all 1 revision of this API.