Production
Devices
Explore the data types and operations available in Devices.
95 operations
List controllers with pagination. Requires controller:list permission.
listControllerTokensQueryList controller tokens with pagination. Requires controller_token:list permission.
listDataChangeEventTopicsQueryList all valid data change event topics, grouped by resource. Requires authentication.
listDevicesQueryList devices with pagination. Requires device:list permission.
listDeviceTokensQueryList device tokens with pagination. Requires device_token:list permission.
listEdgeAppEventsQueryList edge app events with pagination. Requires edge_app_event:list permission.
listEdgeAppInstallationsQueryList edge app installations with pagination. Requires edge_app_installation:list permission.
listEdgeAppsQueryList edge apps with pagination. Requires edge_app:list permission.
listMagicQueriesQueryLists every available Magic Query noun with a short description and its options — the discovery entry point.
listMetricsQueryList metrics with pagination. Requires metric:list permission.
listNetworksQueryList networks with pagination. Requires network:list permission.
magicQueryQueryExecutes a Magic Query string and returns the predefined query's JSON result. On a bad noun or parameter, returns a structured error whose 'extensions' carry 'code', 'actionable_message', and 'suggestions' for self-correction.
metricCorrelationQueryCompute statistical correlation between two metrics over a time range. Returns Pearson correlation coefficient, slope, intercept, R-squared, and covariance. Metrics are joined by 1-second time buckets. Uses Toolkit stats_agg() 2D. Requires metric:read permission.
metricHeartbeatQueryAnalyze uptime and downtime for a heartbeat-style metric. Detects gaps where no value was received within the expected interval. Returns total uptime/downtime, uptime percentage, and individual gap periods. Uses Toolkit heartbeat_agg(). Requires metric:read permission.
metricHistogramQueryCompute a value distribution histogram for a metric over a time range. Range bounds are auto-detected if not specified. Requires metric:read permission.
metricPercentilesQueryCompute percentile values (e.g. p50, p95, p99) for a metric over a time range. Supports both exact (percentile_cont) and approximate (UddSketch via Toolkit) modes. Approximate mode is faster for large datasets. Useful for SLA analysis and outlier detection. Requires metric:read permission.
metricProjectionQueryCompute a linear regression over historical data and project forward. Returns slope, R-squared, projected values with confidence intervals, and optionally the estimated time a target value will be reached. Requires metric:read permission.
metricStateDurationQueryAnalyze time spent in each discrete state for a status metric. Returns both a duration breakdown by state and a chronological timeline of state transitions (Gantt-chart-ready). Requires a metric with kind STATUS. Uses Toolkit state_agg(). Requires metric:read permission.
pingQueryHealth check endpoint
publishEdgeAppDraftMutationFreeze a DRAFT and flip it to PUBLISHED. Auto-deprecates the previously-PUBLISHED row for the same handle. Pushes config.update to every controller running an installation that pinned the newly-published row. Requires edge_app:write.
publishEdgeAppSourceMutationPublish only the reviewed EdgeApp XML; repeated immutable source is a no-op
recordMetricPointsMutationRecord one or more data points for a metric. Requires metric:write permission.
renderSchemaXMLQueryRender JSON Schema as native XML without dropping unsupported keywords or changing a saved document.
revokeControllerTokenMutationRevoke a controller token. Requires controller_token:revoke permission.
revokeDeviceTokenMutationRevoke a device token. Requires device_token:revoke permission.
saveEdgeAppSourceMutationCreate or update EdgeApp XML and return the authoring view
schemaAuthoringCatalogQueryCompiler-owned vocabulary for the standalone XML JSON Schema dialect, including native form annotations.
searchHelpQuerySearch human-facing manuals using shared semantic and text retrieval.
updateControllerMutationUpdate a controller. Only provided fields are changed. Requires controller:write permission.
updateControllerPolicyMutationUpdate a controller policy. Only provided fields are changed. The referenced controller must exist in this tenant. Triggers a config.update push to the controller. Requires controller_policy:write permission.
updateDeviceMutationUpdate a device. Only provided fields are changed. Requires device:write permission.
updateEdgeAppMutationUpdate an existing DRAFT edge app row. Rejects PUBLISHED/DEPRECATED rows (frozen) and attempts to change `handle` (immutable on an existing draft). Only provided fields are changed. Requires edge_app:write permission.
updateEdgeAppInstallationMutationUpdate a edgeApp installation. Only provided fields are changed; `edgeAppId` is immutable (delete and recreate to change it). Re-validates the controller and bot user (if changed) and `variables` against the edgeApp's configSchema. Pushes config.update to the controller. Requires edge_app_installation:write permission.
updateMetricMutationUpdate a metric. Only provided fields are changed. Requires metric:write permission.
updateNetworkMutationUpdate a network. Only provided fields are changed. Requires network:write permission.
upgradeEdgeAppInstallationMutationRepoint an installation at a different version of the same edgeApp. Validates the target row exists, belongs to this tenant, shares the installation's current handle, and isn't a DRAFT (only PUBLISHED or DEPRECATED versions can be pinned). Pushes config.update to the controller. The bridge reconciles by `installation.id`+`version`, so the new version triggers a restart with the new content. Requires edge_app_installation:write.
upsertControllerMutationCreate or update a controller. Requires controller:write permission.
upsertControllerPolicyMutationCreate or update the policy for a controller. Idempotent on controllerId (one row per controller). Wholesale-replace on both allowlists. Triggers a config.update push to the controller. Requires controller_policy:write permission.
upsertDeviceMutationCreate or update a device. Requires device:write permission.
upsertEdgeAppMutationCreate or update a DRAFT edge app row. With `input.id`: edits the existing draft (rejects PUBLISHED/DEPRECATED rows — those are frozen). Without `input.id`: creates a new draft for the handle (rejects if a draft already exists). Drafts aren't pushed to controllers; use publishEdgeAppDraft to ship. Requires edge_app:write permission.
upsertEdgeAppInstallationMutationCreate or update a edgeApp installation. Validates `variables` against the edgeApp's configSchema (when set) and pushes config.update to the target controller. Requires edge_app_installation:write permission.
upsertEdgeAppSourceMutationCompile, validate, and retain an EdgeApp XML document as a DRAFT. Omit id to create; provide a DRAFT id to replace its source.
upsertMetricMutationCreate or update a metric. Requires metric:write permission.
upsertNetworkMutationCreate or update a network. Requires network:write permission.
validateEdgeAppSourceQueryType-check edgeApp handler / library / onMessage Lua sources against the bridge's ambient API typedef without persisting anything. Safe to call from editors on every keystroke. Requires edge_app:read permission.