---
title: "Update a container content"
method: PATCH
path: "/containers/{container_id}/contents/{containable_id}"
tags: ["containers"]
---

# Update a container content

`PATCH /containers/{container_id}/contents/{containable_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/containers/{container_id}/contents/{containable_id}`
- Auth: HTTP bearer

Update a container content

## Path parameters

- `container_id` string, required
- `containable_id` string, required

## Request body

- ContainerContentUpdate
  - `concentration` Measurement, required
    - `units` string, nullable, required: Can only be null if value is also null
    - `value` number, double, nullable, required: Can only be null if units is also null

## Response `200`

OK

- ContainerContent
  - `batch` union
    - Batch
      - `archiveRecord` ArchiveRecord
        - `reason` string
      - `createdAt` string, date-time: DateTime at which the the result was created
      - `creator` UserSummary
        - `handle` string
        - `id` string
        - `name` string
      - `defaultConcentration` Measurement
        - `units` string, nullable, required: Can only be null if value is also null
        - `value` number, double, nullable, required: Can only be null if units is also null
      - `entity` union
        - object: aa_sequence variant
          - `entityType` 'aa_sequence', required: Discriminator value: aa_sequence
          - `id` string
          - `type` string
        - object: custom_entity variant
          - `entityType` 'custom_entity', required
          - `id` string
          - `type` string
        - object: dna_sequence variant
          - `entityType` 'dna_sequence', required
          - `id` string
          - `type` string
      - `fields` Fields
      - `id` string
      - `modifiedAt` string, date-time
      - `name` string
      - `schema` SchemaSummary
        - `id` string
        - `name` string
      - `webURL` string
    - InaccessibleResource
      - `inaccessibleId` string
      - `type` string: The type of this inaccessible item. Example values: "custom_entity", "container", "plate", "dna_sequence"
  - `concentration` Measurement
    - `units` string, nullable, required: Can only be null if value is also null
    - `value` number, double, nullable, required: Can only be null if units is also null
  - `entity` union
    - union
      - object: aa_sequence variant
        - `entityType` 'aa_sequence', required
        - `aliases` string[]: Array of aliases
        - `aminoAcids` string: Amino acids of the AA sequence.
        - `annotations` AaAnnotation[]: Array of annotation objects on the AA sequence.
          - `color` string
          - `end` integer: 0-based exclusive end index. The end of the AA sequence is always represented as 0.
          - `id` string
          - `name` string
          - `notes` string
          - `start` integer: 0-based inclusive start index.
          - `type` string
        - `apiURL` string, uri: The canonical url of the AA Sequence in the API.
        - `archiveRecord` ArchiveRecord
          - `reason` string
        - `authors` UserSummary[]
          - `handle` string
          - `id` string
          - `name` string
        - `createdAt` string, date-time: DateTime the AA sequence was created.
        - `creator` UserSummary
          - `handle` string
          - `id` string
          - `name` string
        - `customFields` CustomFields
        - `entityRegistryId` string, nullable: Registry ID of the AA sequence if registered.
        - `fields` Fields
        - `folderId` string, nullable: ID of the folder that contains the AA sequence.
        - `id` string: ID of the AA sequence.
        - `length` integer: Number of amino acids in the AA sequence.
        - `modifiedAt` string, date-time: DateTime the AA sequence was last modified.
        - `name` string: Name of the AA sequence.
        - `registrationOrigin` RegistrationOrigin
          - `originEntryId` string, nullable
          - `registeredAt` string, date-time
        - `registryId` string, nullable: Registry the AA sequence is registered in.
        - `schema` SchemaSummary
          - `id` string
          - `name` string
        - `url` string: The path of the web URL, omitting the tenant domain
        - `webURL` string, uri: URL of the AA sequence.
      - object: custom_entity variant
        - `entityType` 'custom_entity', required
        - `aliases` string[]
        - `apiURL` string, uri: The canonical url of the Custom Entity in the API.
        - `archiveRecord` ArchiveRecord
          - `reason` string
        - `authors` UserSummary[]
          - `handle` string
          - `id` string
          - `name` string
        - `createdAt` string, date-time
        - `creator` CustomEntityWithEntityTypeCreator
          - `handle` string
          - `id` string
          - `name` string
        - `customFields` CustomFields
        - `entityRegistryId` string, nullable
        - `fields` Fields
        - `folderId` string, nullable
        - `id` string
        - `modifiedAt` string, date-time
        - `name` string
        - `registrationOrigin` RegistrationOrigin
          - `originEntryId` string, nullable
          - `registeredAt` string, date-time
        - `registryId` string, nullable
        - `schema` SchemaSummary
          - `id` string
          - `name` string
        - `url` string: The path of the web URL, omitting the tenant domain
        - `webURL` string
      - object: dna_oligo variant
        - `entityType` 'dna_oligo', required: Discriminator value: dna_oligo
      - object: dna_sequence variant
        - `entityType` 'dna_sequence', required
        - `aliases` string[]
        - `annotations` DnaAnnotation[]
          - `color` string: Hex color code used when displaying this feature in the UI.
          - `customFields` SequenceFeatureCustomField[]
            - `name` string: Name of the custom field
            - `value` string: Value of the custom field
          - `name` string
          - `notes` string
          - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
          - `start` integer: 0-based inclusive start index.
          - `strand` integer
          - `type` string
        - `apiURL` string, uri: The canonical url of the DNA Sequence in the API.
        - `archiveRecord` ArchiveRecord
          - `reason` string
        - `authors` UserSummary[]
          - `handle` string
          - `id` string
          - `name` string
        - `bases` string
        - `createdAt` string, date-time
        - `creator` UserSummary
          - `handle` string
          - `id` string
          - `name` string
        - `customFields` CustomFields
        - `dnaAlignmentIds` string[]: API IDs of Nucleotide Alignments involving the RNA sequence
        - `entityRegistryId` string, nullable
        - `fields` Fields
        - `folderId` string, nullable
        - `id` string
        - `isCircular` boolean
        - `length` integer
        - `modifiedAt` string, date-time
        - `name` string
        - `parts` DnaSequencePart[]
          - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
          - `sequenceId` string
          - `start` integer: 0-based inclusive start index.
          - `strand` integer
        - `primers` Primer[]
          - `bases` string
          - `bindPosition` integer
          - `color` string
          - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
          - `name` string
          - `oligoId` string
          - `overhangLength` integer
          - `start` integer: 0-based inclusive start index.
          - `strand` integer
        - `registrationOrigin` RegistrationOrigin
          - `originEntryId` string, nullable
          - `registeredAt` string, date-time
        - `registryId` string, nullable
        - `schema` SchemaSummary
          - `id` string
          - `name` string
        - `transcriptions` DnaSequenceTranscription[]
          - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
          - `sequenceId` string: Linked RNA sequence ID.
          - `start` integer: 0-based inclusive start index.
          - `strand` integer
        - `translations` Translation[]
          - `color` string: Hex color code used when displaying this feature in the UI.
          - `customFields` SequenceFeatureCustomField[]
            - `name` string: Name of the custom field
            - `value` string: Value of the custom field
          - `name` string
          - `notes` string
          - `aminoAcids` string
          - `coerceStartCodonToMethionine` boolean: Whether to override the translation of the start codon to Methionine. Has no effect when the start codon already translates to Methionine.
          - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
          - `geneticCode` 'STANDARD' | 'VERTEBRATE_MITOCHONDRIAL' | 'YEAST_MITOCHONDRIAL' | 'MOLD_PROTOZOAN_COELENTERATE_MITOCHONDRIAL_MYCOPLASMA_SPIROPLASMA' | 'INVERTEBRATE_MITOCHONDRIAL' | 'CILIATE_DASYCLADACEAN_HEXAMITA_NUCLEAR' | 'ECHINODERM_FLATWORM_MITOCHONDRIAL' | 'EUPLOTID_NUCLEAR' | 'BACTERIAL_ARCHAEAL_PLANT_PLASTID' | 'ALTERNATIVE_YEAST_NUCLEAR' | 'ASCIDIAN_MITOCHONDRIAL' | 'ALTERNATIVE_FLATWORM_MITOCHONDRIAL' | 'CHLOROPHYCEAN_MITOCHONDRIAL' | 'TREMATODE_MITOCHONDRIAL' | 'SCENEDESMUS_OBLIQUUS_MITOCHONDRIAL' | 'THRAUSTOCHYTRIUM_MITOCHONDRIAL' | 'RHABDOPLEURIDAE_MITOCHONDRIAL' | 'CANDIDATE_DIVISION_SR1_GRACILIBACTERIA' | 'PACHYSOLEN_TANNOPHILUS_NUCLEAR' | 'MESODINIUM_NUCLEAR' | 'PERITRICH_NUCLEAR' | 'CEPHALODISCIDAE_MITOCHONDRIAL_UAA_TYR': The genetic code to use when translating the nucleotide sequence into amino acids.
          - `regions` TranslationRegionsItems[]
            - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
            - `start` integer: 0-based inclusive start index.
          - `start` integer: 0-based inclusive start index.
          - `strand` integer
        - `url` string: The path of the web URL, omitting the tenant domain
        - `webURL` string
      - object: mixture variant
        - `entityType` 'mixture', required
        - `aliases` string[]
        - `allowMeasuredIngredients` boolean: Derived from the mixture's schema.
        - `amount` string: The positive numerical amount value of this mixture in string format (to preserve full precision). Pair with `units`. Supports scientific notation (1.23e4).
        - `apiURL` string, uri: The canonical url of the Mixture in the API.
        - `archiveRecord` ArchiveRecord
          - `reason` string
        - `authors` UserSummary[]
          - `handle` string
          - `id` string
          - `name` string
        - `createdAt` string, date-time
        - `creator` MixtureWithEntityTypeCreator
          - `handle` string
          - `id` string
          - `name` string
        - `customFields` CustomFields
        - `entityRegistryId` string, nullable
        - `fields` Fields
        - `folderId` string, nullable
        - `id` string
        - `ingredients` Ingredient[]: List of ingredients on this mixture.
          - `amount` string, nullable: The amount value of this ingredient in its mixture, in string format (to preserve full precision). Pair with `units`. Supports scientific notation (1.23e4). One ingredient on this mixture can have an amount value of `"QS"`.
          - `catalogIdentifier` string, nullable
          - `componentEntity` IngredientComponentEntity: The entity that uniquely identifies this component.
            - `entityRegistryId` string, nullable
            - `id` string
            - `name` string
          - `componentLotContainer` ContainerLabels
            - `barcode` string
            - `id` string
            - `name` string
          - `componentLotEntity` EntityLabels
            - `entityRegistryId` string, nullable
            - `id` string
            - `name` string
          - `componentLotText` string, nullable: Text representing the component lot for this ingredient. This is only present if the mixture schema supports component lots in "text" format.
          - `hasParent` boolean
          - `notes` string, nullable
          - `targetAmount` string, nullable: The target amount for this ingredient such that this ingredient's proportion in its mixture would preserve the equivalent ingredient's proportion in the parent mixture. Pair with `units`.
          - `units` 'nL' | 'uL' | 'mL' | 'L' | 'mg' | 'g' | 'kg' | 'ug' | 'Units' | 'Cells' | 'mol' | 'mmol' | 'umol'
        - `modifiedAt` string, date-time
        - `name` string
        - `registrationOrigin` RegistrationOrigin
          - `originEntryId` string, nullable
          - `registeredAt` string, date-time
        - `registryId` string, nullable
        - `schema` SchemaSummary
          - `id` string
          - `name` string
        - `units` 'nL' | 'uL' | 'mL' | 'L' | 'g' | 'kg' | 'mg' | 'ug' | 'Units'
        - `webURL` string
      - object: molecule variant
        - `entityType` 'molecule', required
        - `aliases` string[]: Array of aliases.
        - `apiURL` string, uri: The canonical url of the Molecule in the API.
        - `archiveRecord` ArchiveRecord
          - `reason` string
        - `authors` UserSummary[]
          - `handle` string
          - `id` string
          - `name` string
        - `canonicalizedSmiles` string: The canonicalized chemical structure in SMILES format.
        - `createdAt` string, date-time: DateTime the Molecule was created.
        - `creator` UserSummary
          - `handle` string
          - `id` string
          - `name` string
        - `customFields` CustomFields
        - `entityRegistryId` string, nullable: Registry ID of the Molecule if registered.
        - `fields` Fields
        - `folderId` string, nullable: ID of the folder that contains the Molecule.
        - `id` string: ID of the Molecule.
        - `modifiedAt` string, date-time: DateTime the Molecule was last modified.
        - `name` string: Name of the Molecule.
        - `originalSmiles` string, nullable: The original chemical structure supplied by the user in SMILES format. Null if the user did not originally supply SMILES.
        - `registrationOrigin` RegistrationOrigin
          - `originEntryId` string, nullable
          - `registeredAt` string, date-time
        - `registryId` string, nullable: Registry the Molecule is registered in.
        - `schema` SchemaSummary
          - `id` string
          - `name` string
        - `webURL` string, uri: URL of the Molecule.
      - object: rna_oligo variant
        - `entityType` 'rna_oligo', required: Discriminator value: rna_oligo
      - object: rna_sequence variant
        - `entityType` 'rna_sequence', required
        - `aliases` string[]
        - `alignmentIds` string[]: API IDs of Nucleotide Alignments involving the RNA sequence
        - `annotations` RnaAnnotation[]
          - `color` string: Hex color code used when displaying this feature in the UI.
          - `customFields` SequenceFeatureCustomField[]
            - `name` string: Name of the custom field
            - `value` string: Value of the custom field
          - `name` string
          - `notes` string
          - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
          - `start` integer: 0-based inclusive start index.
          - `strand` integer
          - `type` string
        - `apiURL` string, uri: The canonical url of the RNA Sequence in the API.
        - `archiveRecord` ArchiveRecord
          - `reason` string
        - `authors` UserSummary[]
          - `handle` string
          - `id` string
          - `name` string
        - `bases` string
        - `createdAt` string, date-time
        - `creator` UserSummary
          - `handle` string
          - `id` string
          - `name` string
        - `customFields` CustomFields
        - `customNotation` string, nullable: Representation of the RNA Sequence in the custom notation specified in the request. Null if no notation was specified.
        - `customNotationName` string, nullable: Name of the custom notation specified in the request. Null if no notation was specified.
        - `entityRegistryId` string, nullable
        - `fields` Fields
        - `folderId` string, nullable
        - `helm` string, nullable: Representation of the RNA Sequence in HELM syntax, including any chemical modifications.
        - `id` string
        - `isCircular` boolean
        - `length` integer
        - `modifiedAt` string, date-time
        - `name` string
        - `parts` RnaSequencePart[]
          - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
          - `sequenceId` string
          - `start` integer: 0-based inclusive start index.
          - `strand` integer
        - `primers` Primer[]
          - `bases` string
          - `bindPosition` integer
          - `color` string
          - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
          - `name` string
          - `oligoId` string
          - `overhangLength` integer
          - `start` integer: 0-based inclusive start index.
          - `strand` integer
        - `registrationOrigin` RegistrationOrigin
          - `originEntryId` string, nullable
          - `registeredAt` string, date-time
        - `registryId` string, nullable
        - `schema` SchemaSummary
          - `id` string
          - `name` string
        - `translations` Translation[]
          - `color` string: Hex color code used when displaying this feature in the UI.
          - `customFields` SequenceFeatureCustomField[]
            - `name` string: Name of the custom field
            - `value` string: Value of the custom field
          - `name` string
          - `notes` string
          - `aminoAcids` string
          - `coerceStartCodonToMethionine` boolean: Whether to override the translation of the start codon to Methionine. Has no effect when the start codon already translates to Methionine.
          - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
          - `geneticCode` 'STANDARD' | 'VERTEBRATE_MITOCHONDRIAL' | 'YEAST_MITOCHONDRIAL' | 'MOLD_PROTOZOAN_COELENTERATE_MITOCHONDRIAL_MYCOPLASMA_SPIROPLASMA' | 'INVERTEBRATE_MITOCHONDRIAL' | 'CILIATE_DASYCLADACEAN_HEXAMITA_NUCLEAR' | 'ECHINODERM_FLATWORM_MITOCHONDRIAL' | 'EUPLOTID_NUCLEAR' | 'BACTERIAL_ARCHAEAL_PLANT_PLASTID' | 'ALTERNATIVE_YEAST_NUCLEAR' | 'ASCIDIAN_MITOCHONDRIAL' | 'ALTERNATIVE_FLATWORM_MITOCHONDRIAL' | 'CHLOROPHYCEAN_MITOCHONDRIAL' | 'TREMATODE_MITOCHONDRIAL' | 'SCENEDESMUS_OBLIQUUS_MITOCHONDRIAL' | 'THRAUSTOCHYTRIUM_MITOCHONDRIAL' | 'RHABDOPLEURIDAE_MITOCHONDRIAL' | 'CANDIDATE_DIVISION_SR1_GRACILIBACTERIA' | 'PACHYSOLEN_TANNOPHILUS_NUCLEAR' | 'MESODINIUM_NUCLEAR' | 'PERITRICH_NUCLEAR' | 'CEPHALODISCIDAE_MITOCHONDRIAL_UAA_TYR': The genetic code to use when translating the nucleotide sequence into amino acids.
          - `regions` TranslationRegionsItems[]
            - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
            - `start` integer: 0-based inclusive start index.
          - `start` integer: 0-based inclusive start index.
          - `strand` integer
        - `url` string: The path of the web URL, omitting the tenant domain
        - `webURL` string
    - InaccessibleResource
      - `inaccessibleId` string
      - `type` string: The type of this inaccessible item. Example values: "custom_entity", "container", "plate", "dna_sequence"

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found

---

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