Mixture

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/benchling/main/json-schema/benchling-mixture-schema.json",
  "title": "Mixture",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/benchling-mixtures-api-openapi.yml#/components/schemas/Mixture",
  "properties": {
    "aliases": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "allowMeasuredIngredients": {
      "description": "Derived from the mixture's schema.",
      "readOnly": true,
      "type": "boolean"
    },
    "amount": {
      "description": "The positive numerical amount value of this mixture in string format (to preserve full precision). Pair with `units`. Supports scientific notation (1.23e4).",
      "type": "string"
    },
    "apiURL": {
      "description": "The canonical url of the Mixture in the API.",
      "format": "uri",
      "readOnly": true,
      "type": "string"
    },
    "archiveRecord": {
      "allOf": [
        {
          "$ref": "#/$defs/ArchiveRecord"
        }
      ]
    },
    "authors": {
      "items": {
        "$ref": "#/$defs/UserSummary"
      },
      "type": "array"
    },
    "createdAt": {
      "format": "date-time",
      "readOnly": true,
      "type": "string"
    },
    "creator": {
      "allOf": [
        {
          "$ref": "#/$defs/UserSummary"
        },
        {
          "readOnly": true
        }
      ]
    },
    "customFields": {
      "$ref": "#/$defs/CustomFields"
    },
    "entityRegistryId": {
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "allOf": [
        {
          "$ref": "#/$defs/Fields"
        }
      ],
      "description": "Mixtures can have up to one parent mixture field."
    },
    "folderId": {
      "type": [
        "string",
        "null"
      ]
    },
    "id": {
      "type": "string"
    },
    "ingredients": {
      "description": "List of ingredients on this mixture.",
      "items": {
        "$ref": "#/$defs/Ingredient"
      },
      "type": "array"
    },
    "modifiedAt": {
      "format": "date-time",
      "readOnly": true,
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "registrationOrigin": {
      "allOf": [
        {
          "$ref": "#/$defs/RegistrationOrigin"
        }
      ],
      "readOnly": true
    },
    "registryId": {
      "type": [
        "string",
        "null"
      ]
    },
    "schema": {
      "allOf": [
        {
          "$ref": "#/$defs/SchemaSummary"
        }
      ]
    },
    "units": {
      "$ref": "#/$defs/MixtureMeasurementUnits"
    },
    "webURL": {
      "readOnly": true,
      "type": "string"
    }
  },
  "type": "object",
  "$defs": {
    "ArchiveRecord": {
      "properties": {
        "reason": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "ContainerLabels": {
      "properties": {
        "barcode": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "CustomField": {
      "properties": {
        "value": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "CustomFields": {
      "additionalProperties": {
        "$ref": "#/$defs/CustomField"
      },
      "type": "object"
    },
    "EntityLabels": {
      "properties": {
        "entityRegistryId": {
          "type": [
            "string",
            "null"
          ]
        },
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "Field": {
      "properties": {
        "displayValue": {
          "readOnly": true,
          "type": [
            "string",
            "null"
          ]
        },
        "isMulti": {
          "readOnly": true,
          "type": "boolean"
        },
        "textValue": {
          "readOnly": true,
          "type": [
            "string",
            "null"
          ]
        },
        "type": {
          "allOf": [
            {
              "$ref": "#/$defs/FieldType"
            }
          ],
          "readOnly": true
        },
        "value": {
          "description": "For single link fields, use the id of the item you want to link (eg. \"seq_jdf8BV24\").\nFor multi-link fields, use an array of ids of the items you want to link (eg. [\"seq_jdf8BV24\"])\n",
          "oneOf": [
            {
              "type": "string"
            },
            {
              "type": "boolean"
            },
            {
              "type": "number"
            },
            {
              "type": "object"
            },
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          ]
        }
      },
      "required": [
        "value"
      ],
      "type": "object"
    },
    "FieldType": {
      "enum": [
        "dna_sequence_link",
        "aa_sequence_link",
        "custom_entity_link",
        "entity_link",
        "mixture_link",
        "molecule_link",
        "dropdown",
        "part_link",
        "translation_link",
        "aa_part_link",
        "base_molecule_link",
        "blob_link",
        "text",
        "long_text",
        "batch_link",
        "storage_link",
        "entry_link",
        "assay_request_link",
        "assay_result_link",
        "assay_run_link",
        "boolean",
        "float",
        "integer",
        "datetime",
        "date",
        "json"
      ],
      "type": "string"
    },
    "Fields": {
      "additionalProperties": {
        "$ref": "#/$defs/Field"
      },
      "type": "object"
    },
    "Ingredient": {
      "properties": {
        "amount": {
          "description": "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\"`.\n",
          "type": [
            "string",
            "null"
          ]
        },
        "catalogIdentifier": {
          "type": [
            "string",
            "null"
          ]
        },
        "componentEntity": {
          "allOf": [
            {
              "$ref": "#/$defs/EntityLabels"
            },
            {
              "description": "The entity that uniquely identifies this component."
            }
          ]
        },
        "componentLotContainer": {
          "allOf": [
            {
              "$ref": "#/$defs/ContainerLabels"
            }
          ],
          "description": "The container representing the component lot for this ingredient. This is only present if the mixture schema supports component lots in \"inventory\" format."
        },
        "componentLotEntity": {
          "allOf": [
            {
              "$ref": "#/$defs/EntityLabels"
            }
          ],
          "description": "The entity representing the component lot for this ingredient. This is only present if the mixture schema supports component lots in \"inventory\" format."
        },
        "componentLotText": {
          "description": "Text representing the component lot for this ingredient. This is only present if the mixture schema supports component lots in \"text\" format.",
          "type": [
            "string",
            "null"
          ]
        },
        "hasParent": {
          "type": "boolean"
        },
        "notes": {
          "type": [
            "string",
            "null"
          ]
        },
        "targetAmount": {
          "description": "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`.",
          "readOnly": true,
          "type": [
            "string",
            "null"
          ]
        },
        "units": {
          "$ref": "#/$defs/IngredientMeasurementUnits"
        }
      },
      "type": "object"
    },
    "IngredientMeasurementUnits": {
      "enum": [
        "nL",
        "uL",
        "mL",
        "L",
        "mg",
        "g",
        "kg",
        "ug",
        "Units",
        "Cells",
        "mol",
        "mmol",
        "umol"
      ],
      "type": [
        "string",
        "null"
      ]
    },
    "MixtureMeasurementUnits": {
      "enum": [
        "nL",
        "uL",
        "mL",
        "L",
        "g",
        "kg",
        "mg",
        "ug",
        "Units"
      ],
      "type": [
        "string",
        "null"
      ]
    },
    "PartySummary": {
      "properties": {
        "handle": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "RegistrationOrigin": {
      "properties": {
        "originEntryId": {
          "readOnly": true,
          "type": [
            "string",
            "null"
          ]
        },
        "registeredAt": {
          "format": "date-time",
          "readOnly": true,
          "type": "string"
        }
      },
      "type": "object"
    },
    "SchemaSummary": {
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "UserSummary": {
      "allOf": [
        {
          "$ref": "#/$defs/PartySummary"
        },
        {}
      ]
    }
  }
}