← API reference
CANONICAL TYPE REFERENCE

UpsertEdgeAppInput

Input for creating or updating a edge app

Existing edgeApp ID; omit to create

handleString!

Wire id (lowercase letters/digits/underscore/hyphen)

nameString!

Display name

Optional human description

Triggers in this edgeApp

Handlers in this edgeApp

Reusable Lua snippets (optional; defaults to empty)

External MQTT broker template shape (optional; secrets live on the installation)

External OPC UA endpoints (optional; credentials/PEMs may be ${config:NAME} templates)

External SNMP devices (optional; community/keys may be ${config:NAME} templates)

Modbus ports (optional; auth-free protocol)

Exec commands (optional; gated by the controller's policy at run time)

HTTP inbound routes (optional; auth credentials are write-only and redacted on read)

onMessageString

Lua entry point script for local.edgeApp.invoke (optional)

Optional JSON Schema for installation variables

Cloud-forwarding level

isActiveBoolean

Default true

View exact SDL
"""Input for creating or updating a edge app"""
input UpsertEdgeAppInput {
  """Existing edgeApp ID; omit to create"""
  id: EdgeAppID
  """Wire id (lowercase letters/digits/underscore/hyphen)"""
  handle: String!
  """Display name"""
  name: String!
  """Optional human description"""
  description: String
  """Triggers in this edgeApp"""
  triggers: [EdgeAppTriggerInput!]!
  """Handlers in this edgeApp"""
  handlers: [EdgeAppHandlerInput!]!
  """Reusable Lua snippets (optional; defaults to empty)"""
  libraries: [EdgeAppLibraryInput!]
  """
  External MQTT broker template shape (optional; secrets live on the installation)
  """
  mqttBrokers: [EdgeAppMQTTBrokerInput!]
  """
  External OPC UA endpoints (optional; credentials/PEMs may be ${config:NAME} templates)
  """
  opcuaEndpoints: [EdgeAppOPCUAEndpointInput!]
  """
  External SNMP devices (optional; community/keys may be ${config:NAME} templates)
  """
  snmpDevices: [EdgeAppSNMPDeviceInput!]
  """Modbus ports (optional; auth-free protocol)"""
  modbusPorts: [EdgeAppModbusPortInput!]
  """Exec commands (optional; gated by the controller's policy at run time)"""
  execCommands: [EdgeAppExecCommandInput!]
  """
  HTTP inbound routes (optional; auth credentials are write-only and redacted on read)
  """
  httpRoutes: [EdgeAppHTTPRouteInput!]
  """Lua entry point script for local.edgeApp.invoke (optional)"""
  onMessage: String
  """Optional JSON Schema for installation variables"""
  configSchema: JSON
  """Cloud-forwarding level"""
  logLevel: EdgeAppLogLevel
  """Default true"""
  isActive: Boolean
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.