--- title: "List AutomationInputFileConfig items" method: GET path: "/api/v3/run-schema/{run_schema_id}/automation-input-file-configs/items" tags: ["Run Schema"] --- # List AutomationInputFileConfig items `GET /api/v3/run-schema/{run_schema_id}/automation-input-file-configs/items` ## Request - Base URL: `https://{tenant_name}.benchling.com` - URL: `https://{tenant_name}.benchling.com/api/v3/run-schema/{run_schema_id}/automation-input-file-configs/items` - Auth: HTTP bearer List AutomationInputFileConfig items. ## Path parameters - `run_schema_id` string, required ## Headers - `EARLY-ACCESS` string ## Response `200` OK - AutomationInputFileConfigUnpaginatedList - `items` AutomationInputFileConfig[] - `__typename` string - `columns` string[], nullable: List of columns for input files generated by this configuration - `delimiter` string, nullable: Delimiter to use in input files generated by this configuration - `destinations` AutomationInputFileDestinationInfo[], nullable: Configurations for destinations for input files generated by this configuration - `__typename` string - `name` string, nullable: Name for this DestinationInfo - `fileExtension` string, nullable: Extension to use for input files generated by this configuration - `id` string - `isHidden` boolean, nullable: Whether input generators for this configuration are hidden in the notebook - `name` string, nullable: The name of the AutomationInputFileConfig - `nameTemplateParts` AutomationInputFileNamePart[], nullable: Configuration for naming input files generated by this configuration - `__typename` string - `field` SchemaFieldDefinitionRef - `__typename` string - `id` string, api_id - `text` string, nullable: Text value for the name of the input file (only present for TEXT type) - `type` 'CREATED_AT_DATE' | 'CREATED_AT_TIME' | 'DISPLAY_NAME' | 'FIELD' | 'RUN_API_ID' | 'RUN_ID' | 'RUN_SCHEMA_NAME' | 'SOURCE_FILE_NAME' | 'TEXT': The type of this name template part - `rowConfigs` AutomationInputFileRowConfig[], nullable: Configurations for the rows of the input files generated by this configuration - `__typename` string - `columns` AutomationInputFileRowConfigColumn[], nullable: Configuration for the columns of the input file - `__typename` string - `name` string, nullable: Name for this column of the input file - `destination` AutomationInputFileDestinationInfo: Describes a destination target for rows in a lab automation input file. Contains a lookup configuration for resolving destination samples and an optional display name. - `__typename` string - `name` string, nullable: Name for this DestinationInfo - `plateLayout` PlateLayout: Specifies the well-mapping layout used when generating input file rows for plate-based transfers. The layout type controls how sample positions on a source plate map to positions on a destination plate. - `__typename` string - `layoutType` 'COLUMN_INTERLEAVE' | 'INTERLEAVE' | 'REVERSE_COLUMN_INTERLEAVE' | 'REVERSE_INTERLEAVE' | 'REVERSE_STAMP_TO_QUADRANTS' | 'STAMP' | 'STAMP_TO_QUADRANTS': The type of the PlateLayout - `sortColumns` string[], nullable: List of columns to sort input files generated by this configuration - `transforms` AutomationTransformConfig[], nullable: Configurations for transforms for input files generated by this configuration - union - object: A data transform that adds a new column to the file with values resolved via a LookupConfig. Used in input file generation to enrich data with looked-up values. - `__typename` 'AddColumnTransform', required: Discriminator value: AddColumnTransform - `transformationProperties` AddColumnTransformationProperties: Properties for an ADD_COLUMN transform, specifying the name of the new column to add. - `__typename` string - `column` string, nullable: The name of the column to be added - `type` 'ADD_COLUMN' | 'ARITHMETIC' | 'CUSTOM' | 'DUPLICATE' | 'EXTRA_HEADERS' | 'EXTRA_FOOTERS' | 'FILTER' | 'FIND_REPLACE' | 'MERGE' | 'MELT' | 'PLATE_SHAPE' | 'PIVOT' | 'REMOVE_QUOTES' | 'SPLIT': The type of this transform (ADD_COLUMN) - object: A data transform that performs arithmetic operations between two variables (columns or constants) and writes the result to a new column. - `__typename` 'ArithmeticTransform', required: Discriminator value: ArithmeticTransform - `transformationProperties` ArithmeticTransformationProperties: Properties for an ARITHMETIC transform, defining the operator, operands, and the name of the result column. Supports addition, subtraction, multiplication, and division between column values and/or constants. - `__typename` string - `firstVariable` union: Union of ArithmeticTransformColumnVariable, ArithmeticTransformConstantVariable - … - `newColumnName` string, nullable: Name of the column that will contain the results of the arithmetic operation - `operator` string, nullable: The arithmetic operation to perform: +, -, *, or / - `secondVariable` union: Union of ArithmeticTransformColumnVariable, ArithmeticTransformConstantVariable - … - `type` 'ADD_COLUMN' | 'ARITHMETIC' | 'CUSTOM' | 'DUPLICATE' | 'EXTRA_HEADERS' | 'EXTRA_FOOTERS' | 'FILTER' | 'FIND_REPLACE' | 'MERGE' | 'MELT' | 'PLATE_SHAPE' | 'PIVOT' | 'REMOVE_QUOTES' | 'SPLIT': The type of this transform (ARITHMETIC) - object: A data transform that delegates processing to an external Benchling App. The app is identified by its API ID in the transformation properties. - `__typename` string, required - `transformationProperties` CustomTransformationProperties: Properties for a CUSTOM transform, identifying the Benchling App that performs the transformation via its API ID. - `__typename` string - `transformId` string, nullable: API ID of a Benchling App that performs the transform - `type` 'ADD_COLUMN' | 'ARITHMETIC' | 'CUSTOM' | 'DUPLICATE' | 'EXTRA_HEADERS' | 'EXTRA_FOOTERS' | 'FILTER' | 'FIND_REPLACE' | 'MERGE' | 'MELT' | 'PLATE_SHAPE' | 'PIVOT' | 'REMOVE_QUOTES' | 'SPLIT': The type of this transform (CUSTOM) - object: A data transform that copies an existing column to a new column with a different name. - `__typename` string, required - `transformationProperties` DuplicateTransformationProperties: Properties for a DUPLICATE transform, specifying the source column to copy and the name for the new duplicate column. - `__typename` string - `columnToDuplicate` string, nullable: Name of column to be duplicated - `newColumnName` string, nullable: Name of new column created by duplicating - `type` 'ADD_COLUMN' | 'ARITHMETIC' | 'CUSTOM' | 'DUPLICATE' | 'EXTRA_HEADERS' | 'EXTRA_FOOTERS' | 'FILTER' | 'FIND_REPLACE' | 'MERGE' | 'MELT' | 'PLATE_SHAPE' | 'PIVOT' | 'REMOVE_QUOTES' | 'SPLIT': The type of this transform (DUPLICATE) - object: A data transform that removes trailing footer rows from a file. Useful for instrument output files that append summary or metadata rows after the data. - `__typename` string, required - `transformationProperties` ExtraFootersTransformationProperties: Properties for an EXTRA_FOOTERS transform, specifying how many trailing rows to remove from the bottom of the file. - `__typename` string - `numRowsToRemove` integer, nullable: Number of rows to remove from the bottom of the file - `type` 'ADD_COLUMN' | 'ARITHMETIC' | 'CUSTOM' | 'DUPLICATE' | 'EXTRA_HEADERS' | 'EXTRA_FOOTERS' | 'FILTER' | 'FIND_REPLACE' | 'MERGE' | 'MELT' | 'PLATE_SHAPE' | 'PIVOT' | 'REMOVE_QUOTES' | 'SPLIT': The type of this transform (EXTRA_FOOTERS) - object: A data transform that handles files with extra header rows above the standard column header. Strips the specified header rows so downstream processing sees clean tabular data. - `__typename` string, required - `transformationProperties` ExtraHeadersTransformationProperties: Properties for an EXTRA_HEADERS transform, specifying the row range that contains non-standard header rows to skip during file processing. - `__typename` string - `headerRowIndex` integer, nullable: Index of the first row of the header - `lastHeaderRowIndex` integer, nullable: Index of the last row of the header. Optional, can be omitted if header is a single row - `type` 'ADD_COLUMN' | 'ARITHMETIC' | 'CUSTOM' | 'DUPLICATE' | 'EXTRA_HEADERS' | 'EXTRA_FOOTERS' | 'FILTER' | 'FIND_REPLACE' | 'MERGE' | 'MELT' | 'PLATE_SHAPE' | 'PIVOT' | 'REMOVE_QUOTES' | 'SPLIT': The type of this transform (EXTRA_HEADERS) - object: A data transform that removes rows from the file based on column value conditions. Supports null checks, string/number comparisons, and set membership filters. - `__typename` string, required - `transformationProperties` union: Union of NullFilterTransformationProperties, StringValueFilterTransformationProperties, NumberValueFilterTransformationProperties, MultipleValuesFilterTransformationProperties - object: Properties for a FILTER transform that filters rows by checking whether a column's value is in (ISIN) or not in (NOTIN) a set of allowed values. - … - object: Properties for a FILTER transform that filters rows based on null or non-null values in a specified column. - … - object: Properties for a FILTER transform that filters rows by comparing a column's numeric value using relational operators (EQ, NE, LE, LT, GE, GT). - … - object: Properties for a FILTER transform that filters rows by comparing a column's string value using equality or inequality. - … - `type` 'ADD_COLUMN' | 'ARITHMETIC' | 'CUSTOM' | 'DUPLICATE' | 'EXTRA_HEADERS' | 'EXTRA_FOOTERS' | 'FILTER' | 'FIND_REPLACE' | 'MERGE' | 'MELT' | 'PLATE_SHAPE' | 'PIVOT' | 'REMOVE_QUOTES' | 'SPLIT': The type of this transform (FILTER) - object: A data transform that substitutes values in the file by finding occurrences and replacing them. Replacement values can be specified inline or resolved via a LookupConfig. - `__typename` string, required - `type` 'ADD_COLUMN' | 'ARITHMETIC' | 'CUSTOM' | 'DUPLICATE' | 'EXTRA_HEADERS' | 'EXTRA_FOOTERS' | 'FILTER' | 'FIND_REPLACE' | 'MERGE' | 'MELT' | 'PLATE_SHAPE' | 'PIVOT' | 'REMOVE_QUOTES' | 'SPLIT': The type of this transform (FIND_REPLACE) - object: A data transform that unpivots wide-format data into long format by converting selected value columns into rows, each identified by a variable name. - `__typename` string, required - `transformationProperties` MeltTransformationProperties: Properties for a MELT transform, specifying identifier columns to keep fixed, value columns to unpivot, and optional names for the new variable and value columns. - `__typename` string - `identifierColumns` string[], nullable - `newValueColumn` string, nullable - `newVariableColumn` string, nullable - `valueColumns` string[], nullable - `type` 'ADD_COLUMN' | 'ARITHMETIC' | 'CUSTOM' | 'DUPLICATE' | 'EXTRA_HEADERS' | 'EXTRA_FOOTERS' | 'FILTER' | 'FIND_REPLACE' | 'MERGE' | 'MELT' | 'PLATE_SHAPE' | 'PIVOT' | 'REMOVE_QUOTES' | 'SPLIT': The type of this transform (MELT) - object: A data transform that concatenates values from multiple columns into a single output column, separated by a configurable delimiter. - `__typename` string, required - `transformationProperties` MergeTransformationProperties: Properties for a MERGE transform, specifying the columns to combine, the output column name, and the delimiter placed between merged values. - `__typename` string - `columnNames` string[], nullable: Names of columns to be merged - `delimiter` string, nullable: Delimiter to put between merged values - `outputColumnName` string, nullable: Name of column to contain merged values - `type` 'ADD_COLUMN' | 'ARITHMETIC' | 'CUSTOM' | 'DUPLICATE' | 'EXTRA_HEADERS' | 'EXTRA_FOOTERS' | 'FILTER' | 'FIND_REPLACE' | 'MERGE' | 'MELT' | 'PLATE_SHAPE' | 'PIVOT' | 'REMOVE_QUOTES' | 'SPLIT': The type of this transform (MERGE) - object: A data transform that reshapes long-format data into wide format by pivoting unique values from a keys column into separate columns. - `__typename` string, required - `transformationProperties` PivotTransformationProperties: Properties for a PIVOT transform, specifying the index columns to group by, the keys column whose values become new column headers, and the values column to spread. - `__typename` string - `indexColumns` string[], nullable - `keysColumn` string, nullable - `valuesColumn` string, nullable - `type` 'ADD_COLUMN' | 'ARITHMETIC' | 'CUSTOM' | 'DUPLICATE' | 'EXTRA_HEADERS' | 'EXTRA_FOOTERS' | 'FILTER' | 'FIND_REPLACE' | 'MERGE' | 'MELT' | 'PLATE_SHAPE' | 'PIVOT' | 'REMOVE_QUOTES' | 'SPLIT': The type of this transform (PIVOT) - object: A data transform that extracts plate-shaped data from a file by locating the well grid at specified coordinates and optionally removing all surrounding cells. - `__typename` string, required - `transformationProperties` PlateShapeTransformationProperties: Properties for a PLATE_SHAPE transform, specifying the plate schema for expected dimensions, the cell coordinates of well A1, and whether to discard data outside the plate region. - `__typename` string - `deleteOtherCells` boolean, nullable: Whether to delete all cells outside of the plate shape data - `firstWellColumnIndex` integer, nullable: Column index in the file of well A1 - `firstWellRowIndex` integer, nullable: Row index in the file of well A1 - `plateSchema` string, nullable: API ID of a WellPlateSchema or MatrixPlateSchema that defines expected plate dimensions - `type` 'ADD_COLUMN' | 'ARITHMETIC' | 'CUSTOM' | 'DUPLICATE' | 'EXTRA_HEADERS' | 'EXTRA_FOOTERS' | 'FILTER' | 'FIND_REPLACE' | 'MERGE' | 'MELT' | 'PLATE_SHAPE' | 'PIVOT' | 'REMOVE_QUOTES' | 'SPLIT': The type of this transform (PLATE_SHAPE) - object: A data transform that strips quote characters from all values in the file. Takes no additional configuration parameters. - `__typename` string, required - `transformationProperties` RemoveQuotesTransformTransformationProperties: Additional parameters for this transform - an empty object - `type` 'ADD_COLUMN' | 'ARITHMETIC' | 'CUSTOM' | 'DUPLICATE' | 'EXTRA_HEADERS' | 'EXTRA_FOOTERS' | 'FILTER' | 'FIND_REPLACE' | 'MERGE' | 'MELT' | 'PLATE_SHAPE' | 'PIVOT' | 'REMOVE_QUOTES' | 'SPLIT': The type of this transform (REMOVE_QUOTES) - object: A data transform that divides values in a single column into multiple output columns by splitting on a delimiter. - `__typename` string, required - `transformationProperties` SplitTransformationProperties: Properties for a SPLIT transform, specifying the column to split, the delimiter to split on, and the names for the resulting output columns. - `__typename` string - `column` string, nullable: Name of column to be split - `delimiter` string, nullable: Delimiter on which to split column values - `outputColumnNames` string[], nullable: Names of columns in which to put the split values - `type` 'ADD_COLUMN' | 'ARITHMETIC' | 'CUSTOM' | 'DUPLICATE' | 'EXTRA_HEADERS' | 'EXTRA_FOOTERS' | 'FILTER' | 'FIND_REPLACE' | 'MERGE' | 'MELT' | 'PLATE_SHAPE' | 'PIVOT' | 'REMOVE_QUOTES' | 'SPLIT': The type of this transform ## Other responses - `400`: Bad Request - `403`: Forbidden - `404`: Not Found - `429`: Too Many Requests - `500`: Internal Server Error --- [API](https://skmtc.dev/benchling/apis/benchling-api.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api/revisions/c9f087b98b8b?raw)