Benchling

Benchling Procedure Run Plan API

A draft experiment plan that can be promoted to a `ProcedureRun` for execution. Scientists use run plans to configure experimental conditions, parameter values, and replicates before starting an actual experiment. Belongs to a `Study` and references a procedure template via either `templateProcedureFlowchartVersion` (for legacy flowcharts) or `procedureFlowchartConfigVersionProxy` (for new-style workflow flowcharts). Contains `ProcedureRunPlanCondition` objects that define the different experimental configurations to test. The `dataEntryMode` (see `ProcedureRunDataEntryMode`) specifies whether each condition-replicate will have its own data entry worksheet or share a single worksheet. The `confirmationMethodByParamVersionId` allows overriding default confirmation methods for specific parameters. Upon promotion, the run plan becomes a `ProcedureRun` with corresponding `ProcedureRunCondition` and `ProcedureRunConditionReplicate` objects. Also known as a "draft experiment" in the Benchling UI.

GitHub OpenAPI
Business capability
Experimentation & Prototyping Management BC-810.30

Operations 12

POST /procedure-run-plan Create ProcedureRunPlan #
GET /procedure-run-plan/items List ProcedureRunPlan items #
GET /procedure-run-plan/{procedure_run_plan_id} Get ProcedureRunPlan by ID #
PATCH /procedure-run-plan/{procedure_run_plan_id} Update ProcedureRunPlan #
GET /procedure-run-plan/{procedure_run_plan_id}/procedure-run-plan-conditions/items List ProcedureRunPlanCondition items #
POST /procedure-run-plan/{procedure_run_plan_id}:promote Turn a ProcedureRunPlan into an active ProcedureRun #
POST /procedure-run-plan:batch-create Batch create ProcedureRunPlan #
PATCH /procedure-run-plan:batch-update Batch update ProcedureRunPlan #
POST /procedure-run-plan:bulk-create Bulk create ProcedureRunPlan #
PATCH /procedure-run-plan:bulk-update Bulk update ProcedureRunPlan #
GET /tasks/procedure-run-plan/promote/{task_id} Poll async task status #
POST /procedure-run-plan:promote Turn procedure run plans into active procedure runs. #

Documentation

📖
Documentation
https://docs.benchling.com/docs/developer-platform-overview
📖
APIReference
https://benchling.com/api/v3/reference
📖
Authentication
https://artifacts.apis.io/benchling/authentication/benchling-authentication.yml
📖
RateLimits
https://artifacts.apis.io/benchling/rate-limits/benchling-rate-limits.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/benchling/openapi/benchling-procedurerunplan-api-openapi.yml

Other Resources

🔗
OpenAPIRemote
https://benchling.com/api/v3/openapi.yaml
🔗
Conventions
https://artifacts.apis.io/benchling/conventions/benchling-conventions.yml
🔗
ErrorCatalog
https://artifacts.apis.io/benchling/errors/benchling-problem-types.yml
🔗
DataModel
https://artifacts.apis.io/benchling/data-model/benchling-data-model.yml
🔗
Webhooks
https://artifacts.apis.io/benchling/asyncapi/benchling-webhooks.yml
🔗
Lifecycle
https://artifacts.apis.io/benchling/lifecycle/benchling-lifecycle.yml
🔗
ChangeLog
https://artifacts.apis.io/benchling/changelog/benchling-changelog.yml
🔗
StabilityPolicy
https://docs.benchling.com/docs/stability-guidelines
🔗
SDKs
https://artifacts.apis.io/benchling/packages/benchling-packages.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/benchling:benchling-procedurerunplan-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

benchling-procedurerunplan-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Benchling Procedure Run Plan API
  version: 2.0.0
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  description: 'Operations tagged ProcedureRunPlan across 2 of this provider''s published API definitions: benchling-openapi.yml, benchling-v3-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: /api/v3
security:
- oAuth: []
- basicApiKeyAuth: []
tags:


# --- truncated at 32 KB (63 KB total) ---
# Full source: https://artifacts.apis.io/benchling/openapi/benchling-procedurerunplan-api-openapi.yml