Production
Devices
Explore the data types and operations available in Devices.
95 operations
Aggregate metric data points into time buckets with configurable statistics. Automatically routes to pre-computed continuous aggregates for HOUR/DAY/WEEK/MONTH intervals. Supports gap-filling (LOCF/interpolation), time-weighted averages, and counter delta/rate via Toolkit. For counter metrics, computes delta (last-first) per bucket instead of average. Requires metric:read permission.
analyzeEdgeAppSourceQueryValidate complete EdgeApp XML without saving; returns compiler catalog and original source ranges.
compareMetricsQueryCompare multiple metrics side-by-side over the same time range and interval. Returns time-bucketed aggregates and summary statistics for each metric. Supports 2-10 metrics per request. Requires metric:read permission.
compileSchemaXMLQueryCompile standalone XML schema syntax into JSON Schema without persisting it; host restrictions apply when embedded.
controllerConnectionStatusQueryCheck whether a controller has an active bridge connection. Requires controller:read permission.
controllerStatusQueryLatest discovery and health snapshot, with platform receipt time and freshness
createControllerMutationCreate a new controller. Requires controller:write permission.
createControllerPolicyMutationCreate a new controller policy. The referenced controller must exist in this tenant. Triggers a config.update push to the controller. Requires controller_policy:write permission.
createControllerTokenMutationCreate a new controller token. Returns the signed token value. Requires controller_token:write permission.
createDeviceMutationCreate a new device. Requires device:write permission.
createDeviceTokenMutationCreate a new device token. Returns the signed token value. Requires device_token:write permission.
createEdgeAppMutationCreate a new DRAFT edge app row for `input.handle`. Rejects if a draft already exists for the handle (finish or delete it first). Drafts aren't pushed to controllers; use publishEdgeAppDraft to ship. Requires edge_app:write permission.
createEdgeAppInstallationMutationCreate a edgeApp installation. Validates the edgeApp exists in this tenant and isn't DRAFT, that the controller exists, that an optional bot user exists, and `variables` against the edgeApp's configSchema (when set); pushes config.update to the target controller. Requires edge_app_installation:write permission.
createMetricMutationCreate a new metric. Requires metric:write permission.
createNetworkMutationCreate a new network. Requires network:write permission.
dataChangeEventsSubscriptionSubscribe to real-time data change events. Requires read permission on each requested resource. Task topics are the exception: a signed-in user without task:read receives the events of their own tasks only (assigned to them, claimed by them, unclaimed on their teams).
deleteControllerMutationDelete a controller. Requires controller:delete permission.
deleteControllerPolicyMutationDelete a controller's policy. The controller falls back to default-deny on the next config.update push. Requires controller_policy:delete permission.
deleteDeviceMutationDelete a device. Requires device:delete permission.
deleteEdgeAppMutationDelete a edge app row. Cascades to all installations pinning this row and pushes config.update to each affected controller. Use deprecateEdgeApp instead to retire a PUBLISHED row without losing installation history.
deleteEdgeAppInstallationMutationDelete a edgeApp installation. Triggers a config.update push to the controller.
deleteMetricMutationDelete a metric and all its data points. Requires metric:delete permission.
deleteNetworkMutationDelete a network. Requires network:delete permission.
deprecateEdgeAppMutationMark a PUBLISHED row as DEPRECATED. Used to retire an app without a replacement. Existing installations stay pinned and keep working until upgraded or uninstalled. Idempotent on already-DEPRECATED rows; rejects DRAFT rows (delete them instead). Requires edge_app:write permission.
downsampleMetricPointsQueryDownsample metric data points for efficient visualization. Uses the Largest Triangle Three Buckets (LTTB) algorithm to preserve the visual shape of the time series while reducing point count. Optionally preserves gaps in data via gp_lttb(). Uses Toolkit lttb() / gp_lttb(). Requires metric:read permission.
edgeAppLogStreamSubscriptionStream new LOG-kind edgeApp events as they arrive for a single installation. Requires edge_app_event:read.
exportEdgeAppMutationExport an edge app to YAML or JSON. Requires edge_app:read permission.
generateDefaultDataQueryQueryGenerate a default GraphQL data query for an event topic. Returns a query string with all scalar fields for the resource, or null if the topic has no matching query. The query uses $id as the variable for the resource ID.
getControllerQueryFetch a single controller by ID. Requires controller:read permission.
getControllerPolicyQueryFetch a controller policy by its ID. Requires controller_policy:read permission.
getControllerPolicyByControllerQueryFetch a controller's policy by the controller ID (the natural key). Returns null if no policy is configured (default-deny).
getDeviceQueryFetch a single device by ID. Requires device:read permission.
getEdgeAppQueryFetch a edge app by ID. Requires edge_app:read permission.
getEdgeAppEventQueryFetch a edge app event by ID. Requires edge_app_event:read permission.
getEdgeAppInstallationQueryFetch a edge app installation by ID. Requires edge_app_installation:read permission.
getEdgeAppSourceQueryRead exact EdgeApp XML for authoring. Requires edge_app:write permission.
getMagicQueryGraphQLQueryResolves a Magic Query string to the real GraphQL operation and variables it runs, so consumers can graduate from the façade to raw GraphQL. Does not execute.
getMagicQuerySchemaQueryReturns the input JSON Schema and output introspection for a Magic Query noun, so consumers (especially LLMs) can learn its contract before calling magicQuery.
getMetricQueryFetch a single metric by ID. Requires metric:read permission.
getMetricPointsQueryQuery time-series data points for a metric. Returns a flat array ordered by timestamp, with summary stats. Requires metric:read permission.
getNetworkQueryFetch a single network by ID. Requires network:read permission.
helpChapterQueryRead a chapter of the current published manual edition.
helpChaptersQueryList human-facing manual chapters from the running deployment.
iacGuidesQueryEvery authoring guide, for a tool that syncs them to a folder. Intended for `schema pull` to call once and write to disk, not for an agent to call while authoring — a file can be grepped and re-read in part, where a response arrives whole.
iacSchemaQueryThe infrastructure-only view of this schema, for declarative tooling. Contains only annotated resources and the types they reach.
iacSchemaDocumentQueryFetch the JSON Schema document a SCHEMA-kind validator references, for declarative tooling.
iacValidateQueryValidate an infrastructure artifact. Pure and side-effect free; safe to alias many times in one document.
importEdgeAppMutationImport an edge app from YAML or JSON, landing it as a DRAFT (replaces an existing DRAFT for the handle, or allocates the next version). Requires edge_app:write permission.
invokeEdgeAppMutationInvoke a edgeApp's onMessage export by name on a specific controller (the edgeApp must be installed on it). Forwards to the bridge and returns the function's JSON return value. Requires edge_app:invoke permission.
listControllerPoliciesQueryList controller policies with pagination. Requires controller_policy:list permission.