--- updatedAt: 2026-04-21T07:39:19.000Z agentTools: projectIndex: https://developer.ixon.cloud/llms.txt --- # Agent # OpenAPI definition ```json { "openapi": "3.0.2", "info": { "contact": { "name": "IXON B.V.", "url": "https://www.ixon.cloud/", "email": "support@ixon.cloud" }, "description": "API for the IXON Cloud Platform", "license": { "name": "All Rights Reserved", "url": "https://www.ixon.cloud/" }, "title": "IXON API", "version": "0.1.317" }, "servers": [ { "description": "IXON Cloud platform server", "url": "https://portal.ixon.cloud:443/api/" } ], "paths": { "/agents/{publicId}": { "get": { "tags": [ "Agent" ], "summary": "Agent", "responses": { "200": { "description": "Success response", "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "type", "data" ], "properties": { "status": { "type": "string", "default": "success", "nullable": false }, "type": { "type": "string", "nullable": false }, "data": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "deviceId": { "maxLength": 128, "minLength": 1, "nullable": false, "type": "string" }, "type": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "additionalSubnets": { "nullable": false, "type": "boolean" }, "allowDataPublishing": { "nullable": false, "type": "boolean" }, "allowDemoDevice": { "nullable": false, "type": "boolean" }, "allowTemplating": { "nullable": false, "type": "boolean" }, "allowReboot": { "nullable": false, "type": "boolean" }, "configPush": { "nullable": false, "type": "boolean" }, "configFileFormat": { "maximum": 4294967295, "nullable": false, "type": "integer", "format": "int32" }, "customServers": { "nullable": false, "type": "boolean" }, "deviceIdFormat": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "httpProxyPort": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "latestFirmwareFile": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "description": { "maxLength": 65535, "minLength": 0, "nullable": false, "type": "string" }, "code": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "releaseStage": { "enum": [ "alpha", "beta", "rc", "ga" ], "nullable": false, "type": "string" }, "releaseDate": { "nullable": true, "type": "string", "format": "date" }, "notes": { "maxLength": 65535, "minLength": 0, "nullable": false, "type": "string" }, "agentType": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "type": { "enum": [ "firmware" ], "nullable": false, "type": "string" }, "latest": { "nullable": false, "type": "boolean" }, "custom": { "nullable": false, "type": "object" } } }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "offlineConfiguration": { "nullable": false, "type": "boolean" }, "openvpnConfigMultiUse": { "nullable": false, "type": "boolean" }, "purchasePrice": { "nullable": false, "type": "object", "properties": { "gratis": { "nullable": false, "type": "boolean" } } }, "router": { "nullable": false, "type": "boolean" }, "stunnelSupport": { "nullable": false, "type": "boolean" }, "wanPortForwardings": { "nullable": false, "type": "boolean" }, "custom": { "nullable": false, "type": "object" }, "hasSecondWanPort": { "nullable": false, "type": "boolean" } } }, "location": { "nullable": true, "type": "object", "properties": { "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "latitude": { "nullable": false, "type": "string" }, "longitude": { "nullable": false, "type": "string" } } }, "geoLocation": { "nullable": true, "type": "object", "properties": { "latitude": { "nullable": false, "type": "string" }, "longitude": { "nullable": false, "type": "string" }, "country": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "city": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } }, "timeZone": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "custom": { "nullable": false, "type": "object" }, "description": { "maxLength": 65535, "minLength": 0, "nullable": true, "type": "string" }, "useStunnel": { "nullable": false, "type": "boolean" }, "preferLocationOverGeoip": { "nullable": false, "type": "boolean" }, "reRegistration": { "nullable": false, "type": "boolean" }, "replaceRegistration": { "nullable": false, "type": "boolean" }, "replaceMacAddress": { "maxLength": 17, "minLength": 0, "nullable": true, "pattern": "[0-9a-fA-F]{2}(:[0-9a-fA-F]{2}){5}", "type": "string" }, "fixedVpnAddress": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "macAddress": { "maxLength": 17, "minLength": 1, "nullable": false, "type": "string" }, "serialNumber": { "maxLength": 128, "minLength": 1, "nullable": false, "type": "string" }, "pullCodeGeneratedOn": { "nullable": true, "type": "string", "format": "date-time" }, "controlKeyGeneratedOn": { "nullable": true, "type": "string", "format": "date-time" }, "lastSeenAgentUserAgent": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "value": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "configName": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "configVersion": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "hardware": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "hardwareCode": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "hardwareVersion": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "firmwareVersion": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "osName": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "osVersion": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "appName": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "appVersion": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "packageName": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "packageVersion": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "libixagentVersion": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "libixloggerVersion": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "logOnTrigger": { "nullable": false, "type": "boolean" }, "alarming": { "nullable": false, "type": "boolean" }, "dataMonitoring": { "nullable": false, "type": "boolean" }, "wifi": { "nullable": false, "type": "boolean" }, "remoteFirmwareUpgrade": { "nullable": false, "type": "boolean" }, "staticMapping": { "nullable": false, "type": "boolean" }, "stewardConfigPush": { "nullable": false, "type": "boolean" }, "wanInterfaceEth0": { "nullable": false, "type": "boolean" }, "wanInterfaceWifi0": { "nullable": false, "type": "boolean" }, "wanInterfaceCell0": { "enum": [ "3G", "4G", "neither" ], "nullable": false, "type": "string" }, "multiWan": { "nullable": false, "type": "boolean" }, "openvpnVersion": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "openvpnOccEnabled": { "nullable": false, "type": "boolean" }, "openvpnOpensslVersion": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" } } }, "networkValues": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "interface": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "value": { "type": "array", "items": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" } } } } }, "networkReportedOn": { "nullable": true, "type": "string", "format": "date-time" }, "activeStatus": { "enum": [ "active", "inactive" ], "nullable": false, "type": "string" }, "activationLicence": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "type": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "usageType": { "enum": [ "advanced-user-management", "agent-registration-profile", "agent-templates", "alarming", "api-integrations", "app-engine-level-1", "app-engine-level-2", "app-engine-level-3", "asset-management", "beta-firmware", "card-view", "connection-monitoring", "controlled-devices", "custom-branding", "custom-domain", "custom-fields", "custom-legal", "custom-legal-legacy", "custom-sso", "disable-tags", "edge-app-management", "ixagent", "ixon-one", "landing-page", "live-data", "logging", "logging-devices", "m2m-cloud-cluster", "main-pages", "mobile-app", "mqtt-device", "object-storage", "premium-branding", "rdp", "remote-access", "reporting", "request-access", "rtsp", "scim", "session-recording", "site-console", "sla", "ssh", "subgroups", "temporary-access", "vpn-access-rule", "vpn-usage" ], "nullable": false, "type": "string" }, "companyLimit": { "maximum": 4294967295, "nullable": true, "type": "integer", "format": "int32" }, "scope": { "enum": [ "agent", "company" ], "nullable": false, "type": "string" } } }, "serialNumber": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "expiresOn": { "nullable": true, "type": "string", "format": "date-time" }, "activated": { "nullable": false, "type": "boolean" }, "trial": { "nullable": false, "type": "boolean" }, "value": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "actualValue": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "locked": { "nullable": true, "type": "boolean" }, "maxRetentionPolicy": { "maxLength": 255, "minLength": 2, "nullable": true, "type": "string" }, "bundle": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } } } }, "pendingRegistration": { "nullable": false, "type": "boolean" }, "card": { "nullable": true, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "activeVpnSession": { "nullable": true, "type": "object", "properties": { "rscServer": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "vpnRange": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "supportedLayers": { "type": "array", "items": { "enum": [ "tun", "tap" ], "nullable": false, "type": "string" } }, "location": { "nullable": false, "type": "object", "properties": { "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "latitude": { "nullable": false, "type": "string" }, "longitude": { "nullable": false, "type": "string" } } } } }, "startedOn": { "nullable": false, "type": "string", "format": "date-time" }, "sessionName": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "vpnAddress": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "closed": { "nullable": false, "type": "boolean" } } }, "webAccessConnections": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "user": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } }, "agentServer": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "type": { "enum": [ "http", "rdp", "rtsp", "ssh", "vnc", "websocket" ], "nullable": false, "type": "string" } } } } } }, "vpnChangedOn": { "nullable": true, "type": "string", "format": "date-time" }, "mdrServer": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } }, "mqttChangedOn": { "nullable": true, "type": "string", "format": "date-time" }, "loggingMdrServer": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } }, "loggingMqttChangedOn": { "nullable": true, "type": "string", "format": "date-time" }, "lsiServer": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } }, "company": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 24, "minLength": 24, "nullable": false, "pattern": "(\\d{4}-){4}\\d{4}", "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } }, "controlledBy": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 24, "minLength": 24, "nullable": false, "pattern": "(\\d{4}-){4}\\d{4}", "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } }, "vpnAudience": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "description": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "custom": { "nullable": false, "type": "object" }, "default": { "nullable": false, "type": "boolean" }, "type": { "enum": [ "alarm", "page", "service" ], "nullable": true, "type": "string" } } }, "vpnRequireAccessApproval": { "nullable": false, "type": "boolean" }, "vpnAccessRules": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "audience": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "ipAddress": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" }, "netMask": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" } } } }, "vpnVisibleInMobileApp": { "nullable": false, "type": "boolean" }, "vpnVisibleOnWeb": { "nullable": false, "type": "boolean" }, "dataAudience": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "description": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "custom": { "nullable": false, "type": "object" }, "default": { "nullable": false, "type": "boolean" }, "type": { "enum": [ "alarm", "page", "service" ], "nullable": true, "type": "string" } } }, "memberships": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "group": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } } } } }, "rateLimiting": { "nullable": false, "type": "object", "properties": { "configMqttCommandLimit": { "enum": [ "soft", "hard", "lock" ], "nullable": true, "type": "string" }, "configMqttCommandCounter": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "configMqttCommandLastHit": { "nullable": true, "type": "string", "format": "date-time" }, "configMqttDataLimit": { "enum": [ "soft", "hard", "lock" ], "nullable": true, "type": "string" }, "configMqttDataCounter": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "configMqttDataLastHit": { "nullable": true, "type": "string", "format": "date-time" }, "configOpenvpnLimit": { "enum": [ "soft", "hard", "lock" ], "nullable": true, "type": "string" }, "configOpenvpnCounter": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "configOpenvpnLastHit": { "nullable": true, "type": "string", "format": "date-time" } } }, "vpnProtocol": { "enum": [ "udp", "tcp" ], "nullable": false, "type": "string" }, "config": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "configFileServer": { "maxLength": 4294967295, "minLength": 0, "nullable": true, "type": "string" }, "configPushedOn": { "nullable": true, "type": "string", "format": "date-time" }, "configFileReported": { "maxLength": 4294967295, "minLength": 0, "nullable": true, "type": "string" }, "configFileReportedWlanKeyEnabled": { "nullable": false, "type": "boolean" }, "configFileReportedCellularPasswordEnabled": { "nullable": false, "type": "boolean" }, "configReportedOn": { "nullable": true, "type": "string", "format": "date-time" }, "differentConfigs": { "nullable": false, "type": "boolean" }, "differentWanConfigs": { "nullable": false, "type": "boolean" }, "stewardConfigFileServer": { "maxLength": 4294967295, "minLength": 0, "nullable": true, "type": "string" }, "stewardConfigFileReported": { "maxLength": 4294967295, "minLength": 0, "nullable": true, "type": "string" }, "stewardConfigReportedOn": { "nullable": true, "type": "string", "format": "date-time" }, "differentStewardConfigs": { "nullable": false, "type": "boolean" }, "lanNetworks": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "ipAddress": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" }, "ipNetmask": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" }, "dhcpStart": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "dhcpEnd": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" } } } }, "routerLan": { "nullable": false, "type": "object", "properties": { "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "ipAddress": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" }, "netMask": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" }, "network": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" }, "dhcpServerEnabled": { "nullable": false, "type": "boolean" }, "dhcpServerRangeFrom": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "dhcpServerRangeTo": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "gatewayLessRouting": { "nullable": false, "type": "boolean" }, "forwardLanWan": { "enum": [ "neither", "public", "private", "both" ], "nullable": false, "type": "string" }, "forwardLanWan2": { "enum": [ "neither", "public", "private", "both" ], "nullable": false, "type": "string" }, "wlanEnable": { "nullable": true, "type": "boolean" }, "wlanSsid": { "maxLength": 32, "minLength": 0, "nullable": true, "type": "string" }, "wlanKey": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "wlanChannel": { "maximum": 4294967295, "nullable": true, "type": "integer", "format": "int32" }, "bacnetBbmd": { "type": "array", "items": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" } }, "udpBroadcastRelayPort": { "type": "array", "items": { "maximum": 65535, "nullable": false, "type": "integer", "format": "int32" } } } }, "routerVpn": { "nullable": false, "type": "object", "properties": { "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "sourceNatEnabled": { "nullable": false, "type": "boolean" } } }, "routerWan": { "nullable": false, "type": "object", "properties": { "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "multiwanPolicy": { "enum": [ "eth_cell_wifi", "cell_eth_wifi", "eth_wifi_cell", "wifi_eth_cell", "cell_wifi_eth", "wifi_cell_eth" ], "nullable": true, "type": "string" }, "ipUseDhcp": { "nullable": true, "type": "boolean" }, "ipAddress": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "ipGateway": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "ipNetMask": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "dnsServers": { "type": "array", "items": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" } }, "dnsRebindProtectionEnabled": { "nullable": true, "type": "boolean" }, "cellularApn": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "cellularPincode": { "maxLength": 8, "minLength": 0, "nullable": true, "type": "string" }, "cellularMtu": { "maximum": 1500, "minimum": 576, "nullable": true, "type": "integer", "format": "int32" }, "digitalInputMode": { "enum": [ "disable_vpn_high", "disable_vpn_low", "disable_wan_high", "disable_wan_low" ], "nullable": true, "type": "string" }, "wanTrackInterval": { "maximum": 4294967295, "nullable": true, "type": "integer", "format": "int32" }, "wanTrackIps": { "type": "array", "items": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" } }, "wlanTrackInterval": { "maximum": 4294967295, "nullable": true, "type": "integer", "format": "int32" }, "wlanTrackIps": { "type": "array", "items": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" } }, "cellularTrackInterval": { "maximum": 4294967295, "nullable": true, "type": "integer", "format": "int32" }, "cellularTrackIps": { "type": "array", "items": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" } }, "httpProxyAddress": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "httpProxyPort": { "maximum": 4294967295, "nullable": true, "type": "integer", "format": "int32" }, "httpProxyAuthentication": { "enum": [ "none", "basic", "ntlm" ], "nullable": true, "type": "string" }, "httpProxyUsername": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "httpProxyIsSocks5": { "nullable": true, "type": "boolean" }, "wlanSsid": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "wlanIpUseDhcp": { "nullable": true, "type": "boolean" }, "wlanIpAddress": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "wlanIpGateway": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "wlanIpNetMask": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "wlanDnsServers": { "type": "array", "items": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" } }, "cellularUsername": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" } } }, "routerDisplay": { "nullable": false, "type": "object", "properties": { "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "lockEnabled": { "nullable": false, "type": "boolean" }, "lockCode": { "maxLength": 4, "minLength": 4, "nullable": true, "pattern": "[0-9]+", "type": "string" } } }, "routerAdditionalSubnets": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "networkAddress": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" }, "networkMask": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" }, "gatewayAddress": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" }, "gatewayDevice": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } } } } }, "routerPortForwards": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "interface": { "enum": [ "VPN", "WAN", "WAN2" ], "nullable": false, "type": "string" }, "targetIpAddress": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" }, "targetPort": { "maximum": 65535, "nullable": false, "type": "integer", "format": "int32" }, "externalPort": { "maximum": 65535, "nullable": false, "type": "integer", "format": "int32" }, "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } } } } }, "routerNtpServers": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "server": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } } } } }, "demoDevice": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "expiresOn": { "nullable": false, "type": "string", "format": "date-time" }, "agentType": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "additionalSubnets": { "nullable": false, "type": "boolean" }, "allowDataPublishing": { "nullable": false, "type": "boolean" }, "allowDemoDevice": { "nullable": false, "type": "boolean" }, "allowTemplating": { "nullable": false, "type": "boolean" }, "allowReboot": { "nullable": false, "type": "boolean" }, "configPush": { "nullable": false, "type": "boolean" }, "configFileFormat": { "maximum": 4294967295, "nullable": false, "type": "integer", "format": "int32" }, "customServers": { "nullable": false, "type": "boolean" }, "deviceIdFormat": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "httpProxyPort": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "latestFirmwareFile": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "description": { "maxLength": 65535, "minLength": 0, "nullable": false, "type": "string" }, "code": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "releaseStage": { "enum": [ "alpha", "beta", "rc", "ga" ], "nullable": false, "type": "string" }, "releaseDate": { "nullable": true, "type": "string", "format": "date" }, "notes": { "maxLength": 65535, "minLength": 0, "nullable": false, "type": "string" }, "agentType": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "type": { "enum": [ "firmware" ], "nullable": false, "type": "string" }, "latest": { "nullable": false, "type": "boolean" }, "custom": { "nullable": false, "type": "object" } } }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "offlineConfiguration": { "nullable": false, "type": "boolean" }, "openvpnConfigMultiUse": { "nullable": false, "type": "boolean" }, "purchasePrice": { "nullable": false, "type": "object", "properties": { "gratis": { "nullable": false, "type": "boolean" } } }, "router": { "nullable": false, "type": "boolean" }, "stunnelSupport": { "nullable": false, "type": "boolean" }, "wanPortForwardings": { "nullable": false, "type": "boolean" }, "custom": { "nullable": false, "type": "object" }, "hasSecondWanPort": { "nullable": false, "type": "boolean" } } }, "dmvServer": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } } } }, "connectedUsers": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } } }, "hasLoggingConfigured": { "nullable": false, "type": "boolean" }, "loggingApp": { "nullable": false, "type": "object", "properties": { "licence": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "type": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "usageType": { "enum": [ "advanced-user-management", "agent-registration-profile", "agent-templates", "alarming", "api-integrations", "app-engine-level-1", "app-engine-level-2", "app-engine-level-3", "asset-management", "beta-firmware", "card-view", "connection-monitoring", "controlled-devices", "custom-branding", "custom-domain", "custom-fields", "custom-legal", "custom-legal-legacy", "custom-sso", "disable-tags", "edge-app-management", "ixagent", "ixon-one", "landing-page", "live-data", "logging", "logging-devices", "m2m-cloud-cluster", "main-pages", "mobile-app", "mqtt-device", "object-storage", "premium-branding", "rdp", "remote-access", "reporting", "request-access", "rtsp", "scim", "session-recording", "site-console", "sla", "ssh", "subgroups", "temporary-access", "vpn-access-rule", "vpn-usage" ], "nullable": false, "type": "string" }, "companyLimit": { "maximum": 4294967295, "nullable": true, "type": "integer", "format": "int32" }, "scope": { "enum": [ "agent", "company" ], "nullable": false, "type": "string" } } }, "serialNumber": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "expiresOn": { "nullable": true, "type": "string", "format": "date-time" }, "activated": { "nullable": false, "type": "boolean" }, "trial": { "nullable": false, "type": "boolean" }, "value": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "actualValue": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "locked": { "nullable": true, "type": "boolean" }, "maxRetentionPolicy": { "maxLength": 255, "minLength": 2, "nullable": true, "type": "string" }, "agent": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "deviceId": { "maxLength": 128, "minLength": 1, "nullable": false, "type": "string" }, "type": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "location": { "nullable": false, "type": "object", "properties": { "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "latitude": { "nullable": false, "type": "string" }, "longitude": { "nullable": false, "type": "string" } } }, "geoLocation": { "nullable": false, "type": "object", "properties": { "latitude": { "nullable": false, "type": "string" }, "longitude": { "nullable": false, "type": "string" }, "country": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "city": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } }, "custom": { "nullable": false, "type": "object" } } }, "hasAgent": { "nullable": false, "type": "boolean" }, "agentType": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "additionalSubnets": { "nullable": false, "type": "boolean" }, "allowDataPublishing": { "nullable": false, "type": "boolean" }, "allowDemoDevice": { "nullable": false, "type": "boolean" }, "allowTemplating": { "nullable": false, "type": "boolean" }, "allowReboot": { "nullable": false, "type": "boolean" }, "configPush": { "nullable": false, "type": "boolean" }, "configFileFormat": { "maximum": 4294967295, "nullable": false, "type": "integer", "format": "int32" }, "customServers": { "nullable": false, "type": "boolean" }, "deviceIdFormat": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "httpProxyPort": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "latestFirmwareFile": { "nullable": false, "type": "object" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "offlineConfiguration": { "nullable": false, "type": "boolean" }, "openvpnConfigMultiUse": { "nullable": false, "type": "boolean" }, "purchasePrice": { "nullable": false, "type": "object" }, "router": { "nullable": false, "type": "boolean" }, "stunnelSupport": { "nullable": false, "type": "boolean" }, "wanPortForwardings": { "nullable": false, "type": "boolean" }, "custom": { "nullable": false, "type": "object" }, "hasSecondWanPort": { "nullable": false, "type": "boolean" } } }, "bundle": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } } } }, "enabled": { "nullable": false, "type": "boolean" } } }, "valuesPerHour": { "maximum": 4294967295, "nullable": false, "type": "integer", "format": "int32" }, "alarmingApp": { "nullable": false, "type": "object", "properties": { "licence": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "type": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "usageType": { "enum": [ "advanced-user-management", "agent-registration-profile", "agent-templates", "alarming", "api-integrations", "app-engine-level-1", "app-engine-level-2", "app-engine-level-3", "asset-management", "beta-firmware", "card-view", "connection-monitoring", "controlled-devices", "custom-branding", "custom-domain", "custom-fields", "custom-legal", "custom-legal-legacy", "custom-sso", "disable-tags", "edge-app-management", "ixagent", "ixon-one", "landing-page", "live-data", "logging", "logging-devices", "m2m-cloud-cluster", "main-pages", "mobile-app", "mqtt-device", "object-storage", "premium-branding", "rdp", "remote-access", "reporting", "request-access", "rtsp", "scim", "session-recording", "site-console", "sla", "ssh", "subgroups", "temporary-access", "vpn-access-rule", "vpn-usage" ], "nullable": false, "type": "string" }, "companyLimit": { "maximum": 4294967295, "nullable": true, "type": "integer", "format": "int32" }, "scope": { "enum": [ "agent", "company" ], "nullable": false, "type": "string" } } }, "serialNumber": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "expiresOn": { "nullable": true, "type": "string", "format": "date-time" }, "activated": { "nullable": false, "type": "boolean" }, "trial": { "nullable": false, "type": "boolean" }, "value": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "actualValue": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "locked": { "nullable": true, "type": "boolean" }, "maxRetentionPolicy": { "maxLength": 255, "minLength": 2, "nullable": true, "type": "string" }, "agent": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "deviceId": { "maxLength": 128, "minLength": 1, "nullable": false, "type": "string" }, "type": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "location": { "nullable": false, "type": "object", "properties": { "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "latitude": { "nullable": false, "type": "string" }, "longitude": { "nullable": false, "type": "string" } } }, "geoLocation": { "nullable": false, "type": "object", "properties": { "latitude": { "nullable": false, "type": "string" }, "longitude": { "nullable": false, "type": "string" }, "country": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "city": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } }, "custom": { "nullable": false, "type": "object" } } }, "hasAgent": { "nullable": false, "type": "boolean" }, "agentType": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "additionalSubnets": { "nullable": false, "type": "boolean" }, "allowDataPublishing": { "nullable": false, "type": "boolean" }, "allowDemoDevice": { "nullable": false, "type": "boolean" }, "allowTemplating": { "nullable": false, "type": "boolean" }, "allowReboot": { "nullable": false, "type": "boolean" }, "configPush": { "nullable": false, "type": "boolean" }, "configFileFormat": { "maximum": 4294967295, "nullable": false, "type": "integer", "format": "int32" }, "customServers": { "nullable": false, "type": "boolean" }, "deviceIdFormat": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "httpProxyPort": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "latestFirmwareFile": { "nullable": false, "type": "object" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "offlineConfiguration": { "nullable": false, "type": "boolean" }, "openvpnConfigMultiUse": { "nullable": false, "type": "boolean" }, "purchasePrice": { "nullable": false, "type": "object" }, "router": { "nullable": false, "type": "boolean" }, "stunnelSupport": { "nullable": false, "type": "boolean" }, "wanPortForwardings": { "nullable": false, "type": "boolean" }, "custom": { "nullable": false, "type": "object" }, "hasSecondWanPort": { "nullable": false, "type": "boolean" } } }, "bundle": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } } } }, "enabled": { "nullable": false, "type": "boolean" } } }, "lanWanAccessRules": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "sourceIpAddress": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "sourceMacAddress": { "maxLength": 17, "minLength": 17, "nullable": true, "pattern": "[0-9a-fA-F]{2}(:[0-9a-fA-F]{2}){5}", "type": "string" }, "destinationPort": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "destinationIpAddress": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "protocol": { "enum": [ "all", "tcp", "udp", "icmp", "ah", "ax.25", "dccp", "ddp", "egp", "eigrp", "encap", "esp", "etherip", "fc", "ggp", "gre", "hmp", "idpr-cmtp", "idrp", "igmp", "igp", "ipcomp", "ipencap", "ipip", "ipv6", "ipv6-frag", "ipv6-icmp", "ipv6-nonxt", "ipv6-opts", "ipv6-route", "isis", "iso-tp4", "l2tp", "ospf", "pim", "pup", "rdp", "rspf", "rsvp", "sctp", "skip", "st", "vmtp", "vrrp", "xns-idp", "xtp" ], "nullable": false, "type": "string" }, "description": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" } } } }, "oneToOneNatRules": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "type": { "enum": [ "wan", "wlan", "vpn" ], "nullable": false, "type": "string" }, "virtualIpAddress": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" }, "destinationIpAddress": { "maxLength": 255, "minLength": 0, "nullable": false, "type": "string" }, "protocol": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "port": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "sourceIpAddress": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "description": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" } } } }, "devices": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "ipAddress": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "macAddress": { "maxLength": 17, "minLength": 17, "nullable": true, "pattern": "[0-9a-fA-F]{2}(:[0-9a-fA-F]{2}){5}", "type": "string" }, "customAddress": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "dataSources": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "continueLoggingOnError": { "nullable": true, "type": "boolean" }, "device": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "gracePeriod": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "slug": { "maxLength": 64, "minLength": 1, "nullable": false, "pattern": "^[a-zA-Z0-9_\\[\\]-]+$", "type": "string" }, "disabled": { "nullable": false, "type": "boolean" }, "protocol": { "oneOf": [ { "type": "object", "properties": { "publicId": { "enum": [ "custom" ], "nullable": false, "type": "string" }, "password": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } }, "required": [ "publicId", "password" ] }, { "type": "object", "properties": { "publicId": { "enum": [ "modbus" ], "nullable": false, "type": "string" }, "slave": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "format": { "enum": [ "ABCD", "BADC", "CDAB", "DCBA" ], "nullable": true, "type": "string" }, "readMode": { "enum": [ "single_value", "consecutive_values", "gapped_values" ], "nullable": true, "type": "string" } }, "required": [ "publicId" ] }, { "type": "object", "properties": { "publicId": { "enum": [ "siemens-step7" ], "nullable": false, "type": "string" }, "pdu": { "maximum": 2147483647, "minimum": -2147483648, "nullable": true, "type": "integer", "format": "int32" }, "rack": { "maximum": 7, "nullable": true, "type": "integer", "format": "int32" }, "slot": { "maximum": 31, "nullable": true, "type": "integer", "format": "int32" } }, "required": [ "publicId" ] }, { "type": "object", "properties": { "publicId": { "enum": [ "opc-ua" ], "nullable": false, "type": "string" }, "authenticationType": { "enum": [ "anonymous", "username", "certificate" ], "nullable": false, "type": "string" }, "username": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "password": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "securityMode": { "enum": [ "sign", "signandencrypt" ], "nullable": true, "type": "string" }, "securityPolicy": { "enum": [ "basic256sha256", "aes128_sha256_rsaoaep", "aes256_sha256_rsapss" ], "nullable": true, "type": "string" } }, "required": [ "publicId", "authenticationType" ] }, { "type": "object", "properties": { "publicId": { "enum": [ "ethernet-ip" ], "nullable": false, "type": "string" }, "cpu": { "enum": [ "compactlogix", "micro800", "micrologix", "micrologix800", "omron" ], "nullable": false, "type": "string" }, "rack": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "slot": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" } }, "required": [ "publicId", "cpu" ] }, { "type": "object", "properties": { "publicId": { "enum": [ "host" ], "nullable": false, "type": "string" } }, "required": [ "publicId" ] }, { "type": "object", "properties": { "publicId": { "enum": [ "bacnet-ip" ], "nullable": false, "type": "string" }, "deviceId": { "maximum": 4194302, "nullable": true, "type": "integer", "format": "int32" } }, "required": [ "publicId" ] }, { "type": "object", "properties": { "publicId": { "enum": [ "mc-protocol" ], "nullable": false, "type": "string" }, "cpu": { "enum": [ "FX5U", "IQR", "L", "Q", "QNUCPU" ], "nullable": true, "type": "string" }, "protocol": { "enum": [ "TCP", "UDP" ], "nullable": true, "type": "string" }, "networkNo": { "maximum": 255, "nullable": true, "type": "integer", "format": "int32" }, "pcNo": { "maxLength": 2, "minLength": 1, "nullable": true, "pattern": "[A-Za-z0-9]+", "type": "string" }, "requestDestIoNr": { "maxLength": 4, "minLength": 1, "nullable": true, "pattern": "[A-Za-z0-9]+", "type": "string" }, "requestDestModuleStatNr": { "maximum": 255, "nullable": true, "type": "integer", "format": "int32" }, "authenticationType": { "enum": [ "none", "password" ], "nullable": true, "type": "string" }, "password": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "reconnectDelay": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "maxBlocks": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "maxPoints": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" } }, "required": [ "publicId" ] } ] }, "port": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "pullDelay": { "maximum": 4294967295, "nullable": true, "type": "integer", "format": "int32" }, "valuesPerHour": { "maximum": 4294967295, "nullable": false, "type": "integer", "format": "int32" }, "tagCount": { "maximum": 4294967295, "nullable": false, "type": "integer", "format": "int32" }, "variableCount": { "maximum": 4294967295, "nullable": false, "type": "integer", "format": "int32" }, "mqttTopic": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "mqttBrokerClient": { "nullable": true, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } } } } }, "lanNetwork": { "nullable": true, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } } } } }, "servers": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "type": { "enum": [ "http", "rdp", "rtsp", "ssh", "vnc", "websocket" ], "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "port": { "maximum": 65535, "nullable": false, "type": "integer", "format": "int32" }, "usePersonalAccount": { "nullable": true, "type": "boolean" }, "username": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "password": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "hasPassword": { "nullable": false, "type": "boolean" }, "authDomain": { "maxLength": 15, "minLength": 0, "nullable": true, "pattern": "[a-zA-Z0-9][a-zA-Z0-9._-]{0,14}", "type": "string" }, "landingPage": { "maxLength": 255, "minLength": 1, "nullable": true, "pattern": "/.*", "type": "string" }, "connectionQuality": { "enum": [ "low", "normal", "high" ], "nullable": true, "type": "string" }, "readOnly": { "nullable": true, "type": "boolean" }, "vncRightClickOnTouchHold": { "nullable": false, "type": "boolean" }, "vncEncoding": { "enum": [ "copyrect", "corre", "hextile", "raw", "rre", "tight", "ultra", "ultrazip", "zlib", "zlibhex", "zrle", "zywrle" ], "nullable": true, "type": "string" }, "useSsl": { "nullable": false, "type": "boolean" }, "visibleInMobileApp": { "nullable": false, "type": "boolean" }, "visibleOnWeb": { "nullable": false, "type": "boolean" }, "httpAuthenticationType": { "enum": [ "ntlm", "basic", "digest" ], "nullable": true, "type": "string" }, "flags": { "type": "array", "items": { "enum": [ "enable-wallpaper", "enable-theming", "enable-font-smoothing", "enable-full-window-drag", "enable-desktop-composition", "enable-menu-animations", "disable-bitmap-caching", "disable-offscreen-caching", "disable-glyph-caching", "disable-gfx" ], "nullable": false, "type": "string" } }, "fileTransferEnabled": { "nullable": true, "type": "boolean" }, "recordSessions": { "nullable": true, "type": "boolean" }, "audience": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "requireAccessApproval": { "nullable": false, "type": "boolean" }, "custom": { "nullable": false, "type": "object" }, "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "device": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "serviceGroup": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "template": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "type": { "enum": [ "http", "rdp", "rtsp", "ssh", "vnc", "websocket" ], "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "port": { "maximum": 65535, "nullable": false, "type": "integer", "format": "int32" }, "usePersonalAccount": { "nullable": true, "type": "boolean" }, "username": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "password": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "hasPassword": { "nullable": false, "type": "boolean" }, "authDomain": { "maxLength": 15, "minLength": 0, "nullable": true, "pattern": "[a-zA-Z0-9][a-zA-Z0-9._-]{0,14}", "type": "string" }, "landingPage": { "maxLength": 255, "minLength": 1, "nullable": true, "pattern": "/.*", "type": "string" }, "connectionQuality": { "enum": [ "low", "normal", "high" ], "nullable": true, "type": "string" }, "readOnly": { "nullable": true, "type": "boolean" }, "vncRightClickOnTouchHold": { "nullable": false, "type": "boolean" }, "vncEncoding": { "enum": [ "copyrect", "corre", "hextile", "raw", "rre", "tight", "ultra", "ultrazip", "zlib", "zlibhex", "zrle", "zywrle" ], "nullable": true, "type": "string" }, "useSsl": { "nullable": false, "type": "boolean" }, "visibleInMobileApp": { "nullable": false, "type": "boolean" }, "visibleOnWeb": { "nullable": false, "type": "boolean" }, "httpAuthenticationType": { "enum": [ "ntlm", "basic", "digest" ], "nullable": true, "type": "string" }, "flags": { "type": "array", "items": { "enum": [ "enable-wallpaper", "enable-theming", "enable-font-smoothing", "enable-full-window-drag", "enable-desktop-composition", "enable-menu-animations", "disable-bitmap-caching", "disable-offscreen-caching", "disable-glyph-caching", "disable-gfx" ], "nullable": false, "type": "string" } }, "fileTransferEnabled": { "nullable": true, "type": "boolean" }, "recordSessions": { "nullable": true, "type": "boolean" }, "audience": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "requireAccessApproval": { "nullable": false, "type": "boolean" }, "custom": { "nullable": false, "type": "object" } } } } } }, "dataSources": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "continueLoggingOnError": { "nullable": true, "type": "boolean" }, "device": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "gracePeriod": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "slug": { "maxLength": 64, "minLength": 1, "nullable": false, "pattern": "^[a-zA-Z0-9_\\[\\]-]+$", "type": "string" }, "disabled": { "nullable": false, "type": "boolean" }, "protocol": { "oneOf": [ { "type": "object", "properties": { "publicId": { "enum": [ "custom" ], "nullable": false, "type": "string" }, "password": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } }, "required": [ "publicId", "password" ] }, { "type": "object", "properties": { "publicId": { "enum": [ "modbus" ], "nullable": false, "type": "string" }, "slave": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "format": { "enum": [ "ABCD", "BADC", "CDAB", "DCBA" ], "nullable": true, "type": "string" }, "readMode": { "enum": [ "single_value", "consecutive_values", "gapped_values" ], "nullable": true, "type": "string" } }, "required": [ "publicId" ] }, { "type": "object", "properties": { "publicId": { "enum": [ "siemens-step7" ], "nullable": false, "type": "string" }, "pdu": { "maximum": 2147483647, "minimum": -2147483648, "nullable": true, "type": "integer", "format": "int32" }, "rack": { "maximum": 7, "nullable": true, "type": "integer", "format": "int32" }, "slot": { "maximum": 31, "nullable": true, "type": "integer", "format": "int32" } }, "required": [ "publicId" ] }, { "type": "object", "properties": { "publicId": { "enum": [ "opc-ua" ], "nullable": false, "type": "string" }, "authenticationType": { "enum": [ "anonymous", "username", "certificate" ], "nullable": false, "type": "string" }, "username": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "password": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "securityMode": { "enum": [ "sign", "signandencrypt" ], "nullable": true, "type": "string" }, "securityPolicy": { "enum": [ "basic256sha256", "aes128_sha256_rsaoaep", "aes256_sha256_rsapss" ], "nullable": true, "type": "string" } }, "required": [ "publicId", "authenticationType" ] }, { "type": "object", "properties": { "publicId": { "enum": [ "ethernet-ip" ], "nullable": false, "type": "string" }, "cpu": { "enum": [ "compactlogix", "micro800", "micrologix", "micrologix800", "omron" ], "nullable": false, "type": "string" }, "rack": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "slot": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" } }, "required": [ "publicId", "cpu" ] }, { "type": "object", "properties": { "publicId": { "enum": [ "host" ], "nullable": false, "type": "string" } }, "required": [ "publicId" ] }, { "type": "object", "properties": { "publicId": { "enum": [ "bacnet-ip" ], "nullable": false, "type": "string" }, "deviceId": { "maximum": 4194302, "nullable": true, "type": "integer", "format": "int32" } }, "required": [ "publicId" ] }, { "type": "object", "properties": { "publicId": { "enum": [ "mc-protocol" ], "nullable": false, "type": "string" }, "cpu": { "enum": [ "FX5U", "IQR", "L", "Q", "QNUCPU" ], "nullable": true, "type": "string" }, "protocol": { "enum": [ "TCP", "UDP" ], "nullable": true, "type": "string" }, "networkNo": { "maximum": 255, "nullable": true, "type": "integer", "format": "int32" }, "pcNo": { "maxLength": 2, "minLength": 1, "nullable": true, "pattern": "[A-Za-z0-9]+", "type": "string" }, "requestDestIoNr": { "maxLength": 4, "minLength": 1, "nullable": true, "pattern": "[A-Za-z0-9]+", "type": "string" }, "requestDestModuleStatNr": { "maximum": 255, "nullable": true, "type": "integer", "format": "int32" }, "authenticationType": { "enum": [ "none", "password" ], "nullable": true, "type": "string" }, "password": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "reconnectDelay": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "maxBlocks": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "maxPoints": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" } }, "required": [ "publicId" ] } ] }, "port": { "maximum": 65535, "nullable": true, "type": "integer", "format": "int32" }, "pullDelay": { "maximum": 4294967295, "nullable": true, "type": "integer", "format": "int32" }, "valuesPerHour": { "maximum": 4294967295, "nullable": false, "type": "integer", "format": "int32" }, "tagCount": { "maximum": 4294967295, "nullable": false, "type": "integer", "format": "int32" }, "variableCount": { "maximum": 4294967295, "nullable": false, "type": "integer", "format": "int32" }, "mqttTopic": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "mqttBrokerClient": { "nullable": true, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } } } } }, "pageLinks": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "agent": { "nullable": true, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "asset": { "nullable": true, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "menuItem": { "nullable": true, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "page": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "audience": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "description": { "maxLength": 255, "minLength": 0, "nullable": true, "type": "string" }, "custom": { "nullable": false, "type": "object" }, "default": { "nullable": false, "type": "boolean" }, "type": { "enum": [ "alarm", "page", "service" ], "nullable": true, "type": "string" } } }, "group": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "agent": { "nullable": true, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "asset": { "nullable": true, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "menuItem": { "nullable": true, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } }, "order": { "maximum": 9223372036854776000, "minimum": -9223372036854776000, "nullable": false, "type": "integer", "format": "int32" }, "custom": { "nullable": false, "type": "object" } } } }, "scheduledAccessRequests": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "agent": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "user": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } }, "approver": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } }, "approverCompany": { "nullable": true, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "vpn": { "nullable": false, "type": "boolean" }, "servers": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" }, "type": { "enum": [ "http", "rdp", "rtsp", "ssh", "vnc", "websocket" ], "nullable": false, "type": "string" } } } }, "start": { "nullable": false, "type": "string", "format": "date-time" }, "end": { "nullable": false, "type": "string", "format": "date-time" }, "status": { "enum": [ "approved", "pending", "rejected", "revoked" ], "nullable": false, "type": "string" }, "reason": { "maxLength": 65535, "minLength": 0, "nullable": false, "type": "string" }, "createdOn": { "nullable": false, "type": "string", "format": "date-time" }, "updatedOn": { "nullable": true, "type": "string", "format": "date-time" }, "allowedApprovers": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } } }, "reviewExpiresOn": { "nullable": true, "type": "string", "format": "date-time" } } } }, "assets": { "type": "array", "items": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } } }, "registrationProfile": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 24, "minLength": 24, "nullable": false, "pattern": "(\\d{4}-){4}\\d{4}", "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" }, "agentActivationName": { "maxLength": 255, "minLength": 1, "nullable": true, "type": "string" } } }, "vpnLocked": { "nullable": false, "type": "boolean" }, "webAccessLocked": { "nullable": false, "type": "boolean" }, "configPushLocked": { "nullable": false, "type": "boolean" }, "rebootLocked": { "nullable": false, "type": "boolean" }, "firmwareUpdateLocked": { "nullable": false, "type": "boolean" }, "appliedTemplateVersion": { "nullable": true, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "createdOn": { "nullable": false, "type": "string", "format": "date-time" }, "createdBy": { "nullable": false, "type": "object", "properties": { "publicId": { "maxLength": 12, "minLength": 12, "nullable": false, "type": "string" }, "name": { "maxLength": 255, "minLength": 1, "nullable": false, "type": "string" } } }, "company": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "description": { "maxLength": 65535, "minLength": 0, "nullable": true, "type": "string" }, "agentTemplate": { "nullable": false, "type": "object", "properties": { "publicId": { "nullable": false, "type": "string" } } }, "number": { "maxLength": 64, "minLength": 1, "nullable": false, "type": "string" } } } } } } } } } }, "4XX": { "$ref": "#/components/responses/4XXErrorResponse" } }, "parameters": [ { "$ref": "#/components/parameters/apiVersion" }, { "$ref": "#/components/parameters/apiApplication" }, { "$ref": "#/components/parameters/apiCompany" }, { "$ref": "#/components/parameters/apiBrandingOptional" }, { "$ref": "#/components/parameters/fieldsParameter" }, { "$ref": "#/components/parameters/filtersParameter" }, { "required": true, "name": "publicId", "in": "path", "schema": { "type": "string" } } ], "security": [ { "bearerToken": [] } ] } } }, "components": { "parameters": { "apiVersion": { "required": true, "description": "Version of the API to use", "name": "Api-Version", "in": "header", "schema": { "type": "integer", "format": "int32", "enum": [ 2 ] } }, "apiApplication": { "required": true, "description": "Get your Application ID by creating a Service Account in the IXON Cloud.", "name": "Api-Application", "in": "header", "schema": { "type": "string", "pattern": "^[0-9a-zA-Z]{12}$" } }, "apiCompany": { "required": true, "description": "PublicId of the company", "name": "Api-Company", "in": "header", "schema": { "type": "string", "pattern": "^(\\d{4}-){4}\\d{4}$" } }, "apiBrandingOptional": { "required": false, "description": "Domain that provides the branding", "name": "Api-Branding", "in": "header", "schema": { "type": "string", "pattern": ".+(\\..[^.]+)" } }, "fieldsParameter": { "required": false, "description": "Fields to select. Use \"*\" for all the top-level fields. Or check the \"Success response\" below for other fields.\n\nTo get the fields of a subresource do subresource.field or for multiple fields of one subresource do subresource(field,field)", "name": "fields", "in": "query", "schema": { "type": "array", "items": { "type": "string" } } }, "filtersParameter": { "required": false, "description": "Filter the returned item(s). Format: operator(column,val)\n\nPossible operators are: lt, less, lte, lessorequal, eq, equals, ne, differs, gt, greater, gte, greaterorequal, in, ni, isnull, isnotnull, between, contains.\n\nExample: eq(publicId,\"publicId_val\")", "name": "filters", "in": "query", "schema": { "type": "array", "items": { "type": "string" } } } }, "responses": { "4XXErrorResponse": { "description": "4XX error response", "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "type", "data" ], "properties": { "status": { "type": "string", "default": "error", "nullable": false }, "type": { "type": "string", "default": "Error", "nullable": false }, "data": { "nullable": false, "type": "array", "items": { "$ref": "#/components/schemas/4XXErrorSchema" } } } } } } } }, "schemas": { "4XXErrorSchema": { "type": "object", "properties": { "message": { "nullable": false, "type": "string" }, "propertyName": { "nullable": true, "type": "string" }, "listIndex": { "nullable": true, "type": "integer", "format": "int32" } }, "required": [ "message" ] } }, "securitySchemes": { "bearerToken": { "type": "http", "description": "Get your Bearer Token by creating a Service Account in the IXON Cloud.", "scheme": "bearer" } } }, "x-samples-languages": [ "curl", "ruby", "javascript", "python", "powershell" ] } ```