Manage instruments
Confirm pending instruments, read instrument health, and understand instrument states.
When a lab operator registers an instrument from the watcher, it appears as pending and cannot upload until you confirm it. Operator-side setup is in Set up an instrument. Retiring and reactivating are in Retire an instrument.
Instrument states
| Status | UI label | Meaning |
|---|---|---|
pending | Pending | Registered but not confirmed. Watchers cannot upload. |
active | Active | Confirmed and accepting uploads. |
inactive | Retired | Deactivated; no new uploads. Historical runs stay browsable. |
The Instruments page has tabs for active, pending, and retired instruments.
Confirm a pending instrument
Open the Data Hub web app and go to Instruments.
Open the Pending tab (or find the yellow pending badge).
Click Confirm. Status becomes active and the operator’s watcher can upload.
Confirming is admin-only for session users. Under the hood it is PATCH /api/v1/instruments/:id. Bearer automation uses the instruments:write scope instead. See the generated API docs.
View instrument health
The instrument detail page shows run count and watcher online/offline counts. Watcher health comes from heartbeats; see Manage the watcher fleet.
You can also rename the display name and set instrument type from the admin actions on the instrument header. The instrument ID never changes: it is the storage key prefix.