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 11

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: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 #
POST /procedure-run-plan:promote Turn procedure run plans into active procedure runs. #
GET /tasks/procedure-run-plan/promote/{task_id} Poll async task status #

Documentation

📖
Documentation
https://docs.benchling.com/docs/developer-platform-overview
📖
APIReference
https://benchling.com/api/v3/reference
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/authentication/benchling-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/rate-limits/benchling-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/openapi/benchling-procedurerunplan-api-openapi.yml

Other Resources

🔗
OpenAPIRemote
https://benchling.com/api/v3/openapi.yaml
🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/scopes/benchling-scopes.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/conventions/benchling-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/errors/benchling-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/data-model/benchling-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/asyncapi/benchling-webhooks.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/lifecycle/benchling-lifecycle.yml
🔗
ChangeLog
https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/changelog/benchling-changelog.yml
🔗
StabilityPolicy
https://docs.benchling.com/docs/stability-guidelines
🔗
SDKs
https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/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-procedurerunplan-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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:
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  title: Benchling Procedure Run Plan API
  version: 2.0.0
  description: A draft experiment plan that can be promoted to a `ProcedureRun` for execution.
servers:
- url: /api/v3
security:
- oAuth: []
- basicApiKeyAuth: []
tags:


# --- truncated at 32 KB (44 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/openapi/benchling-procedurerunplan-api-openapi.yml