Data Hub
Runs

Reprocess a run

Requires scope `runs:reprocess`. Queues every `uploaded`, `failed`, `completed`, or stalled `processing` raw file on the run for reprocessing. Each file starts as soon as a processing slot is free (at most 10 raw files process at once by default), and a file that does not start right away waits as `queued`. `files_queued` counts every file accepted, whether it started or is waiting. Processed artifacts are skipped. The instrument must have a Lambda processor.

POST
/instruments/{instrumentId}/runs/{runId}/reprocess

Requires scope runs:reprocess. Queues every uploaded, failed, completed, or stalled processing raw file on the run for reprocessing. Each file starts as soon as a processing slot is free (at most 10 raw files process at once by default), and a file that does not start right away waits as queued. files_queued counts every file accepted, whether it started or is waiting. Processed artifacts are skipped. The instrument must have a Lambda processor.

Authorization

bearerAuth
AuthorizationBearer <token>

Personal access tokens begin with dhub_… and are restricted by their assigned scopes.

In: header

Path Parameters

instrumentId*string
runId*string

The run ID. Spaces at the start or end are ignored.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/instruments/plate-reader/runs/run-2026-001/reprocess"
{  "instrument_id": "string",  "run_id": "string",  "files_queued": 0,  "files_failed": 0}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

Restore a run POST

Requires scope `runs:delete`. Doesn't bring back the upload requests that deleting the run cancelled. Request the uploads again.

Cancel a run's queued files POST

Requires scope `runs:reprocess`. Takes every `queued` file of the run out of the reprocessing queue. Each one becomes `failed` with a message that says the reprocess was cancelled, and can be reprocessed again. Files that have already started are not affected. Works on a soft-deleted run too. `files_cancelled` is 0 when no file was queued.