APIs published in this document are subject to strict change control by RUCKUS. As far as possible, when new versions of the Public API are published, all documented API endpoints will maintain backward compatibility. When not possible, an API endpoint will be deprecated and a replacement API or some other workaround will be provided. Support for deprecated API endpoints will continue for at least six months prior to removal in order to provide API client developers sufficient time to adopt the replacement. This document will indicate when API endpoints are deprecated along with the schedule for their removal. API client developers may discover other experimental API endpoints provided by the RUCKUS cloud, not included in this API document. RUCKUS reserves the right to change these experimental APIs without notice to API client developers.
Document Name | Resources Managed |
platform-ns-220711.html | Platform related resources. This document describes API endpoints related to your account including administrators and their notification preferences, venues and your entitlements/licenses. |
msp-ns-220711.html | MSP & VAR related resources. This document describes API endpoints related to managing your customers and their networks. |
switch-ns-220711.html | ICX switch related resources. This document describes API endpoints related to managing your switches and wired networks. |
wifi-ns-220711.html | Wi-Fi related resources. This document describes API endpoints related to managing your access points (APs) and wireless networks. |
Region | Domain |
Asia | https://asia.ruckus.cloud |
Europe | https://eu.ruckus.cloud |
North America | https://ruckus.cloud |
API Group | Purpose |
Account | Retrieve account details. Note: this API group only provides methods to retrieve resources (but not to create, update or delete them); account information is managed on the RUCKUS support website. |
Administrator | Used to manage administrators (create, read, update and delete). Administrator access privileges (aka roles), are also assigned using endpoints in this group. |
User Profile | Used to manage an administrator’s personal preferences. These preferences (e.g., date format) can be observed in notifications (email, SMS) sent from the RUCKUS cloud. |
Notification Recipient | Used to manage an account’s list of notification recipients and their preferred notification methods (email, SMS or none). Notifications generated as the result of circumstances in the RUCKUS cloud or account’s networks (typically alarms) that administrators should be aware of; some may require remedial action on the part of an administrator. Note that a notification recipient can anyone, not only an account administrator. |
Venues are container resources for networking devices. Every networking device is installed into a venue resource. Venue resources are managed (created, read, updated and deleted) using endpoints in the “Venue” API group. Note that every account has a default venue, automatically created when the account is initialized.
WARNING: take care when deleting venues. Deleting a venue will also delete all networking devices contained therein.
Every venue can have a floorplan associated with it, if desired. On the floorplan, locations of networking devices can be provisioned using endpoints documented in the Wi-Fi or Switch namespace documents. This can be helpful in keeping track of your networking assets. The “Blink LED” endpoints (also in Wi-Fi or Switch namespace documents) be use used to be sure you have the right location marked for each device.
The following workflow is used to associate a floorplan with a venue:
Returns an API-KEY. An administrator must provide their Ruckus support credential to obtain the API-KEY.
Note: API clients might need manually set the API-KEY as a cookie if not automatically supported.
User's credential.
password | string |
username | string |
{- "password": "string",
- "username": "string"
}
Get this account's details.
tenantId required | string tenantId |
deep | string deep |
{- "admins": [
- {
- "adminRoles": [
- {
- "createdDate": "2019-08-24T14:15:22Z",
- "delegated": "string",
- "delegatedRoleType": "RKS_EC",
- "id": "string",
- "role": "PRIME_ADMIN",
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "dateFormat": "mm/dd/yyyy",
- "detailLevel": "ba",
- "externalId": "string",
- "id": "string",
- "updatedDate": "2019-08-24T14:15:22Z",
- "username": "string"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "delegationsTo": [
- {
- "createdDate": "2019-08-24T14:15:22Z",
- "delegatedBy": "string",
- "delegatedTo": "string",
- "delegatedToAdmin": "string",
- "delegatedToName": "string",
- "expiryDate": "2019-08-24T14:15:22Z",
- "id": "string",
- "isValid": true,
- "status": "INVITED",
- "type": "VAR",
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "externalId": "string",
- "externalModifiedDate": "2019-08-24T14:15:22Z",
- "id": "string",
- "isActivated": true,
- "msp": {
- "alarmNotificationLogoUUID": "string",
- "changePasswordUrl": "string",
- "contactSupportUrl": "string",
- "contractSupportBehavior": "string",
- "defaultLogoUUID": "string",
- "email": "string",
- "isDisableNotification": true,
- "logoUUID": "string",
- "mlisaLogoUUID": "string",
- "mspFQDN": "string",
- "mspLabel": "string",
- "myOpenCaseBehavior": "string",
- "myOpenCaseUrl": "string",
- "openCaseBehavior": "string",
- "openCaseUrl": "string",
- "phone": "string",
- "pingLoginLogoUUID": "string",
- "pingNotificationLogoUUID": "string",
- "website": "string"
}, - "name": "string",
- "notificationRecipients": [
- {
- "createdDate": "2019-08-24T14:15:22Z",
- "description": "string",
- "endpoints": [
- {
- "active": true,
- "createdDate": "2019-08-24T14:15:22Z",
- "destination": "string",
- "id": "string",
- "status": "OK",
- "type": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "id": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "obsolete": true,
- "oemName": "string",
- "ruckusUser": true,
- "status": "active",
- "tenantMFA": {
- "mfaStatus": "string"
}, - "tenantType": "REC",
- "updatedDate": "2019-08-24T14:15:22Z"
}
Get this account's postal address.
tenantId required | string tenantId |
{- "address": "string",
- "city": "string",
- "country": "string",
- "organization": "string",
- "stateOrProvince": "string",
- "zip": "string"
}
Get admin list.
tenantId required | string tenantId |
[- {
- "delegateToAllECs": true,
- "delegatedECs": [
- "string"
], - "detailLevel": "ba",
- "email": "string",
- "externalId": "string",
- "id": "string",
- "lastLogin": "string",
- "lastName": "string",
- "name": "string",
- "role": "PRIME_ADMIN"
}
]
Update admin.
tenantId required | string tenantId |
admin
delegateToAllECs | boolean If set to true, this admin is permitted to manage all delegated account IDs (RECs or MSP-ECs). | ||||||||||||||||
delegatedECs | Array of strings List of delegated account IDs (RECs or MSP-ECs) that this admin is permitted to manage. | ||||||||||||||||
detailLevel | string Enum: "ba" "it" "su" "debug"
| ||||||||||||||||
string | |||||||||||||||||
externalId | string | ||||||||||||||||
id | string | ||||||||||||||||
lastLogin | string | ||||||||||||||||
lastName | string | ||||||||||||||||
name | string | ||||||||||||||||
role | string Enum: "PRIME_ADMIN" "ADMIN" "READ_ONLY" "OFFICE_ADMIN"
|
{- "delegateToAllECs": true,
- "delegatedECs": [
- "string"
], - "detailLevel": "ba",
- "email": "string",
- "externalId": "string",
- "id": "string",
- "lastLogin": "string",
- "lastName": "string",
- "name": "string",
- "role": "PRIME_ADMIN"
}
{- "requestId": "string",
- "response": {
- "adminRoles": [
- {
- "createdDate": "2019-08-24T14:15:22Z",
- "delegated": "string",
- "delegatedRoleType": "RKS_EC",
- "id": "string",
- "role": "PRIME_ADMIN",
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "dateFormat": "mm/dd/yyyy",
- "detailLevel": "ba",
- "externalId": "string",
- "id": "string",
- "updatedDate": "2019-08-24T14:15:22Z",
- "username": "string"
}
}
Add admin.
tenantId required | string tenantId |
admin
delegateToAllECs | boolean If set to true, this admin is permitted to manage all delegated account IDs (RECs or MSP-ECs). | ||||||||||||||||
delegatedECs | Array of strings List of delegated account IDs (RECs or MSP-ECs) that this admin is permitted to manage. | ||||||||||||||||
detailLevel | string Enum: "ba" "it" "su" "debug"
| ||||||||||||||||
string | |||||||||||||||||
externalId | string | ||||||||||||||||
id | string | ||||||||||||||||
lastLogin | string | ||||||||||||||||
lastName | string | ||||||||||||||||
name | string | ||||||||||||||||
role | string Enum: "PRIME_ADMIN" "ADMIN" "READ_ONLY" "OFFICE_ADMIN"
|
{- "delegateToAllECs": true,
- "delegatedECs": [
- "string"
], - "detailLevel": "ba",
- "email": "string",
- "externalId": "string",
- "id": "string",
- "lastLogin": "string",
- "lastName": "string",
- "name": "string",
- "role": "PRIME_ADMIN"
}
{- "requestId": "string",
- "response": {
- "adminRoles": [
- {
- "createdDate": "2019-08-24T14:15:22Z",
- "delegated": "string",
- "delegatedRoleType": "RKS_EC",
- "id": "string",
- "role": "PRIME_ADMIN",
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "dateFormat": "mm/dd/yyyy",
- "detailLevel": "ba",
- "externalId": "string",
- "id": "string",
- "updatedDate": "2019-08-24T14:15:22Z",
- "username": "string"
}
}
Get admin by ID.
adminId required | string adminId |
tenantId required | string tenantId |
{- "delegateToAllECs": true,
- "delegatedECs": [
- "string"
], - "detailLevel": "ba",
- "email": "string",
- "externalId": "string",
- "id": "string",
- "lastLogin": "string",
- "lastName": "string",
- "name": "string",
- "role": "PRIME_ADMIN"
}
Get user profile.
tenantId required | string tenantId |
{- "adminId": "string",
- "allowedRegions": [
- {
- "current": true,
- "description": "string",
- "link": "string",
- "name": "string"
}
], - "companyName": "string",
- "dateFormat": "mm/dd/yyyy",
- "delegatedDogfood": true,
- "detailLevel": "ba",
- "email": "string",
- "externalId": "string",
- "firstName": "string",
- "lastName": "string",
- "region": "string",
- "role": "string",
- "roles": [
- "string"
], - "tenantId": "string",
- "username": "string",
- "var": true,
- "varTenantId": "string"
}
Update user profile.
tenantId required | string tenantId |
userProfile
adminId | string |
Array of objects (Region) Regions are the continents to which the user is allowed. Currently permitted regions are North America, European Union and Asia. | |
companyName | string |
dateFormat required | string Enum: "mm/dd/yyyy" "dd/mm/yyyy" "yyyy/mm/dd" |
delegatedDogfood | boolean Delegation to a dog food account (internal RUCKUS test accounts, named per the saying, eat your own dog food). |
detailLevel required | string Enum: "ba" "it" "su" "debug" |
string | |
externalId | string |
firstName | string |
lastName | string |
region | string |
role | string |
roles | Array of strings |
tenantId | string |
username | string |
var | boolean |
varTenantId | string |
{- "adminId": "string",
- "allowedRegions": [
- {
- "current": true,
- "description": "string",
- "link": "string",
- "name": "string"
}
], - "companyName": "string",
- "dateFormat": "mm/dd/yyyy",
- "delegatedDogfood": true,
- "detailLevel": "ba",
- "email": "string",
- "externalId": "string",
- "firstName": "string",
- "lastName": "string",
- "region": "string",
- "role": "string",
- "roles": [
- "string"
], - "tenantId": "string",
- "username": "string",
- "var": true,
- "varTenantId": "string"
}
{- "requestId": "string",
- "response": {
- "adminId": "string",
- "allowedRegions": [
- {
- "current": true,
- "description": "string",
- "link": "string",
- "name": "string"
}
], - "companyName": "string",
- "dateFormat": "mm/dd/yyyy",
- "delegatedDogfood": true,
- "detailLevel": "ba",
- "email": "string",
- "externalId": "string",
- "firstName": "string",
- "lastName": "string",
- "region": "string",
- "role": "string",
- "roles": [
- "string"
], - "tenantId": "string",
- "username": "string",
- "var": true,
- "varTenantId": "string"
}
}
Grant Ruckus customer support access to my account.
tenantId required | string tenantId |
{- "requestId": "string",
- "response": {
- "createdDate": "2019-08-24T14:15:22Z",
- "delegatedBy": "string",
- "delegatedTo": "string",
- "delegatedToAdmin": "string",
- "delegatedToName": "string",
- "expiryDate": "2019-08-24T14:15:22Z",
- "id": "string",
- "isValid": true,
- "status": "INVITED",
- "type": "VAR",
- "updatedDate": "2019-08-24T14:15:22Z"
}
}
Get notification recipient list.
tenantId required | string tenantId |
[- {
- "createdDate": "2019-08-24T14:15:22Z",
- "description": "string",
- "endpoints": [
- {
- "active": true,
- "createdDate": "2019-08-24T14:15:22Z",
- "destination": "string",
- "id": "string",
- "status": "OK",
- "type": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "id": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
]
Add notification recipient.
tenantId required | string tenantId |
notificationRecipient
description required | string |
required | Array of objects (NotificationEndpoint) |
id | string |
{- "description": "string",
- "endpoints": [
- {
- "active": true,
- "destination": "string",
- "id": "string",
- "status": "OK",
- "type": "string"
}
], - "id": "string"
}
{- "requestId": "string",
- "response": {
- "createdDate": "2019-08-24T14:15:22Z",
- "description": "string",
- "endpoints": [
- {
- "active": true,
- "createdDate": "2019-08-24T14:15:22Z",
- "destination": "string",
- "id": "string",
- "status": "OK",
- "type": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "id": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
}
Delete notification recipient list.
tenantId required | string tenantId |
notificationRecipients
description required | string |
required | Array of objects (NotificationEndpoint) |
id | string |
{- "requestId": "string"
}
Get notification recipient by ID.
notificationRecipientId required | string notificationRecipientId |
tenantId required | string tenantId |
{- "createdDate": "2019-08-24T14:15:22Z",
- "description": "string",
- "endpoints": [
- {
- "active": true,
- "createdDate": "2019-08-24T14:15:22Z",
- "destination": "string",
- "id": "string",
- "status": "OK",
- "type": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "id": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
Update notification recipient.
notificationRecipientId required | string notificationRecipientId |
tenantId required | string tenantId |
notificationRecipient
description required | string |
required | Array of objects (NotificationEndpoint) |
id | string |
{- "description": "string",
- "endpoints": [
- {
- "active": true,
- "destination": "string",
- "id": "string",
- "status": "OK",
- "type": "string"
}
], - "id": "string"
}
{- "requestId": "string",
- "response": {
- "createdDate": "2019-08-24T14:15:22Z",
- "description": "string",
- "endpoints": [
- {
- "active": true,
- "createdDate": "2019-08-24T14:15:22Z",
- "destination": "string",
- "id": "string",
- "status": "OK",
- "type": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "id": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
}
Delete notification-recipient by ID.
notificationRecipientId required | string notificationRecipientId |
tenantId required | string tenantId |
{- "requestId": "string"
}
Get venue list.
tenantId required | string tenantId |
[- {
- "address": {
- "addressLine": "string",
- "city": "string",
- "country": "string",
- "latitude": 0,
- "longitude": 0,
- "notes": "string",
- "timezone": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "description": "string",
- "floorPlans": [
- {
- "createdDate": "2019-08-24T14:15:22Z",
- "floorNumber": 0,
- "id": "string",
- "imageId": "string",
- "imageName": "string",
- "imageUrl": "string",
- "name": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "id": "string",
- "name": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
]
Create venue.
tenantId required | string tenantId |
venueView
object (AddressView) | |
description | string |
Array of objects (FloorPlanView) | |
name required | string [ 2 .. 32 ] characters \s*\S+\s*\S+.* |
{- "address": {
- "addressLine": "string",
- "city": "string",
- "country": "string",
- "latitude": 0,
- "longitude": 0,
- "notes": "string",
- "timezone": "string"
}, - "description": "string",
- "floorPlans": [
- {
- "floorNumber": 0,
- "imageId": "string",
- "imageName": "string",
- "name": "string",
- "venue": { }
}
], - "name": "string"
}
{- "requestId": "string",
- "response": {
- "address": {
- "addressLine": "string",
- "city": "string",
- "country": "string",
- "latitude": 0,
- "longitude": 0,
- "notes": "string",
- "timezone": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "description": "string",
- "floorPlans": [
- {
- "createdDate": "2019-08-24T14:15:22Z",
- "floorNumber": 0,
- "id": "string",
- "imageId": "string",
- "imageName": "string",
- "imageUrl": "string",
- "name": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "id": "string",
- "name": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
}
Delete venues by list.
WARNING: take care when deleting venues. Deleting a list of venues will also delete all networking devices contained therein.
tenantId required | string tenantId |
venueIds
{- "requestId": "string"
}
Get venue.
tenantId required | string tenantId |
venueId required | string venueId |
{- "address": {
- "addressLine": "string",
- "city": "string",
- "country": "string",
- "latitude": 0,
- "longitude": 0,
- "notes": "string",
- "timezone": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "description": "string",
- "floorPlans": [
- {
- "createdDate": "2019-08-24T14:15:22Z",
- "floorNumber": 0,
- "id": "string",
- "imageId": "string",
- "imageName": "string",
- "imageUrl": "string",
- "name": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "id": "string",
- "name": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
Update venue.
tenantId required | string tenantId |
venueId required | string venueId |
venueView
object (AddressView) | |
description | string |
Array of objects (FloorPlanView) | |
name required | string [ 2 .. 32 ] characters \s*\S+\s*\S+.* |
{- "address": {
- "addressLine": "string",
- "city": "string",
- "country": "string",
- "latitude": 0,
- "longitude": 0,
- "notes": "string",
- "timezone": "string"
}, - "description": "string",
- "floorPlans": [
- {
- "floorNumber": 0,
- "imageId": "string",
- "imageName": "string",
- "name": "string",
- "venue": { }
}
], - "name": "string"
}
{- "requestId": "string",
- "response": {
- "address": {
- "addressLine": "string",
- "city": "string",
- "country": "string",
- "latitude": 0,
- "longitude": 0,
- "notes": "string",
- "timezone": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "description": "string",
- "floorPlans": [
- {
- "createdDate": "2019-08-24T14:15:22Z",
- "floorNumber": 0,
- "id": "string",
- "imageId": "string",
- "imageName": "string",
- "imageUrl": "string",
- "name": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "id": "string",
- "name": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
}
WARNING: take care when deleting venues. Deleting a venue will also delete all networking devices contained therein.
tenantId required | string tenantId |
venueId required | string venueId |
{- "requestId": "string"
}
Get floor plans by a venue ID.
tenantId required | string tenantId |
venueId required | string venueId |
[- {
- "createdDate": "2019-08-24T14:15:22Z",
- "floorNumber": 0,
- "id": "string",
- "imageId": "string",
- "imageName": "string",
- "imageUrl": "string",
- "name": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
]
Create floor plan.
tenantId required | string tenantId |
venueId required | string venueId |
floorPlanView
floorNumber | integer <int32> |
imageId | string |
imageName | string |
name | string |
object (VenueView) |
{- "floorNumber": 0,
- "imageId": "string",
- "imageName": "string",
- "name": "string",
- "venue": {
- "address": {
- "addressLine": "string",
- "city": "string",
- "country": "string",
- "latitude": 0,
- "longitude": 0,
- "notes": "string",
- "timezone": "string"
}, - "description": "string",
- "floorPlans": [
- { }
], - "name": "string"
}
}
{- "requestId": "string",
- "response": {
- "createdDate": "2019-08-24T14:15:22Z",
- "floorNumber": 0,
- "id": "string",
- "imageId": "string",
- "imageName": "string",
- "imageUrl": "string",
- "name": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
}
Get floor plan by ID.
floorPlanId required | string floorPlanId |
tenantId required | string tenantId |
venueId required | string venueId |
{- "createdDate": "2019-08-24T14:15:22Z",
- "floorNumber": 0,
- "id": "string",
- "imageId": "string",
- "imageName": "string",
- "imageUrl": "string",
- "name": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
Update floor plan.
floorPlanId required | string floorPlanId |
tenantId required | string tenantId |
venueId required | string venueId |
floorPlanView
floorNumber | integer <int32> |
imageId | string |
imageName | string |
name | string |
object (VenueView) |
{- "floorNumber": 0,
- "imageId": "string",
- "imageName": "string",
- "name": "string",
- "venue": {
- "address": {
- "addressLine": "string",
- "city": "string",
- "country": "string",
- "latitude": 0,
- "longitude": 0,
- "notes": "string",
- "timezone": "string"
}, - "description": "string",
- "floorPlans": [
- { }
], - "name": "string"
}
}
{- "requestId": "string",
- "response": {
- "createdDate": "2019-08-24T14:15:22Z",
- "floorNumber": 0,
- "id": "string",
- "imageId": "string",
- "imageName": "string",
- "imageUrl": "string",
- "name": "string",
- "updatedDate": "2019-08-24T14:15:22Z"
}
}
Get the list of device entitlements.
tenantId required | string Tenant Id |
type | string Enum: "WIFI" "LTE" "SWITCH" Filter by device type (optional) |
[- {
- "assignedLicense": true,
- "createdDate": "2019-08-24T14:15:22Z",
- "deviceSubType": "string",
- "deviceType": "UNASSIGNED_DEVICE_TYPE",
- "effectiveDate": "2019-08-24T14:15:22Z",
- "expirationDate": "2019-08-24T14:15:22Z",
- "externalId": "string",
- "graceEndDate": "2019-08-24T14:15:22Z",
- "historical": true,
- "id": "string",
- "licenseDesc": "string",
- "licenseName": "string",
- "parentId": "string",
- "quantity": 0,
- "sku": "string",
- "tempLicense": true,
- "updatedDate": "2019-08-24T14:15:22Z"
}
]
Retrieve entitlement banner data. Banners provide information about entitlements that are either near their expiry or have expired.
tenantId required | string tenantId |
type | string Enum: "WIFI" "LTE" "SWITCH" Filter by device type (Optional) |
[- {
- "deviceCount": 0,
- "deviceSubType": "string",
- "deviceType": "UNASSIGNED_DEVICE_TYPE",
- "effectDate": "2019-08-24T14:15:22Z",
- "effectDays": 0,
- "multipleLicense": true,
- "totalActiveDevices": 0,
- "totalRALicense": 0,
- "type": "INITIAL"
}
]
Refresh entitlements. Note: this endpoint can be used to retrieve recently activated licenses.
tenantId required | string tenantId |
type | string Enum: "WIFI" "LTE" "SWITCH" Filter by device type (Optional) |
{- "entitlements": [
- {
- "assignedLicense": true,
- "createdDate": "2019-08-24T14:15:22Z",
- "deviceSubType": "string",
- "deviceType": "UNASSIGNED_DEVICE_TYPE",
- "effectiveDate": "2019-08-24T14:15:22Z",
- "expirationDate": "2019-08-24T14:15:22Z",
- "externalId": "string",
- "graceEndDate": "2019-08-24T14:15:22Z",
- "historical": true,
- "id": "string",
- "licenseDesc": "string",
- "licenseName": "string",
- "parentId": "string",
- "quantity": 0,
- "sku": "string",
- "tempLicense": true,
- "updatedDate": "2019-08-24T14:15:22Z"
}
], - "summary": [
- {
- "closestLicenseQuantity": 0,
- "closestLiceseQtty": 0,
- "deviceCount": 0,
- "deviceSubType": "string",
- "deviceType": "UNASSIGNED_DEVICE_TYPE",
- "effectiveDate": "2019-08-24T14:15:22Z",
- "errorCode": "string",
- "expirationDate": "2019-08-24T14:15:22Z",
- "internalMessage": "string",
- "licenseDesc": "string",
- "licenseName": "string",
- "quantity": 0,
- "remainingDays": 0,
- "remainingDevices": 0,
- "sku": "string",
- "tempLicense": true
}
]
}
Get summaries of the device entitlements.
tenantId required | string tenantId |
type | string Enum: "WIFI" "LTE" "SWITCH" Filter by device type (optional) |
[- {
- "closestLicenseQuantity": 0,
- "closestLiceseQtty": 0,
- "deviceCount": 0,
- "deviceSubType": "string",
- "deviceType": "UNASSIGNED_DEVICE_TYPE",
- "effectiveDate": "2019-08-24T14:15:22Z",
- "errorCode": "string",
- "expirationDate": "2019-08-24T14:15:22Z",
- "internalMessage": "string",
- "licenseDesc": "string",
- "licenseName": "string",
- "quantity": 0,
- "remainingDays": 0,
- "remainingDevices": 0,
- "sku": "string",
- "tempLicense": true
}
]
Retrieve the completion status or details of previously-invoked asynchronous endpoints (i.e., endpoints in other API groups). Note: asynchronous endpoints are indicated by a successful HTTP response status code of 202 "Accepted".
status required | string Enum: "PENDING" "SUCCESS" "FAIL" status |
tenantId required | string tenantId |
page | string page |
size | string size |
[- {
- "admin": "string",
- "count": 0,
- "entityId": "string",
- "method": "string",
- "requestId": "string",
- "serviceName": "string",
- "status": "string",
- "tenantId": "string",
- "timestamp": "string"
}
]
Retrieve the completion status or details of previously-invoked asynchronous endpoints (i.e., endpoints in other API groups). Note: asynchronous endpoints are indicated by a successful HTTP response status code of 202 "Accepted".
requestId required | string requestId |
tenantId required | string tenantId |
{- "admin": "string",
- "count": 0,
- "entityId": "string",
- "method": "string",
- "requestId": "string",
- "serviceName": "string",
- "status": "string",
- "tenantId": "string",
- "timestamp": "string"
}
Get the list of admins.
tenantId required | string Tenant ID |
payload
exists | string |
fields | Array of strings |
object | |
Array of objects (MatchFieldDto) | |
multiSortFields | Array of strings |
mustHaveFields | Array of strings |
mustNotHaveFields | Array of strings |
Array of objects (MustNotMatchFieldDto) | |
page | integer <int32> |
object (EntryOfstringAndstring) | |
pageSize | integer <int32> |
object (RangeFilterDto) | |
object (RangeFilterDto) | |
searchString | string |
searchTargetFields | Array of strings |
sortField | string |
sortOrder | string |
object (TermFieldDto) |
{- "exists": "string",
- "fields": [
- "string"
], - "filters": {
- "property1": [
- "string"
], - "property2": [
- "string"
]
}, - "matchFields": [
- {
- "field": "string",
- "value": "string"
}
], - "multiSortFields": [
- "string"
], - "mustHaveFields": [
- "string"
], - "mustNotHaveFields": [
- "string"
], - "mustNotMatchField": [
- {
- "field": "string",
- "value": "string"
}
], - "page": 0,
- "pageByDate": {
- "key": "string",
- "value": "string"
}, - "pageSize": 0,
- "rangeDateFilter": {
- "field": "string",
- "gte": 0,
- "lt": 0,
- "lte": 0
}, - "rangeFilter": {
- "field": "string",
- "gte": 0,
- "lt": 0,
- "lte": 0
}, - "searchString": "string",
- "searchTargetFields": [
- "string"
], - "sortField": "string",
- "sortOrder": "string",
- "termField": {
- "field": "string",
- "value": "string"
}
}
{- "data": [
- {
- "createDate": 0,
- "externalId": "string",
- "id": "string",
- "tenantId": "string",
- "updateDate": 0,
- "username": "string"
}
], - "errorMessage": "string",
- "fields": [
- "string"
], - "objectId": "string",
- "page": 0,
- "subsequentQueries": [
- {
- "fields": [
- "string"
], - "httpMethod": "GET",
- "payload": { },
- "url": {
- "absolute": true,
- "authority": "string",
- "fragment": "string",
- "host": "string",
- "opaque": true,
- "path": "string",
- "port": 0,
- "query": "string",
- "rawAuthority": "string",
- "rawFragment": "string",
- "rawPath": "string",
- "rawQuery": "string",
- "rawSchemeSpecificPart": "string",
- "rawUserInfo": "string",
- "scheme": "string",
- "schemeSpecificPart": "string",
- "userInfo": "string"
}
}
], - "totalCount": 0
}
Get venue status.
tenantId required | string Tenant ID |
payload
"string"
{- "addressLine": "string",
- "city": "string",
- "country": "string",
- "crtTime": "string",
- "description": "string",
- "dhcp": {
- "enabled": true,
- "mode": "string"
}, - "id": "string",
- "lastUpdTime": "string",
- "latitude": "string",
- "longitude": "string",
- "mesh": {
- "enabled": true
}, - "name": "string",
- "notes": "string",
- "rogueDetection": {
- "enabled": true,
- "policyId": "string",
- "policyName": "string"
}, - "switchProfileId": "string",
- "switchProfileName": "string",
- "tenantId": "string",
- "timeZone": "string",
- "type": "string",
- "wifiFirmwareVersion": "string"
}