Skip to content
MSP Services/
/
Send Administrator Invita...

MSP Services (V0.3.3)

Overview

The MSP API provides comprehensive management capabilities for managing multiple MSP managed tenant accounts. This API enables you to manage tenant accounts, control administrator access, customize branding, and schedule firmware upgrades.

The API is designed for managed service providers that manage multiple customer tenant accounts and need to control access delegation, branding customization, and device management operations.

What This API Does

  • MSP Tenant Management: Create, retrieve, update, and delete MSP managed tenant accounts and configuration settings
  • MSP Tenant Queries: Query and retrieve MSP customer or tech partner data
  • MSP Administrator Access Control: Grant or revoke MSP administrator access with role based permissions, delegation capabilities, and cross tenant access control
  • MSP Tenant Activation Management: Control MSP tenant status including activation, deactivation, and temporary support team access for troubleshooting
  • MSP Branding Customization: Configure custom branding for MSP tenants including logo uploads and brand settings
  • MSP Firmware Upgrade Scheduling: Schedule and manage firmware upgrades across managed devices
  • MSP Tenant Delegations: Establish and manage delegation relationships between MSP accounts, technology partners, and customer tenants
  • MSP Administrator Delegations: Manage administrator assignments and access permissions for MSP tenant accounts
  • MSP Administrator Invitations: Send email invitations to MSP administrators for tenant access and onboarding

Key Capabilities

  • Multi Tenant Operations: Manage multiple isolated MSP tenant accounts with independent configurations and administrator assignments
  • MSP Delegation Support: Support delegation between MSP accounts, integrators, installers, and tenant administrators
  • Role Based Access: Assign MSP administrators with specific roles and privilege groups for granular access control
  • MSP Tenant Management: Complete MSP tenant management from creation through deactivation and deletion
  • Support Access Control: Enable or disable temporary support team access to MSP tenants for assistance
  • Custom Branding: Upload and manage custom logos and branding configurations for MSP service delivery
  • Scheduled Upgrades: Configure firmware upgrade schedules with recurring or one time scheduling options for MSP managed devices
  • Query Capabilities: Retrieve MSP tenant data

Authentication & Authorization

This API uses bearer token authentication with role based access control. MSP administrators must have appropriate permissions to perform operations on tenant accounts and delegation relationships.

Ruckus Network Technical Documents
Download OpenAPI description
Download PDF
Overview
URL
http://support.ruckuswireless.com
Support Team
support@ruckuswireless.com
License
RUCKUS Cloud Privacy Policy
Languages
Servers
RUCKUS One API host for North American region.
https://api.ruckus.cloud
RUCKUS One API host for European region.
https://api.eu.ruckus.cloud
RUCKUS One API host for Asian region.
https://api.asia.ruckus.cloud

Tenant Activation Management

Supports the activation and deactivation of a managed tenant. Control support team access for managed tenants.

Operations

View MSP

View MSP and VAR information. Note: this group of endpoints is used to view operational data. They don't provide the means to manage configuration.

Operations

Firmware Upgrade Scheduling

Manages firmware upgrade schedules for access points and switches. Supports recurring automated upgrades and one time manual scheduling options.

Operations

Tenant Delegation Management

Manages delegation relationships between service provider accounts, technology partners, installers, and tenant accounts. Supports assigning tenant accounts to technology partners and controlling organizational access permissions.

Operations

Administrator Access Control

Manages administrator assignments and access control for MSP tenant accounts. Supports assigning or removing administrators, configuring role based permissions and privilege groups, and managing cross tenant administrator access.

Operations

Tenant Account Management

Manages tenant accounts including creation, retrieval, updates, and deletion. Supports sending email invitations to tenant administrators and managing account configurations.

Operations

Retrieve Managed TenantDeprecated

Request

Retrieve detailed information for a specific managed tenant account. This method will be removed no sooner than 08/31/2026. The following URL GET /tenants/{tenantId} can be used for this content.

Path
customerIdstringrequired

Tenant Id of the MSP EC account to be retrieved.

No request payload

Responses

Ok

Bodyapplication/json
msp_labelstring

Label identifying the parent MSP.

Example: "msp-label"
namestring

The name of MSP-EC account.

Example: "Acme Sales"
street_addressstring

The street address of MSP-EC account.

Example: 350
statestring

The state of MSP-EC account.

Example: "CA"
countrystring

The country of MSP-EC account.

Example: "US"
postal_codestring

The postal code of MSP-EC account.

Example: 95089
phone_numberstring

The phone number of MSP-EC account.

Example: "650-123-4567"
fax_numberstring

The fax number of MSP-EC account.

Example: "650-123-9999"
citystring

The city of MSP-EC account.

Example: "Sunnyvale"
mapping_urlstring

The map URL of MSP-EC account.

Example: "https//map.gogle.com/zsdweews"
service_effective_datestring

The effective date of MSP-EC account.

Example: "2019-09-14 01:12:51Z"
service_expiration_datestring

The expiration date of MSP-EC account.

Example: "2020-09-14 01:12:51Z"
is_activestring

Active state of MSP-EC account.

Example: true
tenant_idstring

Tenant ID.

Example: "6173ca160495421c95be47b42b349067"
parent_tenant_idstring

Parent tenant ID.

Example: "6173ca160495421c95be47b42b349067"
tenant_typestring

The tenant type of the MSP EC administrator.

Example: "MSP, MSP_INTEGRATOR, MSP_INSTALLER"
account_idstring

Account ID.

Example: "_53997fe0-dffb-4bac-bcc1-e21c689a320f_kodzLWdS"
tierstring

Service tier of the account.

Example: "_53997fe0-dffb-4bac-bcc1-e21c689a320f_kodzLWdS"
logo_urlstring

URL to access the MSP customer account's logo file.

privacyFeaturesArray of objects(PrivacyFeatureResponse)unique

Privacy features for the account.

Response
application/json
{
  "msp_label": "msp-label",
  "name": "Acme Sales",
  "street_address": 350,
  "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",
  "tenant_type": "MSP, MSP_INTEGRATOR, MSP_INSTALLER",
  "account_id": "_53997fe0-dffb-4bac-bcc1-e21c689a320f_kodzLWdS",
  "tier": "_53997fe0-dffb-4bac-bcc1-e21c689a320f_kodzLWdS",
  "logo_url": "string",
  "privacyFeatures": [
    { … }
  ]
}

Update Managed TenantDeprecated

Request

Update configuration settings for an existing managed tenant account. This method will be removed no sooner than 08/31/2026. The following URL put /tenants/{tenantId} can be used for this content.

Path
customerIdstringrequired

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

Bodyapplication/jsonrequired
namestring[ 0 .. 255 ] charactersrequired

The name of the MSP-EC account.

Example: "Acme Sales"
street_addressstring[ 0 .. 255 ] characters

The street address of the MSP-EC account.

Example: 350
statestring[ 0 .. 255 ] characters

The state of the MSP-EC account.

Example: "CA"
countrystring[ 0 .. 255 ] characters

The country of the MSP-EC account.

Example: "US"
postal_codestring[ 0 .. 255 ] characters

The postal code of the MSP-EC account.

Example: 95089
phone_numberstring[ 0 .. 255 ] characters

The phone number of the MSP-EC account.

Example: "650-123-4567"
fax_numberstring[ 0 .. 255 ] characters

The fax number of the MSP-EC account.

Example: "650-123-9999"
citystring[ 0 .. 255 ] characters

The city of the MSP-EC account.

Example: "Sunnyvale"
mapping_urlstring[ 0 .. 255 ] characters

The map URL of the MSP-EC account.

Example: "https//map.gogle.com/zsdweews"
service_effective_datestringrequired

The effective date of the MSP-EC account.

Example: "2019-09-14 01:12:51.805Z"
service_expiration_datestringrequired

The expiration date of the MSP-EC account.

Example: "2020-09-14 01:12:51.805Z"
licensesobject(License)

License information for the account.

tierstring

Service tier information for MSP-EC.

Example: "GOLD, PLATINUM"
privacyFeaturesArray of objects(PrivacyFeatureRequest)[ 0 .. 1 ] itemsunique

Privacy features for the account.

application/json
{
  "name": "Acme Sales",
  "street_address": 350,
  "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",
  "licenses": {
    "trialAction": "ACTIVATE",
    "assignments": [ … ],
    "subscription_start_date": "string",
    "subscription_end_date": "string"
  },
  "tier": "GOLD, PLATINUM",
  "privacyFeatures": [
    { … }
  ]
}

Responses

Accepted

Bodyapplication/json
requestIdstringrequired

Unique identifier for tracking the API request.

tenantIdstring

Tenant identifier associated with the request.

Response
application/json
{
  "requestId": "string",
  "tenantId": "string"
}

Remove Managed TenantDeprecated

Request

Delete a managed tenant account and all associated data. This method will be removed no sooner than 08/31/2026. The following URL DELETE /tenants/{tenantId} can be used for this content.

Path
customerIdstringrequired

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

No request payload

Responses

Ok

Bodyapplication/json
requestIdstringrequired

Unique identifier for tracking the API request.

tenantIdstring

Tenant identifier associated with the request.

Response
application/json
{
  "requestId": "string",
  "tenantId": "string"
}

List Managed TenantsDeprecated

Request

Retrieve a list of all managed tenant accounts. This method will be removed no sooner than 08/31/2026. The following URL POST /tenants/query can be used for this content.

No request payload

Responses

Ok

Bodyapplication/jsonArray [
msp_labelstring

Label identifying the parent MSP.

Example: "msp-label"
namestring

The name of MSP-EC account.

Example: "Acme Sales"
street_addressstring

The street address of MSP-EC account.

Example: 350
statestring

The state of MSP-EC account.

Example: "CA"
countrystring

The country of MSP-EC account.

Example: "US"
postal_codestring

The postal code of MSP-EC account.

Example: 95089
phone_numberstring

The phone number of MSP-EC account.

Example: "650-123-4567"
fax_numberstring

The fax number of MSP-EC account.

Example: "650-123-9999"
citystring

The city of MSP-EC account.

Example: "Sunnyvale"
mapping_urlstring

The map URL of MSP-EC account.

Example: "https//map.gogle.com/zsdweews"
service_effective_datestring

The effective date of MSP-EC account.

Example: "2019-09-14 01:12:51Z"
service_expiration_datestring

The expiration date of MSP-EC account.

Example: "2020-09-14 01:12:51Z"
is_activestring

Active state of MSP-EC account.

Example: true
tenant_idstring

Tenant ID.

Example: "6173ca160495421c95be47b42b349067"
parent_tenant_idstring

Parent tenant ID.

Example: "6173ca160495421c95be47b42b349067"
tenant_typestring

The tenant type of the MSP EC administrator.

Example: "MSP, MSP_INTEGRATOR, MSP_INSTALLER"
account_idstring

Account ID.

Example: "_53997fe0-dffb-4bac-bcc1-e21c689a320f_kodzLWdS"
tierstring

Service tier of the account.

Example: "_53997fe0-dffb-4bac-bcc1-e21c689a320f_kodzLWdS"
logo_urlstring

URL to access the MSP customer account's logo file.

privacyFeaturesArray of objects(PrivacyFeatureResponse)unique

Privacy features for the account.

]
Response
application/json
[
  {
    "msp_label": "msp-label",
    "name": "Acme Sales",
    "street_address": 350,
    "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",
    "tenant_type": "MSP, MSP_INTEGRATOR, MSP_INSTALLER",
    "account_id": "_53997fe0-dffb-4bac-bcc1-e21c689a320f_kodzLWdS",
    "tier": "_53997fe0-dffb-4bac-bcc1-e21c689a320f_kodzLWdS",
    "logo_url": "string",
    "privacyFeatures": [ … ]
  }
]

Create Managed TenantDeprecated

Request

Create a new managed tenant account with specified configuration settings. This method will be removed no sooner than 08/31/2026. The following URL POST /tenants can be used for this content.

Body
required
account_idstring[ 0 .. 255 ] characters
namestring[ 2 .. 255 ] characters

The name of MSP-EC account.

Example: "Acme Sales"
street_addressstring[ 0 .. 255 ] characters

The MSP-EC mailing address' street name and number.

Example: 350
statestring[ 0 .. 255 ] characters

The MSP-EC mailing address' geographical state.

Example: "CA"
countrystring[ 0 .. 255 ] characters

The MSP-EC mailing address' country.

Example: "US"
postal_codestring[ 0 .. 255 ] characters

The MSP-EC mailing address' postal code.

Example: 95089
phone_numberstring[ 0 .. 255 ] characters

The MSP-EC's phone number.

Example: "650-123-4567"
fax_numberstring[ 0 .. 255 ] characters

The MSP-EC's fax number.

Example: "650-123-9999"
citystring[ 0 .. 255 ] characters

The MSP-EC mailing address' city.

Example: "Sunnyvale"
mapping_urlstring[ 0 .. 255 ] characters

The map URL corresponding to the MSP-EC's mailing address.

Example: "https//map.gogle.com/zsdweews"
service_effective_datestring

The date when the MSP-EC's service started.

Example: "2019-09-14 01:12:51Z"
service_expiration_datestring

The date when the MSP-EC's service terminates/terminated.

Example: "2020-09-14 01:12:51Z"
admin_emailstring[ 0 .. 255 ] characters

The email address of the first MSP-EC administrator added to the account by the MSP.

Example: "john.wang@sampledomain.com"
admin_firstnamestring[ 0 .. 64 ] characters

The first name of the first MSP-EC administrator added to the account by the MSP.

Example: "John"
admin_lastnamestring[ 0 .. 64 ] characters

The last name of the first MSP-EC administrator added to the account by the MSP.

Example: "Wang"
admin_rolestring[ 0 .. 255 ] characters

The admin role of the first MSP-EC administrator.

Example: "PRIME_ADMIN,ADMIN,READ_ONLY"
tenant_typestring[ 0 .. 25 ] characters

The tenant type of the MSP EC administrator.

Example: "MSP, MSP_INTEGRATOR, MSP_INSTALLER"
licensesobject(License)

License information for the account.

delegationsArray of objects(EcDelegation)unique

Grant or revoke access to tenants to manage the customer.

admin_delegationsArray of objects(MspAdminRole)unique

Grant or revoke access to admins to manage the customer.

tierstring

Service tier information for MSP-EC.

Example: "GOLD, PLATINUM"
{
  "account_id": "string",
  "name": "Acme Sales",
  "street_address": 350,
  "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": "john.wang@sampledomain.com",
  "admin_firstname": "John",
  "admin_lastname": "Wang",
  "admin_role": "PRIME_ADMIN,ADMIN,READ_ONLY",
  "tenant_type": "MSP, MSP_INTEGRATOR, MSP_INSTALLER",
  "licenses": {
    "trialAction": "ACTIVATE",
    "assignments": [ … ],
    "subscription_start_date": "string",
    "subscription_end_date": "string"
  },
  "delegations": [
    { … }
  ],
  "admin_delegations": [
    { … }
  ],
  "tier": "GOLD, PLATINUM"
}

Responses

Accepted

Body
requestIdstringrequired

Unique identifier for tracking the API request.

tenantIdstring

Tenant identifier associated with the request.

Response
{
  "requestId": "string",
  "tenantId": "string"
}

Send Administrator InvitationDeprecated

Request

Send or resend an email invitation to an administrator to access the tenant account. This method will be removed no sooner than 08/31/2026. The following URL put /tenants/{tenantId}/invitations can be used for this content.

Path
customerIdstringrequired

Tenant Id of the MSP EC account

Bodyapplication/jsonrequired
admin_emailstring[ 0 .. 255 ] charactersrequired

The email of the MSP-EC administrator.

Example: "john.wang@sampledomain.com"
resendboolean

Indicate if this is to resend in case of email got lost.

Example: true
application/json
{
  "admin_email": "john.wang@sampledomain.com",
  "resend": true
}

Responses

OK

Response
No content

Retrieve Brand Logo URLsDeprecated

Request

Retrieve download URLs for brand logo image files associated with the tenant. This method will be removed no sooner than 08/31/2026. The following URL GET /tenants/{tenantId} can be used for this content.

Path
customerIdstringrequired

MSP EC Tenant Id

No request payload

Responses

Ok

Bodyapplication/json
requestIdstringrequired

Unique identifier for tracking the API request.

tenantIdstring

Tenant identifier associated with the request.

Response
application/json
{
  "requestId": "string",
  "tenantId": "string"
}

Brand Customization

Manages branding customization for managed service provider accounts. Supports uploading logo images, configuring contact information and portal settings such as custom domain names and support URLs.

Operations

Deprecated

Operations