> This page is for Developer Documentation. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.benchling.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.benchling.com/_mcp/server. # Batch update ProcedureRunPlanCondition PATCH https://{tenant_name}.benchling.com/api/v3/procedure-run-plan-condition:batch-update Content-Type: application/json Batch update ProcedureRunPlanCondition synchronously in one transaction. Maximum 25 items per request. Reference: https://docs.benchling.com/docs/api/benchling-api/procedure-run-plan-condition/batchupdate ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Headers - `EARLY-ACCESS` (string, optional) — Set to true to access beta operations via /api/v3. ### Body (application/json) This endpoint expects an object. - `items` (list of UpdateProcedureRunPlanConditionInputWithPathParams, required) ## Response ### 200 OK - `items` (list of ProcedureRunPlanCondition, required) ## Errors ### 400 Procedure Run Plan Condition Batch Update Request Bad Request Error Bad Request - `detail` (GeneralErrorDetail, required, nullable) - `instance` (string, required) - `status` (integer, required) - `title` (string, required, nullable) - `type` (string, required) - `invalidId` (string, optional) ### 403 Procedure Run Plan Condition Batch Update Request Forbidden Error Forbidden - `detail` (GeneralErrorDetail, required, nullable) - `instance` (string, required) - `status` (integer, required) - `title` (string, required, nullable) - `type` (string, required) - `invalidId` (string, optional) ### 404 Procedure Run Plan Condition Batch Update Request Not Found Error Not Found - `detail` (GeneralErrorDetail, required, nullable) - `instance` (string, required) - `status` (integer, required) - `title` (string, required, nullable) - `type` (string, required) - `invalidId` (string, optional) ### 409 Procedure Run Plan Condition Batch Update Request Conflict Error Conflict - `detail` (GeneralErrorDetail, required, nullable) - `instance` (string, required) - `status` (integer, required) - `title` (string, required, nullable) - `type` (string, required) - `invalidId` (string, optional) ### 429 Procedure Run Plan Condition Batch Update Request Too Many Requests Error Too Many Requests - `detail` (TooManyRequestsErrorBodyDetail, required, nullable) - `instance` (string, required) - `status` (integer, required) - `title` (string, required, nullable) - `type` (string, required) - `invalidId` (string, optional) ### 500 Procedure Run Plan Condition Batch Update Request Internal Server Error Internal Server Error - `detail` (InternalServerErrorBodyDetail, required, nullable) - `instance` (string, required) - `status` (integer, required) - `title` (string, required, nullable) - `type` (string, required) - `errorId` (string, optional) ## Types ### UpdateProcedureRunPlanConditionInputWithPathParams - `id` (string, required) - `description` (string, optional) — Description of the condition. Must not exceed 255 characters. - `methodParametersPlan` (MethodParametersPlanInput, optional, nullable) — Pre-filled parameter values for this condition's unit operation. Set to null to clear planned values and use defaults upon run creation. - `name` (string, optional) — Display name of the condition. Must not be empty and must not exceed 255 characters. - `replicates` (list of ProcedureRunPlanConditionReplicateInput, optional) — Replace the full set of replicates for this condition. The plan's total number of replicates must not exceed 500, and `replicateNumber` values must be consecutive starting from 1. ### ProcedureRunPlanCondition A planned experimental condition within a `ProcedureRunPlan`, representing how a procedure's methods will be configured when the plan is promoted to an actual `ProcedureRun`. Each condition contains pre-filled parameter values (via `MethodParametersPlan`) for the procedure's unit operations, and specifies how many replicates will be run (via `ProcedureRunPlanConditionReplicate`). Scientists use conditions to plan different experimental configurations before execution—for example, testing multiple temperatures or reagent concentrations. The `position` field determines display order within the parent run plan. Upon promotion, each ProcedureRunPlanCondition becomes a `ProcedureRunCondition` in the resulting experiment. Also known as an "experiment condition" in the Benchling UI's experiment planning workflow. - `__typename` (string, optional) - `createdAt` (string, optional) - `description` (string, optional) — The user-defined description of the condition. - `id` (string, optional) - `methodParametersPlan` (MethodParametersPlan, optional, nullable) — Method plan containing parameter values for this condition's unit operation. If this value is null upon promotion to a procedure run, default values from the procedure will be used. - `modifiedAt` (string, optional) - `name` (string, optional) — The user-defined name of the condition. - `position` (integer, optional) — The display order of the condition within the run. - `procedureRunPlan` (ProcedureRunPlanRef, optional) — The ProcedureRunPlan that this condition is a part of. - `replicates` (list of ProcedureRunPlanConditionReplicate, optional) — Replicate information for this condition. - `templateMethodVersion` (ProcedureMethodDefinitionVersionRef, optional) — The procedure method definition version (PMDV) this condition belongs to. ### GeneralErrorDetail ### TooManyRequestsErrorBodyDetail ### InternalServerErrorBodyDetail ### MethodParametersPlanInput - `dataParameterValues` (list of DataParameterValuePlanInput, required) — Planned values for data parameters in this method. - `equipmentValues` (list of EquipmentValuePlanInput, required) — Planned values for equipment parameters in this method. - `materialInputValues` (list of MaterialInputValuePlanInput, required) — Planned values for material inputs in this method. ### ProcedureRunPlanConditionReplicateInput - `replicateNumber` (integer, required) — The 1-indexed replicate number. Must be >= 1. Replicate numbers must be consecutive starting from 1 (e.g., 1, 2, 3). - `sourcePmeiIds` (list of string, optional) — IDs of source procedure method execution instances (PMEIs) for unit operation linking. Format: `pcmei_XXXXXXXX`. Used to connect this replicate's inputs to outputs from a previous run. IDs must be unique, and a replicate can reference at most 100 source PMEIs. ### MethodParametersPlan Contains the planned parameter values for a single unit operation (method) within a `ProcedureRunPlanCondition`. Links to a `ProcedureMethodDefinitionVersion` via `templateMethodVersion` to identify which method these values apply to. Parameter values are organized by category: `dataParameterValues` for data fields like numbers or text, `materialInputValues` for sample or reagent inputs, and `equipmentValues` for equipment assignments. When the parent `ProcedureRunPlan` is promoted to a `ProcedureRun`, these planned values become the starting values in the resulting `ProcedureMethodExecutionInstance`. - `__typename` (string, optional) - `dataParameterValues` (list of DataParameterValuePlan, optional) — Planned values for data parameters keyed by parameter identifiers. - `equipmentValues` (list of EquipmentValuePlan, optional) — Planned values for equipment keyed by equipment identifiers. - `materialInputValues` (list of MaterialInputValuePlan, optional) — Planned values for material inputs keyed by input identifiers. ### ProcedureRunPlanRef - `__typename` (string, optional) - `id` (string, optional) ### ProcedureRunPlanConditionReplicate Represents a planned replicate within a `ProcedureRunPlanCondition`. Scientists often run the same experimental condition multiple times to obtain statistically significant results—each repetition is a replicate. The `replicateNumber` provides a one-indexed identifier (e.g., replicate 1, 2, 3). The `sourcePmeiIds` field supports unit operation linking by storing source `ProcedureMethodExecutionInstance` IDs from other procedure runs. Upon promotion of the parent `ProcedureRunPlan`, each ProcedureRunPlanConditionReplicate becomes a `ProcedureRunConditionReplicate` in the resulting procedure run. - `__typename` (string, optional) - `procedureRunPlanCondition` (ProcedureRunPlanConditionRef, optional) — The ProcedureRunPlanCondition that this replicate belongs to. - `replicateNumber` (integer, optional) — The replicate number. - `sourcePmeiIds` (list of string, optional) — Source PMEI IDs for this replicate. Support unit operation linking to future-pmeis when executing the draft procedure run. ### ProcedureMethodDefinitionVersionRef - `__typename` (string, optional) - `id` (string, optional) ### DataParameterValuePlanInput - `parameterId` (string, required) — The ID of the procedure parameter version. Format: `schver_XXXXXXXX`. - `value` (map from string to any, required) — A dict with the shape \{"value": \}. The inner TypedValue must match the referenced parameter's configured data type. Supported types are ft\_float, ft\_string, and ft\_datetime (e.g., \{"type": "ft\_float", "floatValue": 1.5, "value": "1.5"} for numeric, \{"type": "ft\_string", "value": "text"} for text, or \{"type": "ft\_datetime", ...} for datetime). For plate-map-confirmed parameters with multiple setpoints, send one DataParameterValuePlanInput per setpoint, each with a scalar TypedValue. ### EquipmentValuePlanInput - `equipmentId` (string, required) — The ID of the equipment parameter version. Format: `schver_XXXXXXXX`. - `value` (map from string to any, required) — A dict with the shape \{"value": \{"equipment": \}}. The equipment TypedValue must match the referenced equipment parameter's configured type: \{"type": "ft\_string", "value": "..."} for text inputs, or \{"type": "ft\_file\_link", "targetFiles": \[...]} for entity link inputs. ### MaterialInputValuePlanInput - `materialInputId` (string, required) — The ID of the material input parameter version. Format: `schver_XXXXXXXX`. - `value` (map from string to any, required) — A dict with the shape \{"value": \{"material": \, "amount": \}}. The material TypedValue must match the referenced material input's configured type: \{"type": "ft\_string", "value": "..."} for text inputs, or \{"type": "ft\_file\_link", "targetFiles": \[...]} for entity link inputs. The amount TypedValue is always ft\_float (e.g., \{"type": "ft\_float", "floatValue": 1.0, "value": "1.0"}). Either sub-field may be null independently. ### DataParameterValuePlan A pre-filled value for a data parameter within a `MethodParametersPlan`. The `parameterId` references the `ProcedureParameterVersion` this value applies to. The `value` field contains the planned data in JSON format, which may be a number, string, or structured value depending on the parameter's data type configuration. Used during experiment planning to specify default values that will populate the parameter when the procedure run is created. - `__typename` (string, optional) - `parameterId` (string, optional) - `value` (map from string to any, optional) ### EquipmentValuePlan A pre-filled value for an equipment parameter within a `MethodParametersPlan`. The `equipmentId` references the `ProcedureParameterVersion` for the equipment parameter this value applies to. The `value` field contains the planned equipment assignment in JSON format, typically specifying which piece of lab equipment will be used. Used during experiment planning to pre-assign instruments or devices that will be used when the procedure run is executed. - `__typename` (string, optional) - `equipmentId` (string, optional) - `value` (map from string to any, optional) ### MaterialInputValuePlan A pre-filled value for a material input within a `MethodParametersPlan`. The `materialInputId` references the `ProcedureParameterVersion` for the material input this value applies to. The `value` field contains the planned material specification in JSON format, typically including sample references and quantities. Used during experiment planning to pre-assign samples, reagents, or other materials that will be used when the procedure run is executed. - `__typename` (string, optional) - `materialInputId` (string, optional) - `value` (map from string to any, optional) ### ProcedureRunPlanConditionRef - `__typename` (string, optional) - `id` (string, optional) ## Examples **Request** ```json { "items": [ { "id": "prpc_Bm7nWsKt", "description": "100mg/kg treatment group", "methodParametersPlan": { "dataParameterValues": [ { "parameterId": "schver_Rm4nTvWz", "value": { "value": { "floatValue": 100, "type": "ft_float", "value": "100.0" } } } ], "equipmentValues": [ { "equipmentId": "schver_Yw3tRsLm", "value": { "value": { "equipment": { "type": "ft_string", "value": "Mixer A" } } } } ], "materialInputValues": [ { "materialInputId": "schver_Kp8wNmXq", "value": { "value": { "amount": { "floatValue": 5, "type": "ft_float", "value": "5.0" }, "material": { "targetFiles": [ { "id": "bfi_jdf8BV24" } ], "type": "ft_file_link", "value": "Reagent A" } } } } ] }, "name": "High Dose", "replicates": [ { "replicateNumber": 1 }, { "replicateNumber": 2 } ] } ] } ``` **Response** ```json { "items": [ { "__typename": "__typename", "createdAt": "createdAt", "description": "description", "id": "id", "modifiedAt": "modifiedAt", "name": "name", "position": 1, "replicates": [ {} ] } ] } ``` **SDK Code** ```python import requests url = "https://{tenant_name}.benchling.com/api/v3/procedure-run-plan-condition:batch-update" payload = { "items": [ { "id": "prpc_Bm7nWsKt", "description": "100mg/kg treatment group", "methodParametersPlan": { "dataParameterValues": [ { "parameterId": "schver_Rm4nTvWz", "value": { "value": { "floatValue": 100, "type": "ft_float", "value": "100.0" } } } ], "equipmentValues": [ { "equipmentId": "schver_Yw3tRsLm", "value": { "value": { "equipment": { "type": "ft_string", "value": "Mixer A" } } } } ], "materialInputValues": [ { "materialInputId": "schver_Kp8wNmXq", "value": { "value": { "amount": { "floatValue": 5, "type": "ft_float", "value": "5.0" }, "material": { "targetFiles": [{ "id": "bfi_jdf8BV24" }], "type": "ft_file_link", "value": "Reagent A" } } } } ] }, "name": "High Dose", "replicates": [{ "replicateNumber": 1 }, { "replicateNumber": 2 }] } ] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.patch(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://{tenant_name}.benchling.com/api/v3/procedure-run-plan-condition:batch-update'; const options = { method: 'PATCH', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"items":[{"id":"prpc_Bm7nWsKt","description":"100mg/kg treatment group","methodParametersPlan":{"dataParameterValues":[{"parameterId":"schver_Rm4nTvWz","value":{"value":{"floatValue":100,"type":"ft_float","value":"100.0"}}}],"equipmentValues":[{"equipmentId":"schver_Yw3tRsLm","value":{"value":{"equipment":{"type":"ft_string","value":"Mixer A"}}}}],"materialInputValues":[{"materialInputId":"schver_Kp8wNmXq","value":{"value":{"amount":{"floatValue":5,"type":"ft_float","value":"5.0"},"material":{"targetFiles":[{"id":"bfi_jdf8BV24"}],"type":"ft_file_link","value":"Reagent A"}}}}]},"name":"High Dose","replicates":[{"replicateNumber":1},{"replicateNumber":2}]}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ```