{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/prep/sidebars.yaml","oas-products/prep/api/openapi.yaml":"oas-products/prep/api/openapi.yaml"},"props":{"metadata":{"markdoc":{"tagList":["split","openapi-code-sample"]},"type":"markdown"},"seo":{"title":"Add a Transfer Samples step to an existing protocol","description":"Hamilton's Developer Portal is used to help reference and understand the APIs of Hamilton products.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"add-a-transfer-samples-step-to-an-existing-protocol"},"children":["Add a Transfer Samples step to an existing protocol"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This new step uses the deck and protocol created in ",{"$$mdtype":"Tag","name":"a","attributes":{"className":"schema-iframe-link","href":"prep_recipe_protocol_create"},"children":["Create a Prep protocol"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"51666171915","level":2},"children":["Add step to the protocol "]},{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All of the required information to create a protocol is provided in the body of the following example."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-products/prep/api/openapi.yaml","operationId":"CreateProtocolStep","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-call-body-example"},"children":["API call body example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{ \n  \"id\": 0,   \"name\": \"transfer samples step\", \n  \"channelSelection\": \"twoChannel\", \n  \"tipLabwareGroupId\": \"{{tipGroupId}}\", \n  \"liquidType\": \"Aqueous\", \n  \"dispenseToWaste\": false, \n  \"newTipsEachTransfer\": false, \n  \"tipDiscardLocation\": \"returnToRack\", \n  \"stepType\": \"TransferSamplesStep\", \n  \"stepOrder\": 1, \n  \"aspirateSettings\": { \n    \"id\": 0, \n    \"transferVolume\": 25, \n    \"pipettingHeight\": 2, \n    \"offset\": { \n      \"x\": 0, \n      \"y\": 0     },     \"useOffset\": false,\n     \"pipettingHeightStartPoint\": \"fromContainerBottom\", \n    \"followLiquid\": true,     \"mixBeforeAspirate\": false, \n    \"mixCycles\": 3,\n     \"mixHeight\": 2,\n    \"mixVolume\": 1,\n    \"enableMad\": false \n  }, \n  \"dispenseSettings\": { \n    \"id\": 0,\n     \"transferVolume\": 25, \n    \"pipettingHeight\": 5, \n    \"pipettingHeightStartPoint\": \"fromContainerBottom\", \n    \"followLiquid\": true,\n     \"mixAfterDispense\": false, \n    \"mixCycles\": 3, \n    \"mixHeight\": 2, \n    \"mixVolume\": 1, \n    \"offset\": {\n       \"x\": 0,       \"y\": 0 \n    },     \"useOffset\": false \n  },\n   \"sources\": [ \n    {\n       \"position\": 6, \n      \"addresses\": [ \n        { \n          \"row\": 1,\n           \"column\": 1 \n        },         { \n          \"row\": 1,\n           \"column\": 2 \n        },         { \n          \"row\": 1,\n           \"column\": 3 \n        },         { \n          \"row\": 1,\n           \"column\": 4 \n        },         {\n           \"row\": 1,\n           \"column\": 5 \n        },         {\n           \"row\": 1,\n           \"column\": 6 \n        },         {\n           \"row\": 2,\n           \"column\": 1 \n        },         {\n           \"row\": 2,\n           \"column\": 2 \n        },         {\n           \"row\": 2,\n           \"column\": 3 \n        },         {\n           \"row\": 2,\n           \"column\": 4 \n        },         {\n           \"row\": 2,\n           \"column\": 5 \n        },         {\n           \"row\": 2,\n           \"column\": 6 \n        },         {\n           \"row\": 3,\n           \"column\": 1 \n        },         {\n           \"row\": 3,\n           \"column\": 2 \n        },         {\n           \"row\": 3,\n           \"column\": 3 \n        },         {\n           \"row\": 3,\n           \"column\": 4 \n        },         {\n           \"row\": 3,\n           \"column\": 5 \n        },         {\n           \"row\": 3,\n           \"column\": 6 \n        },         {\n           \"row\": 4,\n           \"column\": 1 \n        },         {\n           \"row\": 4,\n           \"column\": 2 \n        },         {\n           \"row\": 4,\n           \"column\": 3 \n        },         {\n           \"row\": 4,\n           \"column\": 4 \n        },         {\n           \"row\": 4,\n           \"column\": 5 \n        },         { \n          \"row\": 4,\n           \"column\": 6 \n        }       ]     }\n   ],   \"destinations\": [\n     {       \"position\": 6,\n       \"addresses\": [         {\n           \"row\": 5, \n          \"column\": 1 \n        },         {\n           \"row\": 5, \n          \"column\": 2 \n        },         {\n           \"row\": 5, \n          \"column\": 3\n         },         {\n           \"row\": 5, \n          \"column\": 4 \n        },         {\n           \"row\": 5, \n          \"column\": 5 \n        },         {\n           \"row\": 5, \n          \"column\": 6 \n        },         {\n           \"row\": 6, \n          \"column\": 1 \n        },         {\n           \"row\": 6, \n          \"column\": 2 \n        },         {\n           \"row\": 6, \n          \"column\": 3 \n        },         {\n           \"row\": 6, \n          \"column\": 4 \n        },         {\n           \"row\": 6, \n          \"column\": 5 \n        },         {\n           \"row\": 6, \n          \"column\": 6 \n        },         {\n           \"row\": 7, \n          \"column\": 1 \n        },         {\n           \"row\": 7, \n          \"column\": 2 \n        },         {\n           \"row\": 7, \n          \"column\": 3 \n        },         {\n           \"row\": 7, \n          \"column\": 4 \n        },         {\n           \"row\": 7, \n          \"column\": 5 \n        },         {\n           \"row\": 7, \n          \"column\": 6 \n        },         {\n           \"row\": 8, \n          \"column\": 1 \n        },         {\n           \"row\": 8, \n          \"column\": 2 \n        },         {\n           \"row\": 8, \n          \"column\": 3 \n        },         {\n           \"row\": 8, \n          \"column\": 4 \n        },         {\n           \"row\": 8, \n          \"column\": 5 \n        },         {\n           \"row\": 8, \n          \"column\": 6 \n        }       ]\n     }   ] \n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]},"headings":[{"value":"Add a Transfer Samples step to an existing protocol","id":"add-a-transfer-samples-step-to-an-existing-protocol","depth":1},{"value":"Add step to the protocol","id":"51666171915","depth":2},{"value":"API call body example","id":"api-call-body-example","depth":3}],"frontmatter":{"seo":{"title":"Add a Transfer Samples step to an existing protocol"}},"lastModified":"2026-07-30T19:22:04.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/pages/prep_recipe_protocol_add_ts_step","userData":{"isAuthenticated":false,"teams":["anonymous"]}}