Surveys

List QC surveys — quality-control passes over experimental datasets.

Surveys API

Surveys are automated QC passes that scan experiment output datasets for anomalies. Each survey records an anomaly rate, a QC status (pass/warn/fail), and an optional explanation. Surveys feed the anomaly detection pipeline and are displayed in the lab’s Data view.

List Surveys

labId · string · required

Convex ID of the lab.

curl

curl "https://www.hubify.com/api/v1/surveys?labId=$LAB_ID" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

surveys · object[] · required

All surveys for the lab.

Show Survey

_id · string · required

Convex document ID.

name · string · required

Survey name.

surveyType · string

One of spectral, photometric, catalog, simulation, other.

sourceCount · number

Number of sources/rows scanned.

anomalyRate · number

Fraction of sources flagged (0-1).

qcStatus · string

One of pass, warn, fail.

qcExplanation · string

Agent-generated explanation of QC result.

experimentId · string

Linked experiment.

createdAt · number

Unix ms.

Survey anomalyRate values above 0.05 (5%) typically warrant a warn QC status; above 0.15 (15%) warrant fail. These thresholds are set per-lab in the compute settings.