Documentation

POST /service/api/ecom/shop/trials/{keycode}/modules

Creates trial modules for a given parent keycode.

Request Information

URI Parameters

Name	Description	Type	Additional Information
keycode	The keycode of a parent console where trial module(s) should be created.	string	Required

URI Sample(s)

POST	https://unityapi.webrootcloudav.com/service/api/ecom/shop/trials/ADB477B8957B406F9955/modules

Body Parameters

Information about the trial(s) that should be created.

CreateModuleTrialRequestServiceModel

Name	Description	Type	Additional Information
Modules	Modules (e.g. DNS Protection or WSAT) for which trial licenses should be created.	Collection of CreateModuleTrialRequestServiceModel_Module	Required

Sample Request

{
  "Modules": [
    {
      "LicenseSeats": 813,
      "LicenseCategoryName": "SDNS",
      "VaultId": null,
      "ProductPlatformId": null
    },
    {
      "LicenseSeats": 340,
      "LicenseCategoryName": "SECA",
      "VaultId": null,
      "ProductPlatformId": null
    }
  ]
}

<CreateModuleTrialRequestServiceModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.ECom.Models">
  <Modules>
    <CreateModuleTrialRequestServiceModel_Module>
      <LicenseCategoryName>SDNS</LicenseCategoryName>
      <LicenseSeats>813</LicenseSeats>
      <ProductPlatformId i:nil="true" />
      <VaultId i:nil="true" />
    </CreateModuleTrialRequestServiceModel_Module>
    <CreateModuleTrialRequestServiceModel_Module>
      <LicenseCategoryName>SECA</LicenseCategoryName>
      <LicenseSeats>340</LicenseSeats>
      <ProductPlatformId i:nil="true" />
      <VaultId i:nil="true" />
    </CreateModuleTrialRequestServiceModel_Module>
  </Modules>
</CreateModuleTrialRequestServiceModel>

Response Information

Resource Description

Details about the newly created trial(s).

CreateModuleTrialResponseServiceModel

Name	Description	Type	Additional Information
LicenseId	A unique identifier for the license that was queried.	integer	None.
Keycode	Keycode identifying the license.	string	None.
ProductLineDescription	Description of the associated product line.	string	None.
ParentLicenseId	Unique identifier for the parent license.	integer	None.
ParentKeycode	The keycode for the parent license.	string	None.
ChildLicenseActivations	Number of activations in child licenses.	integer	None.
PartnerStartDate	Start date of the partner.	date	None.
Profile	A dictionary of profiles.	Dictionary of string [key] and CreateModuleTrialResponseServiceModel_LicenseProfile [value]	None.
Customer	The customer associated to this license.	CreateModuleTrialResponseServiceModel_Customer	None.

Sample Response

{
  "LicenseId": 166598618,
  "Keycode": "F84BE9B4D4A64395A2B6",
  "ProductLineDescription": "Webroot Business",
  "ParentLicenseId": 190742308,
  "ParentKeycode": "BB37DA2B8E6F4367B9C7",
  "ChildLicenseActivations": 6,
  "PartnerStartDate": "2022-06-19T07:22:59",
  "Profile": {
    "SAEP": {
      "LicenseCategoryName": "SAEP",
      "LicenseCategoryDescription": "Webroot Endpoint Protection",
      "LicenseSeats": 566,
      "LicenseKeycodeTypeId": 3,
      "StartDate": "2021-02-07T17:13:45",
      "ExpirationDate": "2024-11-20T22:42:03",
      "LicenseAttributeValue": null,
      "LicenseAttributeValueDescription": null,
      "LicenseAttributeDescription": null,
      "CategoryTypeName": "trial",
      "ItemHierarchyId": 1,
      "ItemHierarchyName": "primary",
      "LicenseStatusId": 0,
      "LicenseStatusDescription": "inactive",
      "UsagePricingModelId": null,
      "UsagePricingModelName": null,
      "UsageCheckDay": 15,
      "VaultId": null,
      "VaultName": null,
      "Vaults": null,
      "ProductPlatformId": null,
      "ProductPlatformName": null,
      "RetentionModelId": null,
      "RetentionModelName": null
    },
    "SDNS": {
      "LicenseCategoryName": "SDNS",
      "LicenseCategoryDescription": "Webroot DNS Protection",
      "LicenseSeats": 126,
      "LicenseKeycodeTypeId": 3,
      "StartDate": "2022-06-17T07:02:37",
      "ExpirationDate": "2025-02-28T11:07:32",
      "LicenseAttributeValue": null,
      "LicenseAttributeValueDescription": null,
      "LicenseAttributeDescription": null,
      "CategoryTypeName": "trial",
      "ItemHierarchyId": 2,
      "ItemHierarchyName": "secondary",
      "LicenseStatusId": 3,
      "LicenseStatusDescription": "manually disabled",
      "UsagePricingModelId": null,
      "UsagePricingModelName": null,
      "UsageCheckDay": 15,
      "VaultId": null,
      "VaultName": null,
      "Vaults": null,
      "ProductPlatformId": null,
      "ProductPlatformName": null,
      "RetentionModelId": null,
      "RetentionModelName": null
    }
  },
  "Customer": {
    "VendorCustomerCode": "89055"
  }
}

<CreateModuleTrialResponseServiceModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.ECom.Models">
  <ChildLicenseActivations>6</ChildLicenseActivations>
  <Customer>
    <VendorCustomerCode>89055</VendorCustomerCode>
  </Customer>
  <Keycode>F84BE9B4D4A64395A2B6</Keycode>
  <LicenseId>166598618</LicenseId>
  <ParentKeycode>BB37DA2B8E6F4367B9C7</ParentKeycode>
  <ParentLicenseId>190742308</ParentLicenseId>
  <PartnerStartDate>2022-06-19T07:22:59</PartnerStartDate>
  <ProductLineDescription>Webroot Business</ProductLineDescription>
  <Profile xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:KeyValueOfstringCreateModuleTrialResponseServiceModel_LicenseProfilefLvholdK>
      <d2p1:Key>SAEP</d2p1:Key>
      <d2p1:Value>
        <CategoryTypeName>trial</CategoryTypeName>
        <ExpirationDate>2024-11-20T22:42:03</ExpirationDate>
        <ItemHierarchyId>1</ItemHierarchyId>
        <ItemHierarchyName>primary</ItemHierarchyName>
        <LicenseAttributeDescription i:nil="true" />
        <LicenseAttributeValue i:nil="true" />
        <LicenseAttributeValueDescription i:nil="true" />
        <LicenseCategoryDescription>Webroot Endpoint Protection</LicenseCategoryDescription>
        <LicenseCategoryName>SAEP</LicenseCategoryName>
        <LicenseKeycodeTypeId>3</LicenseKeycodeTypeId>
        <LicenseSeats>566</LicenseSeats>
        <LicenseStatusDescription>inactive</LicenseStatusDescription>
        <LicenseStatusId>0</LicenseStatusId>
        <ProductPlatformId i:nil="true" />
        <ProductPlatformName i:nil="true" />
        <RetentionModelId i:nil="true" />
        <RetentionModelName i:nil="true" />
        <StartDate>2021-02-07T17:13:45</StartDate>
        <UsageCheckDay>15</UsageCheckDay>
        <UsagePricingModelId i:nil="true" />
        <UsagePricingModelName i:nil="true" />
        <VaultId i:nil="true" />
        <VaultName i:nil="true" />
        <Vaults i:nil="true" />
      </d2p1:Value>
    </d2p1:KeyValueOfstringCreateModuleTrialResponseServiceModel_LicenseProfilefLvholdK>
    <d2p1:KeyValueOfstringCreateModuleTrialResponseServiceModel_LicenseProfilefLvholdK>
      <d2p1:Key>SDNS</d2p1:Key>
      <d2p1:Value>
        <CategoryTypeName>trial</CategoryTypeName>
        <ExpirationDate>2025-02-28T11:07:32</ExpirationDate>
        <ItemHierarchyId>2</ItemHierarchyId>
        <ItemHierarchyName>secondary</ItemHierarchyName>
        <LicenseAttributeDescription i:nil="true" />
        <LicenseAttributeValue i:nil="true" />
        <LicenseAttributeValueDescription i:nil="true" />
        <LicenseCategoryDescription>Webroot DNS Protection</LicenseCategoryDescription>
        <LicenseCategoryName>SDNS</LicenseCategoryName>
        <LicenseKeycodeTypeId>3</LicenseKeycodeTypeId>
        <LicenseSeats>126</LicenseSeats>
        <LicenseStatusDescription>manually disabled</LicenseStatusDescription>
        <LicenseStatusId>3</LicenseStatusId>
        <ProductPlatformId i:nil="true" />
        <ProductPlatformName i:nil="true" />
        <RetentionModelId i:nil="true" />
        <RetentionModelName i:nil="true" />
        <StartDate>2022-06-17T07:02:37</StartDate>
        <UsageCheckDay>15</UsageCheckDay>
        <UsagePricingModelId i:nil="true" />
        <UsagePricingModelName i:nil="true" />
        <VaultId i:nil="true" />
        <VaultName i:nil="true" />
        <Vaults i:nil="true" />
      </d2p1:Value>
    </d2p1:KeyValueOfstringCreateModuleTrialResponseServiceModel_LicenseProfilefLvholdK>
  </Profile>
</CreateModuleTrialResponseServiceModel>