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 "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.

Contributions Pods

Overview

Labs

Data

Compute

Lab Ops

Surveys

Surveys API

List Surveys

​Surveys API

​List Surveys

Surveys API

List Surveys