create a run

A run is the ordered list of instructions that build upon another. The easiest way to create a run is to launch a protocol, but you can also create them directly.

The run object that must be submitted in the POST body has the form:

{
  "title": "My run title",
  "protocol": {
    /* autoprotocol body with `ref` and `instruction` stanzas */
  },
  "test_mode": true /* or false */
}

Submitting runs from packaged protocols via the API

❗️

This feature is experimental

It is also possible to programmatically launch packaged protocols such as those reloaded into your organization or from any other packages uploaded to your organization.

Prior to POSTing to this end point a launch_request_id must be obtained from the protocols launch endpoint.

The body of the request will look like below:

{
  "title": "My run title",
  "launch_request_id": "lrxxxxxxx", /* a genuine launch request id */
  "test_mode": true /* or false */
}
Language
Authentication
Response
Click Try It! to start a request and see the response here!