Last updated: 12/3/2024 3:11:32 PM
Note
Note
Business role: Distributor (T1), ISP (T1), MSP (T2), and Reseller (T2)
This API enables partners to update a valid subscription for their customer.
All updates become effective immediately when request is processed successfully.
Tip
Tip
This API is available only for subscriptions with full version licenses.

Request

HTTP Request

[PUT] /LMPI/v2/customers/{customer_id}/subscriptions/{subscription_id}

Parameters

Name
Type
Description
Validation
Required Parameters
customer_id
string
The unique identifier of the customer company that the subscription belongs to.
GUID format
subscription_id
string
The unique identifier of the subscription you want to change.
GUID format

HTTP Request Example

[PUT] https://{lmpi-fqdn}/LMPI/v2/customers/34a159f6-240b-4f81-930b-4075c3f069f7/subscriptions/f81d2435-ec82-4a69-8d47-357bb0bd52c1

Request Body

{
  "units_per_license" : 80,
  "license_expiration_date" : "2014-11-30T14:59:59Z",
  "service_plan_id": "9eada398-cff2-41a7-9c5a-8ad21c96282b"
}
Name
Type
Description
Validation
Optional Parameters
units_per_license
integer
The new number of license units you want to provision for the specified subscription.
Positive integer (1-999,999)
license_expiration_date
date
The new expiration date of the license that you want to update for the specified subscription.
If the service plan satisfies one or more of the following conditions, you do not need to provide an expiration date:
  • The service plan is for a trial license.
  • The service plan is configured to activate when the customer first signs in to Customer Licensing Portal.
The new expiration date must be sooner than the current expiration date.
ISO 8601 standard with format "YYYY-MM-DDThh:mm:ssZ"
service_plan_id
string
The unique identifier of the new service plan you want to update for the specified subscription.
GUID format

Response

Response

If successful, this method returns an HTTP 200 OK status code and a response body with the following structure:
{
   "subscription_id": "f81d2435-ec82-4a69-8d47-357bb0bd52c1",
   "name": "WFBSS STD", 
   "enabled": true, 
   "is_auto_renewal": true, 
   "auto_renewal_month": 1, 
   "expiration_notification": 30, 
   "service_url": "https://clp.trendmicro.com/Dashboard?T=xxxxx", 
   "licenses": [{
        "ac_code": "CS-39UX-47UWF-QVUEV-W7EQX-TDE8W-VRUVM", 
        "product_id": "WFBSSVC", 
        "license_start_date": "2014-11-12T12:25:17Z",         
        "license_expiration_date": "2014-11-30T14:59:59Z",         
        "start_charge_date": "2014-11-12T12:25:17Z",
        "grace_period": 1, 
        "units": 80,
        "enabled": true}]
}
Name
Type
Description
Length
subscription_id
string
The unique identifier of the updated subscription.
GUID format
name
string
The display name of the service plan associated with the current subscription.
1-150 characters
enabled
boolean
The status of the current subscription.
true/false
is_auto_renewal
boolean
The status of automatic renewal.
Possible values include:
  • true: Automatic renewal is enabled
  • false: Automatic renewal is disabled
true/false
auto_renewal_month
integer
The number of months that automatic renewal is enabled for.
Positive integer (0-36)
expiration_notification
integer
The number of days until the approaching expiration reminder notification in Licensing Management Platform.
Note
Note
You can modify this setting when configuring the service plan.
Positive integer (1-30)
service_url
string
The URL of Customer Licensing Portal, where the customer can sign in for profile management and single sign-on to product websites.
0-300 characters
licenses[].ac_code
string
The license activation code.
Note
Note
For SaaS products and services, the license is activated through specific conditions, not via an activation code.
38 characters
licenses[].product_id
string
The code representing the specific product or service.
9 characters
licenses[].license_start_date
date
The start date and time of license activation.
ISO 8601 standard with format "YYYY-MM-DDThh:mm:ssZ"
licenses[].license_expiration_date
date
The date and time of license expiration.
After the license expiration date, the license grace period begins.
ISO 8601 standard with format "YYYY-MM-DDThh:mm:ssZ"
licenses[].start_charge_date
date
The date and time when the customer company begins to be charged for the license.
ISO 8601 standard with format "YYYY-MM-DDThh:mm:ssZ"
licenses[].grace_period
integer
The grace period of the license.
The grace periods represented by different values are as follows:
  • 1: 30 days
  • 2: 60 days
  • 3: 90 days
When a license expires, the license enters the grace period. During the grace period, customer still can renew license and preserve all preferred product settings. After the grace period ends, customer cannot continue to use service or directly renew license.
The grace periods of different products are as follows:
  • Cloud App Security: 30 days
  • Worry Free Business Security Service: 30 days
  • Hosted Email Service 2.0: N/A
Positive integer (1-3)
licenses[].units
integer
The number of license units that the current subscription provisions for.
Positive integer (1-999,999)
licenses[].enabled
boolean
The status of the activation code.
Possible values include:
  • true: License is activated
  • false: License is not activated
true/false