Skip to content

Discover halls and sensors

The GraphQL endpoint is POST /graphql. Organization API Tokens can execute queries only; parsed mutations are rejected.

query OrganizationInventory {
orgs {
id
name
}
dataHalls {
id
name
}
}

orgs returns exactly the token’s organization. dataHalls cannot enumerate another customer’s halls even when a caller supplies a foreign organization ID.

query HallSensors($hallId: ID!) {
sensors(hallId: $hallId) {
id
kind
mac
serial
model
status
}
}

Variables:

{
"hallId": "dc_hall_REPLACE_ME"
}

For wireless_mac, use mac as the raw-frame path key. For wired_serial, use serial. Refresh discovery rather than hard-coding a fleet: registrations and ownership can change.