Overview
Input types are structured objects passed as arguments to queries. For example, MetricsFilterInput lets you specify a time range and aggregation interval when querying metrics.
Input type for specifying options when querying active clients metrics.
Field Type Description includeMeterHardwareBoolean Whether to include Meter hardware in the metrics calculation.
Input type for adding a network to an AutoVPN group.
Field Type Description networkUUIDUUID !Unique identifier of the network to add as a member. permittedVLANUUIDs[UUID !] List of permitted VLAN unique identifiers. The associated VLANs must have participatesInVPNs set to true. phyInterfaceUUIDUUID !Unique identifier of the physical interface used by the member's uplink.
Input type for specifying filters when querying all client metrics timeseries data.
Field Type Description timeFilterMetricsFilterInput !Specify the time range for the timeseries data.
BoolFilter
Field Type Description keyString !The key for the filter. valueBoolean !Boolean value for the filter.
CaptivePortalEntryFilterInput
Field Type Description ipAddressIP Filter captive portal entries by IP address. limitInt !The maximum number of captive portal entries to return. macAddressMacAddress Filter captive portal entries by MAC address. maxCreatedAtDateTime Only include captive portal entries that were created before or at this date and time. minCreatedAtDateTime Only include captive portal entries that were created at or after this date and time. offsetInt !The number of captive portal entries to skip before starting to collect the result set.
Field Type Description timeFilterMetricsFilterInput !Specify the time range for the timeseries data.
Input type for specifying filters when querying client metrics timeseries data.
Field Type Description bands[RadioBand !] Specifying this field returns only metrics observed for the given radio band(s). channels[Int !] Specifying this field returns only metrics observed for the given radio channel(s). clientMacAddresses[MacAddress !] Filter events by client MAC address. eventTypes[WirelessClientConnectionEventType !] Filter events by event type(s). excludeObserversBoolean If true, exclude events from Observers. identity8021XString Filter events whose 802.1X identity contains the given string (case-insensitive). isNACEventBoolean Filter events by whether they are NAC events. true returns only NAC events, false returns only non-NAC events, and omitting the field returns both. partialClientMacAddresses[String !] Filter events by partial client MAC address. reasonCodes[Int !] Filter events by 802.11 reason code(s). rssiNumberRangeInput Filter events by RSSI. ssidUUIDs[UUID !] Specifying this field returns only metrics observed for the given SSID(s), by UUID. timeFilterMetricsFilterInput !Specify the time range for the timeseries data. virtualDeviceUUIDs[UUID !] Filter events by virtual device.
Filters the list of networks for a single company
Field Type Description networkUUIDs[UUID !] Filter networks using their UUIDs.
Field Type Description actionFirewallRuleAction !The action to take when the rule is matched. applicationIDInt The ID of the Netstar application to associate with the rule. boundDHCPRuleUUIDs[UUID !]! List of UUIDs of DHCP rules to which the application DNS firewall rule is bound. categoryIDInt The ID of the Netstar category to associate with the rule. domainString The domain or FQDN that is matched by the rule, allowing for wildcards denoted by '*'. groupIDInt The ID of the Netstar group to associate with the rule. isEnabledBoolean !Indicates whether the rule is enabled; defaults to true. nameString !The name of the DNS firewall rule. priorityInt The priority of the rule; if not provided, will default to 1 greater than the highest existing priority.
Input parameters for creating a Client VPN client.
Field Type Description emailString !End user's company email associated with the VPN server's controller. isEnabledBoolean !Whether the client is enabled. If false, users will not be able to connect using this client's key. nameString !End user's device name, e.g., 'paulmbp'. publicKeyString !A Curve25519 public key generated by the end user using WireGuard.
Input type for creating a new firewall rule.
Field Type Description actionFirewallRuleAction !The action to take when the firewall rule matches (e.g., DENY or PERMIT). boundPhyInterfaceUUIDs[UUID !]! List of UUIDs of physical interfaces to which the firewall rule is bound. The physical interfaces must be uplinks. boundVLANUUIDs[UUID !]! List of UUIDs of VLANs to which the firewall rule is bound. descriptionString A description of the firewall rule. dstPortRanges[PortRangeInput !] List of destination port ranges to match traffic to. dstPrefixes[IPPrefix !] Destination IP prefixes to match traffic to. dstVLANUUIDUUID UUID of the destination VLAN to match traffic to. isEnabledBoolean !Indicates if the firewall rule is currently enabled. nameString !The name of the firewall rule. priorityInt Priority of the rule within the network, lower priority rules are applied first. If there is an existing rule with the provided value, it and all subsequent occupied values will be incremented. If omitted, next lowest priority in network will be used. protocols[IPProtocol !] List of IP protocols to match. srcPortRanges[PortRangeInput !] List of source port ranges to match traffic from. srcPrefixes[IPPrefix !] Source IP prefixes to match traffic from. tags[String !] List of tags associated with the firewall rule.
Field Type Description enabledVLANUUIDs[UUID !]! VLANs to enable IDS/IPS for. ipsRuleDurationDuration How long rules generated by IPS stay valid. isEastWestProtectionEnabledBoolean !If east-west protection is enabled. minIPSSeverityInt The IPS minimum severity to act on. minSeverityInt !The IDS minimum severity to act on. modeIDSIPSMode !The mode IDS/IPS should act in. safelist[IPPrefix !] List of subnets that should never be blocked.
A custom intrusion rule definition for IDS/IPS. These currently apply tls.sni rules.
Field Type Description actionFirewallRuleAction !The action this rule applies. applicationIDInt The ID of the Netstar application to associate with the rule. boundVLANUUIDs[UUID !]! List of UUIDs of VLANs to which the rule is bound. domainString The FQDN this rule applies to. isEnabledBoolean !If this rule is enabled. nameString !A name to identify this rule.
Field Type Description descriptionString Description of the SSID. encryptionProtocolSSIDEncryptionProtocol Encryption protocol used by the SSID. isBand2GAllowedBoolean !Enable or disable broadcasting the SSID on the 2.4 GHz band. isBand5GAllowedBoolean !Enable or disable broadcasting the SSID on the 5 GHz band. isBand6GAllowedBoolean !Enable or disable broadcasting the SSID on the 6 GHz band. isEnabledBoolean !Enable or disable the SSID. isEnabledForAllAccessPointsBoolean !Enable the SSID for all access points or only specified ones. isGuestBoolean !Mark the SSID as a guest network. isHiddenBoolean !Hide the SSID from being broadcasted. isIsolateClientsEnabledBoolean !Enable client isolation on the SSID. passwordString Pre-shared key (PSK) for the SSID. passwordRotationCadenceSSIDPasswordRotationCadence Cadence for automatic password rotation. passwordRotationDayOfMonthLocalInt The day of the month for password rotation in the network's local time zone. passwordRotationDayOfWeekLocalInt The day of the week for password rotation in the network's local time zone (0 = Sunday). passwordRotationHourOfDayLocalInt The hour of the day for password rotation in the network's local time zone. ssidString !Name of the SSID. vlanUUIDUUID UUID of the VLAN to associate with the SSID.
Input for creating a service now case integration
Field Type Description entityTypeServiceNowEntityType !Type of service now object associated with this case.
Input to create a support assignment group.
Field Type Description isDefaultBoolean Whether this is the default assignment group for the company. nameString !Name of the assignment group.
Represents the input for creating a support case attachment
Field Type Description fileNameString Name of the file.
Represents the input for creating a support case comment
Input for creating a support case integration. Exactly one provider-specific variant must be set.
Field Type Description descriptionString An optional description of the VLAN. ipV4ClientAssignmentProtocolClientAssignmentProtocol Specifies the protocol for assigning IPv4 addresses to clients on this VLAN. ipV4ClientGatewayIPV4 Specifies the IPv4 gateway address for this VLAN. ipV4ClientPrefixLengthInt Specifies the IPv4 prefix length (subnet mask) for this VLAN. ipV6ClientAssignmentProtocolClientAssignmentProtocol Specifies the protocol for assigning IPv6 addresses to clients on this VLAN. ipV6ClientGatewayIPV6 Specifies the IPv6 gateway address for this VLAN. ipV6ClientPrefixLengthInt Specifies the IPv6 prefix length (subnet mask) for this VLAN. isEnabledBoolean !If true, the VLAN is enabled upon creation. nameString !A human-friendly name to identify the VLAN. vlanIDInt The VLAN ID. Must be between 1 and 4094 and is unique per network. If not provided, the lowest available ID for the network will be selected.
DateRangeFilter
Date range filter implementation.
Field Type Description endDateTime End of date range for the filter. keyString !The key for the filter. startDateTime Start of date range for the filter.
DevicesForNetworkFilter
Filter criteria for devices in a network.
Field Type Description deviceTypeVirtualDeviceType Filter devices by virtual device type. deviceTypes[VirtualDeviceType !] Filter devices by any of the given device types. isDraftBoolean Filter devices by their draft state. virtualDeviceUUIDs[UUID !] If provided, only return virtual devices with these UUIDs. An empty list returns no devices.
Filter type shared across all queries.
Get support cases input
Field Type Description companyUUIDUUID Company UUID to get support cases for, required for the API. filters[FilterInput !]! Filters to apply when fetching the page. pagePageInput !Page location to load from. sortSortOrderInput Sort by order for the support cases.
HardwareDevicesFilter
Filters the response when fetching multiple hardware devices.
Field Type Description deviceModelDeviceModel Filter hardware devices by device model. deviceTypeDeviceType Filter hardware devices by device type. limitInt The maximum number of hardware devices to return. Default is 200. offsetInt The offset from where to start returning hardware devices.
HardwareDevicesForNetworkFilter
Filter criteria for devices in a network.
Field Type Description deviceTypeDeviceType Filter devices by virtual device type.
Field Type Description SIDInt Find events by signature ID. actionIDSEventAlertAction Find events based on action. appProtocolString Find events based on application layer protocol. classTypeString Find events by rule class type shortname. directionIDSEventDirection Find events based on direction. dstIPIP Find events based on destination IP. dstMACMacAddress Find events based on destination MAC address. dstPortPortRangeInput Find events based on destination port. protocolIDSEventProtocol Find events based on protocol. searchIDSEventFilterSearchInput Input for non-exact search against rule fields. srcIPIP Find events based on source IP. srcMACMacAddress Find events based on source MAC address. srcPortPortRangeInput Find events based on source port.
Field Type Description descriptionString Match events whose rule description contains this substring.
Field Type Description categoryUUIDUUID !Unique identifier of the IDS/IPS category. modeIDSIPSMode !The mode of this binding, whether it applies to IDS or IPS.
Field Type Description categoryUUIDUUID !Unique identifier of the IDS category. descriptionString An optional informational description for the suppression. directionIDSIPSSuppressedRuleDirection The traffic direction to consider when determining IP prefix application. Required if ipPrefixes is set. ipPrefixes[IPPrefix !] The IP prefixes that this suppression should apply to. If set, direction is required. modeIDSIPSMode !The mode of this suppression, whether it applies to IDS or IPS.
Field Type Description modeIDSIPSMode !The mode of this binding, whether it applies to IDS or IPS. ruleSIDInt !Unique signature ID of the IDS rule.
Field Type Description descriptionString An optional informational description for the suppression. directionIDSIPSSuppressedRuleDirection The traffic direction to consider when determining IP prefix application. Required if ipPrefixes is set. ipPrefixes[IPPrefix !] The IP prefixes that this suppression should apply to. If set, direction is required. modeIDSIPSMode !The mode of this suppression, whether it applies to IDS or IPS. ruleSIDInt !Unique signature ID of the IDS rule.
Field Type Description SIDInt Find rules by signature ID. actionString Find based on action for this rule. classTypeString Find rules by class type shortname. groupIDInt Find rules by group ID. revisionInt Find rules by revision. searchIDSRuleFilterSearchInput Input for non-exact search against rule fields.
Filter IDS rules based on substring search.
Field Type Description descriptionString Search based on description for this rule. headerString Search based on header for this rule.
A range of IP addresses.
Field Type Description endIP !The upper address in the IP range. startIP !The lower address in the IP range.
Field Type Description durationSecondsInt !The total duration in seconds for which to retrieve metrics data. Maximum set to 1 year. endTimeDateTime If not provided, endTime defaults to now. stepSecondsInt !The interval in seconds between data points in the metrics response.
MultiSelectFilter
Multiselect filter implementation.
Field Type Description keyString !The key for the filter. values[String !]! Selected values for the filter.
NetworkClientsFilter
Field Type Description apSerialNumberString If provided, the latest connected clients for a network are returned that were reported to be connected to the given AP serial number. At most one of macAddress, apSerialNumber, vlanID, or ssid can be provided. excludeMeterHardwareBoolean !If true, clients identified as Meter hardware devices will be excluded from the results. includeLatencyBoolean !If provided, then the ping latency from controller to client is included in the response. includeThroughputBoolean !If provided, the average usage for all returned clients in the last 30 minutes will be included in the response. If macAddress is provided this field has no effect. ipRangeIPRangeInput If provided, returns clients with IP addresses within the provided range. lookbackMinutesInt !When no macAddress and apSerialNumber are provided, filters resulting clients' lastSeen to this many minutes before now. macAddressMacAddress If a MAC address is provided, this will get the history of clients with this MAC address. At most one of macAddress, apSerialNumber, vlanID, or ssid can be provided. ssidString If provided, the latest connected clients for a network are returned that were reported to be connected to the given SSID. Only supported on networks running a firewall. At most one of macAddress, apSerialNumber, vlanID, or ssid can be provided. timestampDateTime If provided, then returns the results that were observed at the given timestamp. If null, defaults to now. vlanIDInt If provided, the latest connected clients for a network are returned that were reported to be connected to the given VLAN. Only supported on networks running a firewall. At most one of macAddress, apSerialNumber, vlanID, or ssid can be provided.
NumberFilter
Number filter implementation.
Field Type Description keyString !The key for the filter. valueFloat !Number value for the filter.
NumberRangeFilter
Number range filter implementation.
Field Type Description endFloat End of number range for the filter. keyString !The key for the filter. startFloat Start of number range for the filter.
A number range input type.
Field Type Description maxInt The maximum value minInt The minimum value
PageInput
Pagination input shared across all paginated queries.
Field Type Description asOfDateTime Time pagination began limitInt !Max items to return (server may cap). pageInt Page to jump to.
Input type for specifying a port range.
Field Type Description lowerInt !Lower bound of the port range (1-65535). upperInt !Upper bound of the port range (1-65535).
Field Type Description isGuestBoolean The guest status to filter by. isHiddenBoolean The hidden status to filter by. ssidString The SSID to filter by.
SelectFilter
Select filter implementation.
Field Type Description keyString !The key for the filter. valueString !Selected value for the filter.
Sort order to apply to a list of results.
Field Type Description fieldNameString !Field to sort by. orderSortOrder !Order of the sort.
Input for getting or creating a support case contact by email.
Field Type Description emailString !Email of the contact. The contact is created if none with this email exists. nameString Name of the contact. phoneNumberString Phone number of the contact. titleString Title of the contact.
TextFilter
Text filter implementation.
Field Type Description keyString !The key for the filter. valueString !Text value for the filter.
Field Type Description actionFirewallRuleAction The action to take when the rule is matched. applicationIDInt The ID of the Netstar application to associate with the rule. boundDHCPRuleUUIDs[UUID !] List of UUIDs of DHCP rules to which the application DNS firewall rule is bound. categoryIDInt The ID of the Netstar category to associate with the rule. domainString The domain or FQDN that is matched by the rule, allowing for wildcards denoted by '*'. groupIDInt The ID of the Netstar group to associate with the rule. isEnabledBoolean Indicates whether the rule is enabled. nameString The name of the DNS firewall rule. priorityInt The priority of the rule; if not specified, will default to 1 greater than the highest existing priority.
Updates an existing AutoVPN member.
Field Type Description permittedVLANUUIDs[UUID !] List of permitted VLAN unique identifiers. The associated VLANs must have participatesInVPNs set to true.
Input type for updating an existing firewall rule.
Field Type Description actionFirewallRuleAction The action to take when the firewall rule matches (e.g., DENY or PERMIT). boundPhyInterfaceUUIDs[UUID !] List of UUIDs of physical interfaces to which the firewall rule is bound. The physical interfaces must be uplinks. boundVLANUUIDs[UUID !] List of UUIDs of VLANs to which the firewall rule is bound. descriptionString A description of the firewall rule. dstPortRanges[PortRangeInput !] List of destination port ranges to match traffic to. dstPrefixes[IPPrefix !] Destination IP prefixes to match traffic to. dstVLANUUIDUUID UUID of the destination VLAN to match traffic to. isEnabledBoolean Indicates if the firewall rule is currently enabled. nameString The name of the firewall rule. priorityInt Priority of the rule within the network, lower priority rules are applied first. If there is an existing rule with the provided value, it and all subsequent occupied values will be incremented. protocols[IPProtocol !] List of IP protocols to match. srcPortRanges[PortRangeInput !] List of source port ranges to match traffic from. srcPrefixes[IPPrefix !] Source IP prefixes to match traffic from. tags[String !] List of tags associated with the firewall rule.
A custom intrusion rule definition for IDS/IPS. These currently apply tls.sni rules.
Field Type Description actionFirewallRuleAction The action this rule applies. applicationIDInt The ID of the Netstar application to associate with the rule. boundVLANUUIDs[UUID !] List of UUIDs of VLANs to which the rule is bound. domainString The FQDN this rule applies to. isEnabledBoolean If this rule is enabled. nameString A name to identify this rule.
Input type for updating an outlet interface.
Field Type Description isEnabledBoolean Whether or not the outlet interface is enabled.
Field Type Description descriptionString Description of the SSID. encryptionProtocolSSIDEncryptionProtocol Encryption protocol used by the SSID. isBand2GAllowedBoolean Enable or disable broadcasting the SSID on the 2.4 GHz band. isBand5GAllowedBoolean Enable or disable broadcasting the SSID on the 5 GHz band. isBand6GAllowedBoolean Enable or disable broadcasting the SSID on the 6 GHz band. isEnabledBoolean Enable or disable the SSID. isEnabledForAllAccessPointsBoolean Enable the SSID for all access points or only specified ones. isGuestBoolean Mark the SSID as a guest network. isHiddenBoolean Hide the SSID from being broadcasted. isIsolateClientsEnabledBoolean Enable client isolation on the SSID. passwordString Pre-shared key (PSK) for the SSID. passwordRotationCadenceSSIDPasswordRotationCadence Cadence for automatic password rotation. passwordRotationDayOfMonthLocalInt The day of the month for password rotation in the network's local time zone. passwordRotationDayOfWeekLocalInt The day of the week for password rotation in the network's local time zone (0 = Sunday). passwordRotationHourOfDayLocalInt The hour of the day for password rotation in the network's local time zone. ssidString Name of the SSID. vlanUUIDUUID UUID of the VLAN to associate with the SSID.
Input to update a support assignment group.
Field Type Description isDefaultBoolean Whether this is the default assignment group for the company. nameString Name of the assignment group.
Represents the input for updating support cases
Field Type Description descriptionString A new description for the VLAN. ipV4ClientAssignmentProtocolClientAssignmentProtocol Updates the protocol for assigning IPv4 addresses to clients on this VLAN. ipV4ClientGatewayIPV4 Updates the IPv4 gateway address for this VLAN. ipV4ClientPrefixLengthInt Updates the IPv4 prefix length (subnet mask) for this VLAN. ipV6ClientAssignmentProtocolClientAssignmentProtocol Updates the protocol for assigning IPv6 addresses to clients on this VLAN. ipV6ClientGatewayIPV6 Updates the IPv6 gateway address for this VLAN. ipV6ClientPrefixLengthInt Updates the IPv6 prefix length (subnet mask) for this VLAN. isEnabledBoolean Enable or disable the VLAN. nameString A new name for the VLAN. vlanIDInt The new VLAN ID. Must be between 1 and 4094 and unique per network.
Deprecated
The following are deprecated and may be removed in a future release. Use the suggested replacement and avoid them in new integrations.
Need help?
If you run into any issues or have questions, please reach out to our Support Engineering team by opening a ticket via the Dashboard: https://dashboard.meter.com/support