RUCKUS Cloud - Platform APIs and Model Documentation (v20.11.11)

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.

Cloud hosts: North American region: "https://ruckus.cloud", European region: "https://eu.ruckus.cloud", Asian region: "https://asia.ruckus.cloud".

NOTE: After authenticating, all APIs require a Tenant ID.
Find your Tenant ID by logging-in to https://ruckus.cloud - your Tenant ID is the 32 character string in the URL after "https://ruckus.cloud/api/ui/t/".

Authentication

Token

Security Scheme Type OAuth2
password OAuth Flow
Token URL: https://ruckus.cloud/token
Scopes:
  • all -

    Grant access

Authentication

Authentication operations.

Request Authentication

Returns an authentication cookie, token and API-KEY.
Use the token to manually set a cookie if your client does not automatically support them.

Request Body schema: application/json

User's credential.

password
string
username
string

Responses

Request samples

Content type
application/json
{
  • "password": "string",
  • "username": "string"
}

Access Sub-Account

This endpoint returns a token which can be used to access your customer's account (e.g., an MSP-EC).

path Parameters
tenantId
required
string

Tenant ID of the sub-account (e.g., MSP-EC) to which access is being requested.

Responses

Request

Most RUCKUS Cloud modification APIs are asynchronous. This will be indicated by a successful HTTP response status code of 202 "Accepted". In these cases, call the Request APIs to retrieve your asynchronous-request status to determine if it succeeded, failed or is still pending.

Get request list

path Parameters
status
required
string
Enum: "PENDING" "SUCCESS" "FAIL"

status

tenantId
required
string

tenantId

query Parameters
page
string

page

size
string

size

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Request details

path Parameters
requestId
required
string

requestId

tenantId
required
string

tenantId

Responses

Response samples

Content type
application/json
{
  • "body": "string",
  • "method": "string",
  • "url": "string"
}

Tenant

Retrieve tenant details.

Get Tenant by id

path Parameters
tenantId
required
string

tenantId

query Parameters
deep
string

deep

Responses

Response samples

Content type
application/json
{
  • "admins": [
    ],
  • "createdDate": "2019-08-24T14:15:22Z",
  • "delegationsTo": [
    ],
  • "externalId": "string",
  • "externalModifiedDate": "2019-08-24T14:15:22Z",
  • "id": "string",
  • "isActivated": true,
  • "maintenanceDate": "2019-08-24T14:15:22Z",
  • "maintenanceState": true,
  • "msp": {
    },
  • "mspEc": {
    },
  • "name": "string",
  • "notificationRecipients": [
    ],
  • "obsolete": true,
  • "parentId": "string",
  • "ruckusUser": true,
  • "status": "active",
  • "tenantMFA": {
    },
  • "updatedDate": "2019-08-24T14:15:22Z"
}

Get Account Details

path Parameters
tenantId
required
string

tenantId

Responses

Response samples

Content type
application/json
{
  • "address": "string",
  • "city": "string",
  • "country": "string",
  • "organization": "string",
  • "stateOrProvince": "string",
  • "zip": "string"
}

Administrator

Manage Administrators.

Get Admin list

path Parameters
tenantId
required
string

tenantId

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Add Admin

path Parameters
tenantId
required
string

tenantId

Request Body schema: application/json

admin

detailLevel
string
Enum: "ba" "it" "su" "debug"
email
string
externalId
string
id
string
lastLogin
string
lastName
string
name
string
role
required
string
Enum: "PRIME_ADMIN" "ADMIN" "VAR_ADMIN" "READ_ONLY" "OFFICE_ADMIN" "SUPPORT" "DEVOPS"

Responses

Request samples

Content type
application/json
{
  • "detailLevel": "ba",
  • "email": "string",
  • "externalId": "string",
  • "id": "string",
  • "lastLogin": "string",
  • "lastName": "string",
  • "name": "string",
  • "role": "PRIME_ADMIN"
}

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": {
    }
}

Update Admin

path Parameters
tenantId
required
string

tenantId

Request Body schema: application/json

admin

detailLevel
string
Enum: "ba" "it" "su" "debug"
email
string
externalId
string
id
string
lastLogin
string
lastName
string
name
string
role
required
string
Enum: "PRIME_ADMIN" "ADMIN" "VAR_ADMIN" "READ_ONLY" "OFFICE_ADMIN" "SUPPORT" "DEVOPS"

Responses

Request samples

Content type
application/json
{
  • "detailLevel": "ba",
  • "email": "string",
  • "externalId": "string",
  • "id": "string",
  • "lastLogin": "string",
  • "lastName": "string",
  • "name": "string",
  • "role": "PRIME_ADMIN"
}

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": {
    }
}

Delete Admin List

path Parameters
tenantId
required
string

tenantId

Request Body schema: application/json

adminIds

Array ()
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

Content type
application/json
{
  • "requestId": "string"
}

Get Admin by ID

path Parameters
adminId
required
string

adminId

tenantId
required
string

tenantId

Responses

Response samples

Content type
application/json
{
  • "detailLevel": "ba",
  • "email": "string",
  • "externalId": "string",
  • "id": "string",
  • "lastLogin": "string",
  • "lastName": "string",
  • "name": "string",
  • "role": "PRIME_ADMIN"
}

Delete Admin by ID

path Parameters
adminId
required
string

adminId

tenantId
required
string

tenantId

Responses

Response samples

Content type
application/json
{
  • "requestId": "string"
}

Delegation

Manage delegations.

Get Delegation List

path Parameters
tenantId
required
string

tenantId

query Parameters
type
string
Enum: "VAR" "SUPPORT" "MSP" "SUPPORT_EC"

type

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Invite VAR Delegation

path Parameters
tenantId
required
string

tenantId

Request Body schema: application/json

inviteVARPayload

username
string

Responses

Request samples

Content type
application/json
{
  • "username": "string"
}

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": {
    }
}

Grant Support Access

path Parameters
tenantId
required
string

tenantId

Responses

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": {
    }
}

Revoke Support Access

path Parameters
tenantId
required
string

tenantId

Responses

Response samples

Content type
application/json
{
  • "requestId": "string"
}

Get Delegation by ID

path Parameters
delegationId
required
string

delegationId

tenantId
required
string

tenantId

Responses

Response samples

Content type
application/json
{
  • "createdDate": "2019-08-24T14:15:22Z",
  • "delegatedBy": "string",
  • "delegatedTo": "string",
  • "delegatedToAdmin": "string",
  • "delegatedToName": "string",
  • "expiryDate": "2019-08-24T14:15:22Z",
  • "id": "string",
  • "isValid": true,
  • "parentId": "string",
  • "status": "INVITED",
  • "type": "VAR",
  • "updatedDate": "2019-08-24T14:15:22Z"
}

Accept or Reject Delegation

path Parameters
delegationId
required
string

delegationId

tenantId
required
string

tenantId

Request Body schema: application/json

payload

accept
boolean
fromTenantId
string

Responses

Request samples

Content type
application/json
{
  • "accept": true,
  • "fromTenantId": "string"
}

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": {
    }
}

Revoke VAR Delegation by ID

path Parameters
delegationId
required
string

delegationId

tenantId
required
string

tenantId

Responses

Response samples

Content type
application/json
{
  • "requestId": "string"
}

Notification Recipient

Manage notification recipients.

Get notification-recipient list

path Parameters
tenantId
required
string

tenantId

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Add notification-recipient

path Parameters
tenantId
required
string

tenantId

Request Body schema: application/json

notificationRecipient

description
required
string
required
Array of objects (NotificationEndpoint)
id
string

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "endpoints": [
    ],
  • "id": "string"
}

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": {
    }
}

Delete notification-recipient list

path Parameters
tenantId
required
string

tenantId

Request Body schema: application/json

notificationRecipients

Array ()
description
required
string
required
Array of objects (NotificationEndpoint)
id
string

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "requestId": "string"
}

Get notification-recipient by ID

path Parameters
notificationRecipientId
required
string

notificationRecipientId

tenantId
required
string

tenantId

Responses

Response samples

Content type
application/json
{
  • "createdDate": "2019-08-24T14:15:22Z",
  • "description": "string",
  • "endpoints": [
    ],
  • "id": "string",
  • "parentId": "string",
  • "updatedDate": "2019-08-24T14:15:22Z"
}

Update notification-recipient

path Parameters
notificationRecipientId
required
string

notificationRecipientId

tenantId
required
string

tenantId

Request Body schema: application/json

notificationRecipient

description
required
string
required
Array of objects (NotificationEndpoint)
id
string

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "endpoints": [
    ],
  • "id": "string"
}

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": {
    }
}

Delete notification-recipient by ID

path Parameters
notificationRecipientId
required
string

notificationRecipientId

tenantId
required
string

tenantId

Responses

Response samples

Content type
application/json
{
  • "requestId": "string"
}

User-Profile

Manage your user profile.

Get User Profile

path Parameters
tenantId
required
string

tenantId

Responses

Response samples

Content type
application/json
{
  • "adminId": "string",
  • "allowedRegions": [
    ],
  • "companyName": "string",
  • "dateFormat": "mm/dd/yyyy",
  • "delegatedDogfood": true,
  • "detailLevel": "ba",
  • "email": "string",
  • "externalId": "string",
  • "firstName": "string",
  • "lastName": "string",
  • "region": "string",
  • "role": "string",
  • "roles": [
    ],
  • "tenantId": "string",
  • "username": "string",
  • "var": true,
  • "varTenantId": "string"
}

Update User Profile

path Parameters
tenantId
required
string

tenantId

Request Body schema: application/json

userProfile

adminId
string
Array of objects (Region)
companyName
string
dateFormat
required
string
Enum: "mm/dd/yyyy" "dd/mm/yyyy" "yyyy/mm/dd"
delegatedDogfood
boolean
detailLevel
required
string
Enum: "ba" "it" "su" "debug"
email
string
externalId
string
firstName
string
lastName
string
region
string
role
string
roles
Array of strings
tenantId
string
username
string
var
boolean
varTenantId
string

Responses

Request samples

Content type
application/json
{
  • "adminId": "string",
  • "allowedRegions": [
    ],
  • "companyName": "string",
  • "dateFormat": "mm/dd/yyyy",
  • "delegatedDogfood": true,
  • "detailLevel": "ba",
  • "email": "string",
  • "externalId": "string",
  • "firstName": "string",
  • "lastName": "string",
  • "region": "string",
  • "role": "string",
  • "roles": [
    ],
  • "tenantId": "string",
  • "username": "string",
  • "var": true,
  • "varTenantId": "string"
}

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": {
    }
}

Venue

Manage Venues.

Get Venue list

path Parameters
tenantId
required
string

tenantId

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create Venue

path Parameters
tenantId
required
string

tenantId

Request Body schema: application/json

venue

object (Address)
description
string
Array of objects (FloorPlan)
id
string
name
string [ 2 .. 32 ] characters \s*\S+\s*\S+.*

Responses

Request samples

Content type
application/json
{
  • "address": {
    },
  • "description": "string",
  • "floorPlans": [
    ],
  • "id": "string",
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": {
    }
}

Delete Venues by List

path Parameters
tenantId
required
string

tenantId

Request Body schema: application/json

venueIds

Array ()
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

Content type
application/json
{
  • "requestId": "string"
}

Get Venue by ID

path Parameters
tenantId
required
string

tenantId

venueId
required
string

venueId

Responses

Response samples

Content type
application/json
{
  • "address": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "description": "string",
  • "floorPlans": [
    ],
  • "id": "string",
  • "name": "string",
  • "parentId": "string",
  • "updatedDate": "2019-08-24T14:15:22Z"
}

Update Venue

path Parameters
tenantId
required
string

tenantId

venueId
required
string

venueId

Request Body schema: application/json

venue

object (Address)
description
string
Array of objects (FloorPlan)
id
string
name
string [ 2 .. 32 ] characters \s*\S+\s*\S+.*

Responses

Request samples

Content type
application/json
{
  • "address": {
    },
  • "description": "string",
  • "floorPlans": [
    ],
  • "id": "string",
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": {
    }
}

Delete Venue by ID

path Parameters
tenantId
required
string

tenantId

venueId
required
string

venueId

Responses

Response samples

Content type
application/json
{
  • "requestId": "string"
}

Floor-Plan

Manage floor-plans and calibration-points (calibrations-points are used to establish precise LTE AP positioning).

Get Floor-Plan list

path Parameters
tenantId
required
string

tenantId

venueId
required
string

venueId

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create Floor-Plan

path Parameters
tenantId
required
string

tenantId

venueId
required
string

venueId

Request Body schema: application/json

floorPlan

floorNumber
integer <int32>
id
string
imageId
string
imageName
string
name
string

Responses

Request samples

Content type
application/json
{
  • "floorNumber": 0,
  • "id": "string",
  • "imageId": "string",
  • "imageName": "string",
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": {
    }
}

Get Floor-Plan by ID

path Parameters
floorPlanId
required
string

floorPlanId

tenantId
required
string

tenantId

venueId
required
string

venueId

Responses

Response samples

Content type
application/json
{
  • "createdDate": "2019-08-24T14:15:22Z",
  • "floorNumber": 0,
  • "id": "string",
  • "imageId": "string",
  • "imageName": "string",
  • "imageUrl": "string",
  • "name": "string",
  • "parentId": "string",
  • "updatedDate": "2019-08-24T14:15:22Z"
}

Update Floor-Plan

path Parameters
floorPlanId
required
string

floorPlanId

tenantId
required
string

tenantId

venueId
required
string

venueId

Request Body schema: application/json

floorPlan

floorNumber
integer <int32>
id
string
imageId
string
imageName
string
name
string

Responses

Request samples

Content type
application/json
{
  • "floorNumber": 0,
  • "id": "string",
  • "imageId": "string",
  • "imageName": "string",
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": {
    }
}

Delete Floor-Plan

path Parameters
floorPlanId
required
string

floorPlanId

tenantId
required
string

tenantId

venueId
required
string

venueId

Responses

Response samples

Content type
application/json
{
  • "requestId": "string"
}

Get Floor-Plan calibrations points by floor plan ID

path Parameters
floorPlanId
required
string

floorPlanId

tenantId
required
string

tenantId

venueId
required
string

venueId

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update Floor-Plan calibrations points

path Parameters
floorPlanId
required
string

floorPlanId

tenantId
required
string

tenantId

venueId
required
string

venueId

Request Body schema: application/json

calibrationPointList

Array ()
id
string
latitude
string
longitude
string
xPercent
number <float>
yPercent
number <float>

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": [
    ]
}

File

Upload/Download files.

Get Upload URL

Get a URL with which to upload a file.

path Parameters
tenantId
required
string

tenantId

Request Body schema: application/json

request

fileExtension
string

Responses

Request samples

Content type
application/json
{
  • "fileExtension": "string"
}

Get Download URL

Get the URL from which to download this file.

path Parameters
fileId
required
string

fileId

tenantId
required
string

tenantId

Responses

Entitlement

Manage Device Entitlements (licenses).

Get Entitlements

Get the list of device entitlements.

path Parameters
tenantId
required
string

tenantId

query Parameters
type
string
Enum: "WIFI" "LTE" "SWITCH"

Filter by device type (optional)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Entitlement Summaries

Get summaries of the device entitlements.

path Parameters
tenantId
required
string

tenantId

query Parameters
type
string
Enum: "WIFI" "LTE" "SWITCH"

Filter by device type (optional)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Refresh Entitlements

Refresh entitlements. Note: this endpoint can be used to retrieve recently activated licenses.

path Parameters
tenantId
required
string

tenantId

query Parameters
type
string
Enum: "WIFI" "LTE" "SWITCH"

Filter by device type (Optional)

Responses

Response samples

Content type
application/json
{
  • "entitlements": [
    ],
  • "summary": [
    ]
}

Get Banners

Retrieve entitlement banner data. Banners provide information about entitlements that are either near their expiry or have expired.

path Parameters
tenantId
required
string

tenantId

query Parameters
type
string
Enum: "WIFI" "LTE" "SWITCH"

Filter by device type (Optional)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

MSP-Service

Manage MSP service and MSP-ECs (MSP end customers).

Get Base URL

Get the MSP's base URL. Note: this is used by MSP-ECs for account login.

Responses

Response samples

Content type
application/json
"string"

Check MSP Label

Check whether this DNS label is already in use by another MSP.

path Parameters
mspLabel
required
string

MSP Label

Responses

Response samples

Content type
application/json
"string"

Get MSP-EC

Get MSP-EC account details.

path Parameters
mspEcTenantId
required
string

Tenant Id of the MSP-EC account to be retrieved.

Responses

Response samples

Content type
application/json
{
  • "msp_label": "acme-sales",
  • "name": "Acme Sales",
  • "street_address": "350 West Java st",
  • "state": "CA",
  • "country": "US",
  • "postal_code": 95089,
  • "phone_number": "650-123-4567",
  • "fax_number": "650-123-9999",
  • "city": "Sunnyvale",
  • "mapping_url": "https//map.gogle.com/zsdweews",
  • "service_effective_date": "2019-09-14 01:12:51Z",
  • "service_expiration_date": "2020-09-14 01:12:51Z",
  • "is_active": true,
  • "tenant_id": "6173ca160495421c95be47b42b349067",
  • "parent_tenant_id": "6173ca160495421c95be47b42b349067"
}

Update MSP-EC

path Parameters
mspEcTenantId
required
string

Tenant Id of the MSP-EC account to be updated.

Request Body schema: application/json

updateMspEcRequest

name
string [ 0 .. 255 ] characters

The Name of MSP-EC account.

street_address
string [ 0 .. 255 ] characters

The Street Address of MSP-EC account.

state
string [ 0 .. 255 ] characters

The state of MSP-EC account.

country
string [ 0 .. 255 ] characters

The country of MSP-EC account.

postal_code
string [ 0 .. 255 ] characters

The Postal code of MSP-EC account.

phone_number
string [ 0 .. 255 ] characters

The phone number of MSP-EC account.

fax_number
string [ 0 .. 255 ] characters

The fax number of MSP-EC account.

city
string [ 0 .. 255 ] characters

The city of MSP-EC account.

mapping_url
string [ 0 .. 255 ] characters

The map URL of MSP-EC account.

service_effective_date
string <date-time>

The effective date of MSP-EC account.

service_expiration_date
string <date-time>

The expiration date of MSP-EC account.

Responses

Request samples

Content type
application/json
{
  • "name": "acmesales",
  • "street_address": "350 West Java st",
  • "state": "CA",
  • "country": "US",
  • "postal_code": 95089,
  • "phone_number": "650-123-4567",
  • "fax_number": "650-123-9999",
  • "city": "Sunnyvale",
  • "mapping_url": "https//map.gogle.com/zsdweews",
  • "service_effective_date": "2019-09-14 01:12:51.805Z",
  • "service_expiration_date": "2020-09-14 01:12:51.805Z"
}

Response samples

Content type
application/json
{
  • "errors": [
    ],
  • "requestId": "string"
}

Delete MSP-EC

path Parameters
mspEcTenantId
required
string

Tenant Id of the MSP-EC account to be deleted.

Responses

Response samples

Content type
application/json
{
  • "createdDate": "2019-08-24T14:15:22Z",
  • "id": "string",
  • "parentId": "string",
  • "properties": { },
  • "switchActivated": true,
  • "tenantActivated": true,
  • "updatedDate": "2019-08-24T14:15:22Z",
  • "wifiActivated": true
}

Get MSP-EC Status

Get activation status for this MSP-EC.

path Parameters
mspEcTenantId
required
string

Tenant Id of the tenant to get MSP data.

Responses

Response samples

Content type
application/json
{
  • "createdDate": "2019-08-24T14:15:22Z",
  • "id": "string",
  • "parentId": "string",
  • "properties": { },
  • "switchActivated": true,
  • "tenantActivated": true,
  • "updatedDate": "2019-08-24T14:15:22Z",
  • "wifiActivated": true
}

Get MSP-EC Admin

Get MSP-EC administrator data.

path Parameters
mspEcAdminId
required
string

Admin Id of the MSP-EC administrator to be retrieved.

mspEcTenantId
required
string

Tenant Id of the MSP-EC administrator to be retrieved.

Responses

Response samples

Content type
application/json
{}

Update MSP-EC Admin

Update MSP-EC administrator data.

path Parameters
mspEcAdminId
required
string

Admin Id of the MSP-EC administrator to be updated.

mspEcTenantId
required
string

Tenant Id of the MSP-EC administrator to be updated.

Request Body schema: application/json

updateMspEcAdminRequest

email
string [ 0 .. 255 ] characters

The email address of MSP-EC administrator.

user_name
string [ 0 .. 255 ] characters

The user name of MSP-EC administrator.

full_name
string [ 0 .. 255 ] characters

The full name of MSP-EC administrator.

first_name
string [ 0 .. 64 ] characters

The first name of MSP-EC administrator.

last_name
string [ 0 .. 64 ] characters

The last name of MSP-EC administrator.

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "errors": [
    ],
  • "requestId": "string"
}

Delete MSP-EC Admin

Delete MSP-EC administrator.

path Parameters
mspEcAdminId
required
string

Admin Id of the MSP-EC administrator to be deleted.

mspEcTenantId
required
string

Tenant Id of the MSP-EC administrator to be deleted.

Responses

Response samples

Content type
application/json
{
  • "errors": [
    ],
  • "requestId": "string"
}

Get MSP-EC Admins

Get a list of MSP-EC administrators.

path Parameters
mspEcTenantId
required
string

Tenant Id of the MSP-EC administrator list to be retrieved.

Responses

Response samples

Content type
application/json
"string"

Deactivate MSP-EC

Deactivate the MSP-EC account.

path Parameters
mspEcTenantId
required
string

Tenant Id of the MSP-EC account to be deactivated.

Responses

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": {
    }
}

Get Authorized Admins

Get the list of MSP administrators authorized to manage an MSP-EC.

path Parameters
mspEcTenantId
required
string

MSP-EC Tenant Id

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update Authorized Admins

Update the list of MSP administrators authorized to manage an MSP-EC.

path Parameters
mspEcTenantId
required
string

MSP-EC Tenant Id

Request Body schema: application/json

mspAdminRoleList

Array ()
msp_admin_id
string

The Admin ID of MSP Tenant.

msp_admin_role
string [ 0 .. 255 ] characters

The admin Role of the first MSP administrator.

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "errors": [
    ],
  • "requestId": "string"
}

Get MSP-EC Support Status

Get Ruckus Support delegation status.

path Parameters
mspEcTenantId
required
string

MSP-EC Tenant Id

Responses

Response samples

Content type
application/json
"string"

Grant MSP-EC Support Access

Allow Ruckus Support access to the MSP-EC.

path Parameters
mspEcTenantId
required
string

MSP-EC Tenant Id

Responses

Response samples

Content type
application/json
"string"

Revoke MSP-EC Support Access

Prevent Ruckus Support from accessing the MSP-EC.

path Parameters
mspEcTenantId
required
string

MSP-EC Tenant Id

Responses

Response samples

Content type
application/json
"string"

Email MSP-EC Admin

Email an MSP-EC administrator an invitation to join the account.

path Parameters
mspEcTenantId
required
string

Tenant Id of the MSP-EC account

Request Body schema: application/json

emailInvitation

admin_email
string [ 0 .. 255 ] characters

The Email of the first MSP-EC administrator.

resend
boolean

Indicate if this is for resending

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "errors": [
    ],
  • "requestId": "string"
}

Get Logo URL

Get the customized logo URL by MSP-EC Tenant Id. Note: this logo represents the MSP's brand.

path Parameters
mspEcTenantId
required
string

MSP-EC Tenant Id

Responses

Response samples

Content type
application/json
"string"

Reactivate MSP-EC

Reactivate the MSP-EC account.

path Parameters
mspEcTenantId
required
string

Tenant Id of the MSP-EC account to be reactivated.

Responses

Response samples

Content type
application/json
{
  • "requestId": "string",
  • "response": {
    }
}

Get MSP-ECs

Get the list of MSP-EC accounts.

path Parameters
mspTenantId
required
string

Tenant Id of the tenant to add MSP Label.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create MSP-EC

Create an MSP-EC account.

path Parameters
mspTenantId
required
string

Tenant Id of the tenant to create MSP-EC account.

Request Body schema: application/json

addMspEcRequest

name
string

The Name of MSP-EC account.

street_address
string [ 0 .. 255 ] characters

The Street Address of MSP-EC account.

state
string [ 0 .. 255 ] characters

The state of MSP-EC account.

country
string [ 0 .. 255 ] characters

The country of MSP-EC account.

postal_code
string [ 0 .. 255 ] characters

The Postal code of MSP-EC account.

phone_number
string [ 0 .. 255 ] characters

The phone number of MSP-EC account.

fax_number
string [ 0 .. 255 ] characters

The fax number of MSP-EC account.

city
string [ 0 .. 255 ] characters

The city of MSP-EC account.

mapping_url
string [ 0 .. 255 ] characters

The map URL of MSP-EC account.

service_effective_date
string <date-time>

The effective date of MSP-EC account.

service_expiration_date
string <date-time>

The expiration date of MSP-EC account.

admin_email
string [ 0 .. 255 ] characters

The Email of the first MSP-EC administrator.

admin_firstname
string [ 0 .. 64 ] characters

The First name of the first MSP-EC administrator.

admin_lastname
string [ 0 .. 64 ] characters

The Last name of the first MSP-EC administrator.

admin_role
string [ 0 .. 255 ] characters

The admin Role of the first MSP-EC administrator.

Responses

Request samples

Content type
application/json
{
  • "name": "Acme Sales",
  • "street_address": "123 Main Street",
  • "state": "CA",
  • "country": "US",
  • "postal_code": 95089,
  • "phone_number": "650-123-4567",
  • "fax_number": "650-123-9999",
  • "city": "Sunnyvale",
  • "mapping_url": "https//map.gogle.com/zsdweews",
  • "service_effective_date": "2019-09-14 01:12:51Z",
  • "service_expiration_date": "2020-09-14 01:12:51Z",
  • "admin_email": "[email protected]",
  • "admin_firstname": "John",
  • "admin_lastname": "Doe",
  • "admin_role": "PRIME_ADMIN,ADMIN,READ_ONLY"
}

Response samples

Content type
application/json
"string"

Get MSP Customization Data

Get customization data for MSP.

path Parameters
mspTenantId
required
string

Tenant Id of the tenant to get MSP data.

Responses

Response samples

Content type
application/json
{
  • "mspLogoFileDataList": [
    ],
  • "preferredWisprProvider": {
    },
  • "msp_label": "acme-sales",
  • "logo_uuid": "b183ae56-e081-11e9-8a34-2a2ae2dbcce4.jpg",
  • "alarm_notification_logo_uuid": "b183ae56-e081-11e9-8a34-2a2ae2dbcce4.jpg",
  • "ping_notification_logo_uuid": "b183ae56-e081-11e9-8a34-2a2ae2dbcce4.jpg",
  • "mlisa_logo_uuid": "b183ae56-e081-11e9-8a34-2a2ae2dbcce4.jpg",
  • "ping_login_logo_uuid": "b183ae56-e081-11e9-8a34-2a2ae2dbcce4.jpg",
  • "default_logo_uuid": "b183ae56-e081-11e9-8a34-2a2ae2dbcce4.jpg",
  • "msp_fqdn": "wifi.example.com",
  • "contact_support_url": "http://support.example.com/",
  • "contact_support_behavior": "redirect",
  • "open_case_behavior": "redirect",
  • "my_open_case_behavior": "redirect",
  • "change_password_url": "http://wifi.example.com/password",
  • "msp_phone": "+6501234567",
  • "msp_email": "[email protected]",
  • "msp_website": "http://wifi.example.com",
  • "msp_external_id": "0015B000015bJEfQAM",
  • "msp_tenant_name": "Acme Sales, Inc."
}

Create MSP Label

Add a new DNS label for MSP.

path Parameters
mspTenantId
required
string

Tenant Id of the tenant to add MSP Label.

Request Body schema: application/json

updateMspRequest

Array of objects (MspLogoFileData)
object (PreferredWisprProvider)
msp_label
string[a-zA-Z][a-zA-Z0-9-]{0,61}[a-zA-Z0-9]

The MSP label.

logo_uuid
string^$|[a-zA-Z0-9~\.+_-]+

The ID of Logo file.

alarm_notification_logo_uuid
string^$|[a-zA-Z0-9~\.+_-]+

The ID of alarmNotificationLogo Logo file.

ping_notification_logo_uuid
string^$|[a-zA-Z0-9~\.+_-]+

The ID of pingNotificationLogo file.

mlisa_logo_uuid
string^$|[a-zA-Z0-9~\.+_-]+

The ID of mlisaLogo file.

ping_login_logo_uuid
string^$|[a-zA-Z0-9~\.+_-]+

The ID of pingLoginLogo file.

default_logo_uuid
string^$|[a-zA-Z0-9~\.+_-]+

The ID of defaultLogo file.

msp_fqdn
string [ 0 .. 255 ] characters ^$|[a-zA-Z][a-zA-Z0-9-]{0,61}[a-zA-Z0-9](\.[a...

The FQDN of MSP Portal.

contact_support_url
string [ 0 .. 255 ] characters ^$|(http|https)://[a-zA-Z][a-zA-Z0-9-]{0,61}[...

The Contact support URL of MSP Tenant.

contact_support_behavior
string [ 0 .. 255 ] characters

The Contact support behavior of MSP Tenant.

open_case_url
string [ 0 .. 255 ] characters ^$|(http|https)://[a-zA-Z][a-zA-Z0-9-]{0,61}[...

The Open case URL of MSP Tenant.

open_case_behavior
string [ 0 .. 255 ] characters

The Open case behavior of MSP Tenant.

my_open_case_url
string [ 0 .. 255 ] characters ^$|(http|https)://[a-zA-Z][a-zA-Z0-9-]{0,61}[...

The My open case URL of MSP Tenant.

my_open_case_behavior
string [ 0 .. 255 ] characters

The My open case behavior of MSP Tenant.

change_password_url
string [ 0 .. 255 ] characters ^$|(http|https)://[a-zA-Z][a-zA-Z0-9-]{0,61}[...

The Change password URL of MSP Tenant.

msp_phone
string [ 0 .. 255 ] characters

The phone of MSP Tenant.

msp_email
string [ 0 .. 255 ] characters

The email of MSP Tenant.

msp_website
string [ 0 .. 255 ] characters ^$|(http|https)://[a-zA-Z][a-zA-Z0-9-]{0,61}[...

The website of MSP Tenant.

Responses

Request samples

Content type
application/json
{
  • "mspLogoFileDataList": [
    ],
  • "preferredWisprProvider": {
    },
  • "msp_label": "acme-sales",
  • "logo_uuid": "b183ae56e08111e98a342a2ae2dbcce4-001.png",
  • "alarm_notification_logo_uuid": "b183ae56e08111e98a342a2ae2dbcce4-001.png",
  • "ping_notification_logo_uuid": "b183ae56e08111e98a342a2ae2dbcce4-001.png",
  • "mlisa_logo_uuid": "b183ae56e08111e98a342a2ae2dbcce4-001.png",
  • "ping_login_logo_uuid": "b183ae56e08111e98a342a2ae2dbcce4-001.png",
  • "default_logo_uuid": "b183ae56e08111e98a342a2ae2dbcce4-001.png",
  • "msp_fqdn": "wifi.example.com",
  • "contact_support_url": "http://support.example.com/",
  • "contact_support_behavior": "redirect",
  • "open_case_behavior": "redirect",
  • "my_open_case_behavior": "redirect",
  • "change_password_url": "http://wifi.example.com/password",
  • "msp_phone": "408-123-5678",
  • "msp_email": "[email protected]",
  • "msp_website": "http://wifi.example.com"
}

Response samples

Content type
application/json
{
  • "errors": [
    ],
  • "requestId": "string"
}

Update MSP Data

Update data for MSP.

path Parameters
mspTenantId
required
string

Tenant Id of the tenant to update MSP data.

Request Body schema: application/json

updateMspRequest

Array of objects (MspLogoFileData)
object (PreferredWisprProvider)
msp_label
string[a-zA-Z][a-zA-Z0-9-]{0,61}[a-zA-Z0-9]

The MSP label.

logo_uuid
string^$|[a-zA-Z0-9~\.+_-]+

The ID of Logo file.

alarm_notification_logo_uuid
string^$|[a-zA-Z0-9~\.+_-]+

The ID of alarmNotificationLogo Logo file.

ping_notification_logo_uuid
string^$|[a-zA-Z0-9~\.+_-]+

The ID of pingNotificationLogo file.

mlisa_logo_uuid
string^$|[a-zA-Z0-9~\.+_-]+

The ID of mlisaLogo file.

ping_login_logo_uuid
string^$|[a-zA-Z0-9~\.+_-]+

The ID of pingLoginLogo file.

default_logo_uuid
string^$|[a-zA-Z0-9~\.+_-]+

The ID of defaultLogo file.

msp_fqdn
string [ 0 .. 255 ] characters ^$|[a-zA-Z][a-zA-Z0-9-]{0,61}[a-zA-Z0-9](\.[a...

The FQDN of MSP Portal.

contact_support_url
string [ 0 .. 255 ] characters ^$|(http|https)://[a-zA-Z][a-zA-Z0-9-]{0,61}[...

The Contact support URL of MSP Tenant.

contact_support_behavior
string [ 0 .. 255 ] characters

The Contact support behavior of MSP Tenant.

open_case_url
string [ 0 .. 255 ] characters ^$|(http|https)://[a-zA-Z][a-zA-Z0-9-]{0,61}[...

The Open case URL of MSP Tenant.

open_case_behavior
string [ 0 .. 255 ] characters

The Open case behavior of MSP Tenant.

my_open_case_url
string [ 0 .. 255 ] characters ^$|(http|https)://[a-zA-Z][a-zA-Z0-9-]{0,61}[...

The My open case URL of MSP Tenant.

my_open_case_behavior
string [ 0 .. 255 ] characters

The My open case behavior of MSP Tenant.

change_password_url
string [ 0 .. 255 ] characters ^$|(http|https)://[a-zA-Z][a-zA-Z0-9-]{0,61}[...

The Change password URL of MSP Tenant.

msp_phone
string [ 0 .. 255 ] characters

The phone of MSP Tenant.

msp_email
string [ 0 .. 255 ] characters

The email of MSP Tenant.

msp_website
string [ 0 .. 255 ] characters ^$|(http|https)://[a-zA-Z][a-zA-Z0-9-]{0,61}[...

The website of MSP Tenant.

Responses

Request samples

Content type
application/json
{
  • "mspLogoFileDataList": [
    ],
  • "preferredWisprProvider": {
    },
  • "msp_label": "acme-sales",
  • "logo_uuid": "b183ae56e08111e98a342a2ae2dbcce4-001.png",
  • "alarm_notification_logo_uuid": "b183ae56e08111e98a342a2ae2dbcce4-001.png",
  • "ping_notification_logo_uuid": "b183ae56e08111e98a342a2ae2dbcce4-001.png",
  • "mlisa_logo_uuid": "b183ae56e08111e98a342a2ae2dbcce4-001.png",
  • "ping_login_logo_uuid": "b183ae56e08111e98a342a2ae2dbcce4-001.png",
  • "default_logo_uuid": "b183ae56e08111e98a342a2ae2dbcce4-001.png",
  • "msp_fqdn": "wifi.example.com",
  • "contact_support_url": "http://support.example.com/",
  • "contact_support_behavior": "redirect",
  • "open_case_behavior": "redirect",
  • "my_open_case_behavior": "redirect",
  • "change_password_url": "http://wifi.example.com/password",
  • "msp_phone": "408-123-5678",
  • "msp_email": "[email protected]",
  • "msp_website": "http://wifi.example.com"
}

Response samples

Content type
application/json
{
  • "errors": [
    ],
  • "requestId": "string"
}

Entitlement-Assignment

Manage MSP Entitlements (bulk licenses).

Get Assignments

Retrieve all the assignments (created and revoked).

path Parameters
tenantId
required
string

tenantId of the MSP retrieving their MSP Assignments.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create Assignment

Create a new entitlement assignment.

path Parameters
tenantId
required
string

tenantId of the MSP creating an MSP Assignment.

Request Body schema: application/json

assign

mspEcTenantId
string

MSP-EC's tenantId.

deviceType
string
Enum: "MSP_WIFI" "MSP_SWITCH"

MSP (Bulk) Entitlement device type.

deviceSubType
string

MSP (Bulk) Entitlement device sub-type; in this version of the API, this parameter is only used when deviceType is SWITCH. Valid string values for device sub-type are "ICX71L", "ICX71", "ICX76", "ICX78" and "ICX_ANY".

quantity
integer <int64>

Quantity of devices permitted by this assignment.

useTemporaryMspEntitlement
boolean

Trial (aka Temporary) MSP Entitlement to be used for this assignment (if this parameter is not supplied in the request, it defaults to false).

Responses

Request samples

Content type
application/json
{
  • "mspEcTenantId": "d7c104ba608c41eb864279be2fc0d2e8",
  • "deviceType": "MSP_WIFI",
  • "deviceSubType": "ICX71",
  • "quantity": 15,
  • "useTemporaryMspEntitlement": false
}

Response samples

Content type
application/json
"string"

Bulk Assignment Operation

Bulk operations request to create, replace or revoke multiple (1-14) entitlement assignments.

path Parameters
tenantId
required
string

tenantId of the MSP creating an MSP Assignment.

Request Body schema: application/json

operationsRequest

bulkOperationRequest
Array of objects (AssignmentOperation)

Object providing a list of requested assignment operations.

Responses

Request samples

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

Response samples

Content type
application/json
[
  • {
    }
]

Get Assignment Summaries

Retrieve a summary by device type of all an MSP's Entitlement Assignments.

path Parameters
tenantId
required
string

tenantId of the MSP retrieving their MSP Assignments Summary.

Responses

Response samples

Content type
application/json
{
  • "deviceType": "MSP_WIFI",
  • "deviceSubType": "ICX71",
  • "quantity": 2000,
  • "courtesyMspEntitlementsUsed": false,
  • "remainingDevices": 1472,
  • "trial": true
}

Replace Assignment

Replace an entitlement assignment.

path Parameters
assignmentId
required
string

Id of the assignment to replace.

tenantId
required
string

tenantId of the MSP replacing this assignment.

Request Body schema: application/json

replacementAssignment

newQuantity
integer <int64>

Quantity of devices permitted by this replacement assignment; the replacement assignment will be for the same MSP-EC and have the same deviceType, deviceSubType and isTrial values as the assignment being revoked.

Responses

Request samples

Content type
application/json
{
  • "newQuantity": 10
}

Response samples

Content type
application/json
"string"

Revoke Assignment

Revoke an entitlement assignment.

path Parameters
assignmentId
required
string

Id of the assignment to revoke.

tenantId
required
string

tenantId of the MSP revoking this assignment.

Responses

Get MSP Entitlements

Retrieve all the MSP's MSP (Bulk) entitlements.

path Parameters
tenantId
required
string

tenantId of the MSP retrieving their MSP Entitlements.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Refresh MSP Entitlements

Refresh MSP entitlements. Note: this endpoint can be used to retrieve recently activated licenses.

path Parameters
tenantId
required
string

tenantId of the MSP refreshing their MSP Entitlements.

Responses

Response samples

Content type
application/json
{
  • "mspEntitlementBanners": [
    ],
  • "mspEntitlementSummaries": [
    ],
  • "mspEntitlements": [
    ]
}

Get Banners

Retrieve banner data for the MSP's MSP (Bulk) entitlements. Banners provide information about MSP (Bulk) Entitlements that are either near their expiry or have expired.

path Parameters
tenantId
required
string

tenantId of the MSP retrieving their MSP Entitlement Banners.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get MSP Entitlement Summaries

Retrieve a summary of all an MSP's MSP (Bulk) Entitlements by device type.

path Parameters
tenantId
required
string

tenantId of the MSP retrieving their MSP Entitlements Summaries.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

View

View Platform information. Note: this set of endpoints is used to view operational data. They don't provide the means to manage configuration.

Get Admins

Get the list of admins.

path Parameters
tenantId
required
string

Tenant ID

Request Body schema: application/json

payload

fields
Array of strings
object
Array of objects (MatchFieldDto)
multiSortFields
Array of strings
Array of objects (MustNotMatchFieldDto)
page
integer <int32>
object (EntryOfstringAndstring)
pageSize
integer <int32>
object (RangeFilterDto)
searchString
string
searchTargetFields
Array of strings
sortField
string
sortOrder
string
object (TermFieldDto)

Responses

Request samples

Content type
application/json
{
  • "fields": [
    ],
  • "filters": {
    },
  • "matchFields": [
    ],
  • "multiSortFields": [
    ],
  • "mustNotMatchField": [
    ],
  • "page": 0,
  • "pageByDate": {
    },
  • "pageSize": 0,
  • "rangeFilter": {
    },
  • "searchString": "string",
  • "searchTargetFields": [
    ],
  • "sortField": "string",
  • "sortOrder": "string",
  • "termField": {
    }
}

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "errorMessage": "string",
  • "fields": [
    ],
  • "objectId": "string",
  • "page": 0,
  • "subsequentQueries": [
    ],
  • "totalCount": 0
}

Get Delegations

Get the list of customer delegations.

path Parameters
tenant_id
required
string

Tenant ID

Request Body schema: application/json

payload

fields
Array of strings
object
Array of objects (MatchFieldDto)
multiSortFields
Array of strings
Array of objects (MustNotMatchFieldDto)
page
integer <int32>
object (EntryOfstringAndstring)
pageSize
integer <int32>
object (RangeFilterDto)
searchString
string
searchTargetFields
Array of strings
sortField
string
sortOrder
string
object (TermFieldDto)

Responses

Request samples

Content type
application/json
{
  • "fields": [
    ],
  • "filters": {
    },
  • "matchFields": [
    ],
  • "multiSortFields": [
    ],
  • "mustNotMatchField": [
    ],
  • "page": 0,
  • "pageByDate": {
    },
  • "pageSize": 0,
  • "rangeFilter": {
    },
  • "searchString": "string",
  • "searchTargetFields": [
    ],
  • "sortField": "string",
  • "sortOrder": "string",
  • "termField": {
    }
}

Response samples

Content type
application/json
{
  • "crtTime": "string",
  • "delegatedToEmail": "string",
  • "delegatedToId": "string",
  • "delegatedToName": "string",
  • "delegationType": "string",
  • "entitlements": [
    ],
  • "id": "string",
  • "lastUpdTime": "string",
  • "status": "string",
  • "tenantEmail": "string",
  • "tenantId": "string",
  • "tenantName": "string",
  • "type": "string"
}

Get MSP-ECs

Get the list of your MSP-ECs.

path Parameters
tenant_id
required
string

Tenant ID

query Parameters
delegation
string

delegation

Request Body schema: application/json

payload

fields
Array of strings
object
Array of objects (MatchFieldDto)
multiSortFields
Array of strings
Array of objects (MustNotMatchFieldDto)
page
integer <int32>
object (EntryOfstringAndstring)
pageSize
integer <int32>
object (RangeFilterDto)
searchString
string
searchTargetFields
Array of strings
sortField
string
sortOrder
string
object (TermFieldDto)

Responses

Request samples

Content type
application/json
{
  • "fields": [
    ],
  • "filters": {
    },
  • "matchFields": [
    ],
  • "multiSortFields": [
    ],
  • "mustNotMatchField": [
    ],
  • "page": 0,
  • "pageByDate": {
    },
  • "pageSize": 0,
  • "rangeFilter": {
    },
  • "searchString": "string",
  • "searchTargetFields": [
    ],
  • "sortField": "string",
  • "sortOrder": "string",
  • "termField": {
    }
}

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "errorMessage": "string",
  • "fields": [
    ],
  • "objectId": "string",
  • "page": 0,
  • "subsequentQueries": [
    ],
  • "totalCount": 0
}