Data Hub
Runs

Restore a run

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

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

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

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/restore"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "instrument_id": "string",  "run_id": "string",  "deleted_at": "2019-08-24T14:15:22Z",  "already_applied": true}
{  "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    }  }}

Soft-delete a run DELETE

Requires scope `runs:delete`. Also cancels the uploads that were requested for the run's files: they go back to `detected` and leave the watcher's upload queue. Restoring the run doesn't bring the requests back.

Reprocess a run POST

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.