API docs by Redocly

Zyxel Nebula OpenAPI (0.1.31)

Download OpenAPI specification:Download

Zyxel Nebula OpenAPI

groups

Group operations

Get Groups

header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Organizations From A Group

path Parameters
groupId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

organizations

Organization operations

Get Organizations

Get the organizations

  • name: Org's name
  • orgId: Org's unique ID
  • mode: Org's license mode
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Org Info

path Parameters
orgId
required
string >= 16 characters
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
Example
{
  • "name": "string",
  • "orgId": "string",
  • "mode": "PRO",
  • "prevMode": "PRO",
  • "mspId": "string",
  • "notes": "string",
  • "licenseOverview": {
    }
}

Get Sites

path Parameters
orgId
required
string >= 16 characters
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Devices From An Org

path Parameters
orgId
required
string >= 16 characters
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Device Firmware Status From An Org

path Parameters
orgId
required
string >= 16 characters
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

sites

Site operations

Get Device Firmware Status From A Site

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Devices Online By Type

path Parameters
siteId
required
string
query Parameters
type
string (DeviceType)
Enum: "AP" "SW" "GW" "FIREWALL" "WWAN" "SCR" "GWH" "ACCY"
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Site Vpn Status

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
{
  • "sites": [
    ],
  • "gateways": [
    ],
  • "remoteAps": [
    ],
  • "cleints": [
    ]
}

Get Site Clients

Site-wide clients data in the last 2 hours.

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
Array
string (ClientAttributesReq)
Enum: "mac_address" "ipv4" "vlan" "last_seen" "connected_device_id" "status" "first_seen" "description" "os_hostname" "manufacturer"

Responses

Request samples

Content type
application/json
[
  • "mac_address"
]

Response samples

Content type
application/json
[
  • {
    }
]

Get Ap Clients

AP clients data in the last 2 hours.

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
Array
string (ApClientAttributesReq)
Enum: "mac_address" "ipv4" "last_seen" "connected_device_id" "first_seen" "description" "os_hostname" "manufacturer" "ssid" "wifi_sta"

Responses

Request samples

Content type
application/json
[
  • "mac_address"
]

Response samples

Content type
application/json
[
  • {
    }
]

Ping

Ping the target address. The token must be null to initialize the ping task, and then use the returned token to fetch the results.

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
target
required
string
string or null

Responses

Request samples

Content type
application/json
{
  • "target": "string",
  • "token": "string"
}

Response samples

Content type
application/json
{
  • "token": "string",
  • "isDone": true,
  • "results": [
    ]
}

Reboot

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
{
  • "status": 0,
  • "message": "string"
}

Cable Test

Start the switch device's cable diagnostics test.

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
ports
required
Array of integers

Responses

Request samples

Content type
application/json
{
  • "ports": [
    ]
}

Response samples

Content type
application/json
{
  • "ports": [
    ]
}

Connectivity

The device connectivity status in the last 2hr/1d/7d/30d

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
required
ClientPeriod (string) or null

Responses

Request samples

Content type
application/json
{
  • "period": "2h"
}

Response samples

Content type
application/json
[
  • {
    }
]

Get Site Reporting

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
{
  • "apTrafficLog": true,
  • "secuReporterTrafficLog": true,
  • "localTimezone": true,
  • "logPrefix": "string",
  • "syslogServers": [
    ]
}

Update Site Reporting

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
apTrafficLog
required
boolean
secuReporterTrafficLog
required
boolean
localTimezone
required
boolean

Whether to use the local timezone for the reporting

required
string or null
required
Array of objects (SyslogServer)

Responses

Request samples

Content type
application/json
{
  • "apTrafficLog": true,
  • "secuReporterTrafficLog": true,
  • "localTimezone": true,
  • "logPrefix": "string",
  • "syslogServers": [
    ]
}

Response samples

Content type
application/json
{
  • "status": 0,
  • "message": "string"
}

Get Site Clients V2

Site-wide clients data in the last 2hr/1d/7d/30d.
Response data key is macAddress.

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
required
ClientPeriod (string) or null

default is 2h

featrues
required
Array of strings (ClientAttributesReq)
Items Enum: "mac_address" "ipv4" "vlan" "last_seen" "connected_device_id" "status" "first_seen" "description" "os_hostname" "manufacturer"

Responses

Request samples

Content type
application/json
{
  • "period": "2h",
  • "featrues": [
    ]
}

Response samples

Content type
application/json
{
  • "KeyFields": [
    ],
  • "data": [
    ]
}

Get Ap Clients V2

AP clients data in the last 2hr/1d/7d/30d.
Response data key is macAddress.

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
required
ClientPeriod (string) or null

default is 2h

featrues
required
Array of strings (ApClientAttributesReqV2)
Items Enum: "mac_address" "ipv4" "last_seen" "connected_device_id" "first_seen" "description" "os_hostname" "manufacturer" "ssid" "wifi_sta" "user" "upload" "download"

Responses

Request samples

Content type
application/json
{
  • "period": "2h",
  • "featrues": [
    ]
}

Response samples

Content type
application/json
{
  • "KeyFields": [
    ],
  • "data": [
    ]
}

Get Sw Clients V2

SW clients data in the last 2hr/1d/7d/30d.
Response data keys are macAddress and vlan.

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
required
ClientPeriod (string) or null

default is 2h

featrues
required
Array of strings (SwClientAttributesReq)
Items Enum: "mac_address" "ipv4" "last_seen" "connected_device_id" "connected_port" "first_seen" "description" "manufacturer" "vlan" "lldp_info"

Responses

Request samples

Content type
application/json
{
  • "period": "2h",
  • "featrues": [
    ]
}

Response samples

Content type
application/json
{
  • "KeyFields": [
    ],
  • "data": [
    ]
}

Get Gw Clients V2

GW clients data in the last 2hr/1d/7d/30d.
Firewall Respone data keys are macAddress, ipv4Address and interface.
SCR Respone data key is macAddress.

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
required
ClientPeriod (string) or null

default is 2h

featrues
required
Array of strings (GwClientAttributesReq)
Items Enum: "mac_address" "ipv4" "last_seen" "connected_device_id" "first_seen" "description" "os_hostname" "manufacturer" "interface"

Responses

Request samples

Content type
application/json
{
  • "period": "2h",
  • "featrues": [
    ]
}

Response samples

Content type
application/json
{
  • "KeyFields": [
    ],
  • "data": [
    ]
}

ap

AP operations

Get Access Point Ip Status

This API returns the current IP status (instead of configuration) of AP interfaces.

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Access Point Port Status

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Wlan Settings

Note: This API always returns 8 SSIDs.

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Patch Wlan Settings

Note: currently this API only supports PSK For [PATCH] method on wlan-setting API, it will only update the SSID Pre-Shared-Key (PSK), no matter the SSID security mode is WPA2/3 or not.

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
Array
id
required
integer [ 1 .. 8 ]

Index from 1 to 8

wpaKey
required
string
string or null
boolean or null
Default: false
boolean or null
Default: false

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "status": 0,
  • "message": "string"
}

Ap Logout User

Logout AP users in the site. Every AP will be instructed to logout the users.

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Get Captive Portal Reauth

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
{
  • "ADUsers": "Every half hour",
  • "RADIUSUsers": "Every half hour",
  • "c2cUsers": "Every half hour",
  • "cloudAuthUsers": "Every half hour"
}

Update Captive Portal Reauth

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
ADUsers
required
string (CaptivePortalReauthInterval)
Enum: "Every half hour" "Every hour" "Every two hours" "Every four hours" "Every twelve hours" "Every day" "Every two days" "Every four days" "Every five days" "Every week" "Every two weeks" "Every 30 days"
RADIUSUsers
required
string (CaptivePortalReauthInterval)
Enum: "Every half hour" "Every hour" "Every two hours" "Every four hours" "Every twelve hours" "Every day" "Every two days" "Every four days" "Every five days" "Every week" "Every two weeks" "Every 30 days"
c2cUsers
required
string (CaptivePortalReauthInterval)
Enum: "Every half hour" "Every hour" "Every two hours" "Every four hours" "Every twelve hours" "Every day" "Every two days" "Every four days" "Every five days" "Every week" "Every two weeks" "Every 30 days"
cloudAuthUsers
required
string (CaptivePortalReauthInterval)
Enum: "Every half hour" "Every hour" "Every two hours" "Every four hours" "Every twelve hours" "Every day" "Every two days" "Every four days" "Every five days" "Every week" "Every two weeks" "Every 30 days"

Responses

Request samples

Content type
application/json
{
  • "ADUsers": "Every half hour",
  • "RADIUSUsers": "Every half hour",
  • "c2cUsers": "Every half hour",
  • "cloudAuthUsers": "Every half hour"
}

Response samples

Content type
application/json
{
  • "status": 0,
  • "message": "string"
}

Update Captive Portal Settings

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
id
required
integer [ 1 .. 8 ]

Index from 1 to 8

required
string or null
required
string or null

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "externalUrl": "string",
  • "successUrl": "string"
}

Response samples

Content type
application/json
{
  • "status": 0,
  • "message": "string"
}

sw

Switch operations

Get Switch Lldp Neighbor

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Switch Ip Status

The current IP status (instead of configuration) of the Switch device. Only one IP data is returned in the array for now.

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Switch L2 Mac Table

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Switch Port Status

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Switch Port Setting

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Change Switch Port Setting

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
portNum
required
integer
enabled
required
boolean
trunk
required
boolean
portVid
required
integer
allowedVLAN
required
Array of strings
required
boolean or null

Responses

Request samples

Content type
application/json
{
  • "portNum": 0,
  • "enabled": true,
  • "trunk": true,
  • "portVid": 0,
  • "allowedVLAN": [
    ],
  • "pseEnabled": true
}

Response samples

Content type
application/json
{
  • "status": 0,
  • "message": "string"
}

Get Switch Poe Status

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Switch Traffic Usage

path Parameters
siteId
required
string
devId
required
string
query Parameters
period
string (TrafficUsagePeriod)
Default: "1d"
Enum: "2h" "1d" "7d"
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Sw Event Logs

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
startTimestamp
required
integer

unit: Unix timestamp (ms)

endTimestamp
required
integer

unit: Unix timestamp (ms)

Responses

Request samples

Content type
application/json
{
  • "startTimestamp": 0,
  • "endTimestamp": 0
}

Response samples

Content type
application/json
[
  • {
    }
]

Get Switch Uplink Port

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
{
  • "portNum": 0
}

gw

Secure Gateway (NSG*/USG FLEX) operations

Get Gateway Port Status

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Gateway System Status

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
{
  • "cpuUsage": 0,
  • "memUsage": 0,
  • "sessions": 0
}

Get Secure Gateway Traffic Usage

path Parameters
siteId
required
string
devId
required
string
query Parameters
period
string (TrafficUsagePeriod)
Default: "1d"
Enum: "2h" "1d" "7d"
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Gateway Event Logs

path Parameters
siteId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string
Request Body schema: application/json
required
startTimestamp
required
integer

unit: Unix timestamp (ms)

endTimestamp
required
integer

unit: Unix timestamp (ms)

Responses

Request samples

Content type
application/json
{
  • "startTimestamp": 0,
  • "endTimestamp": 0
}

Response samples

Content type
application/json
[
  • {
    }
]

Get Firewall Nat Settings

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
{
  • "oneToOne": [
    ],
  • "virtualServer": [
    ]
}

Get Firewall Interface Settings

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
{
  • "wan": [
    ],
  • "lan": [
    ]
}

wwan

WWAN (Mobile Router) operations

Get Wwan Device Status

Mobile Router's WWAN Status.

path Parameters
siteId
required
string
devId
required
string
header Parameters
X-ZyxelNebula-API-Key
required
string

Responses

Response samples

Content type
application/json
{
  • "ipv4Address": "192.168.0.1",
  • "imei": "string",
  • "iccid": "string",
  • "rsrp": 0
}