Allocations API Version History

This page lists updates to the Allocations API.

Latest Version

Version 2.3.19: 17 September 2026

  • The date after which these endpoints no longer accept requests for accounts that do not have company name, industry, first name, last name, and full mailing address is now changed from 17 September 2026 to 15 October 2026:
    • /{v2}/{accountid}/assets
    • /{v2}/{accountid}/assets/productName/{productName}/allocationType/{allocationType}
    • /{v2}/{accountid}/assets/productName/{productName}/serialOrLicense/{serialOrLicense}

Previous Versions

  • Due to export license and regulatory requirements, these endpoints will no longer accept requests after 17 September 2026 for accounts that do not have company name, industry, first name, last name, and full mailing address:
    • /{v2}/{accountid}/assets
    • /{v2}/{accountid}/assets/productName/{productName}/allocationType/{allocationType}
    • /{v2}/{accountid}/assets/productName/{productName}/serialOrLicense/{serialOrLicense}
  • These productName values are renamed:
    • ThreatSyncPlus_NDR is now WatchGuard_NDR
    • ThreatSyncPlus_SaaSDR is now WatchGuard_SaaSDR
    • Compliance_Reporting is now WatchGuard_Compliance_Reporting
  • The resourceType value threatSyncPlus is replaced by ndr. The resourceType parameter also supports cloudDR.
  • The productName parameter now supports ThreatSync_Open as a product name in all allocation endpoints.
  • The resourceType parameter, now supports the threatSync resource type in these endpoints:
    • /{v2}/{accountid}/assets/summary/{resourceType}
    • /{v2}/{accountid}/assets/allocations/{resourceType}
    • /{v2}/{accountid}/assets/licenses/{resourceType}
    • /{v2}/{accountid}/assets/assigned/{resourceType}
  • The productName parameter now supports Cloud_DR as a product name in all allocation endpoints.
  • The productName parameter now supports these products in all allocation endpoints:
    • WES_Prime
    • WES_Module_Data_Retention
  • To allocate the WatchGuard Endpoint Security 1-Year Data Retention module licenses, the modules parameter now supports the WES_Module_Data_Retention license, in these allocation endpoints:

    • /{v2}/{accountid}/assets

    • /{v2}/{accountid}/assets/productName/{productName}/allocationType/{allocationType}

  • The productName parameter now supports NDR_for_Firebox as a product name in all allocation endpoints.
  • The productName parameter now supports Open_MDR as a product name in all allocation endpoints.
  • For the productName parameter, the Total_NDR product name replaces the Total_XDR product name in all allocation endpoints.
  • The productName parameter now supports FireCloud_TotalAccess as a product name in all allocation endpoints.
  • For the resourceType parameter, the fireCloud resource type replaces the fireCloudInternet resource type in these endpoints:
    • /{v2}/{accountid}/assets/summary/{resourceType}
    • /{v2}/{accountid}/assets/allocations/{resourceType}
    • /{v2}/{accountid}/assets/licenses/{resourceType}
    • /{v2}/{accountid}/assets/assigned/{resourceType}
  • The resourceType parameter now supports threatSyncPlus as a type of resource in these endpoints:
    • /{v2}/{accountid}/assets/summary/{resourceType}
    • /{v2}/{accountid}/assets/allocations/{resourceType}
    • /{v2}/{accountid}/assets/licenses/{resourceType}
    • /{v2}/{accountid}/assets/assigned/{resourceType}
  • The productName parameter now supports Total_XDR as a product name in all allocation endpoints.
  • The productName parameter now supports Total_XDR as a product name in all allocation endpoints.
  • Minor updates and bug fixes
  • The resourceType parameter now supports managedServices as a type of resource in these endpoints:
    • /{v2}/{accountid}/assets/summary/{resourceType}
    • /{v2}/{accountid}/assets/allocations/{resourceType}
    • /{v2}/{accountid}/assets/licenses/{resourceType}
    • /{v2}/{accountid}/assets/assigned/{resourceType}
  • The productName parameter now supports MDR_CORE_Microsoft as a product name in all allocation endpoints.
  • The resourceType parameter now supports fireCloudInternet as a type of resource in these endpoints:
    • /{v2}/{accountid}/assets/summary/{resourceType}
    • /{v2}/{accountid}/assets/allocations/{resourceType}
    • /{v2}/{accountid}/assets/licenses/{resourceType}
    • /{v2}/{accountid}/assets/assigned/{resourceType}
  • The productName parameter now supports FireCloud_InternetAccess as a product name in all allocation endpoints.
  • The resourceType parameter now supports threatsyncSdr as a type of resource in these endpoints:
    • /{v2}/{accountid}/assets/summary/{resourceType}
    • /{v2}/{accountid}/assets/allocations/{resourceType}
    • /{v2}/{accountid}/assets/licenses/{resourceType}
    • /{v2}/{accountid}/assets/assigned/{resourceType}
  • The productName parameter now supports ThreatSyncPlus_SaaSDR as a product name in all allocation endpoints.
  • The quantity parameter is now optional in the request body of this endpoint:
    • /{v2}/{accountid}/assets/productName/{productName}/allocationType/{allocationType}
  • The allocationType parameter now supports linked_to_license as a type of allocation in requests to these endpoints:
    • /{v2}/{accountid}/assets
    • /{v2}/{accountid}/assets
    • /{v2}/{accountid}/assets/productName/{productName}/allocationType/{allocationType}
  • The response of this endpoint now includes the list of available term licenses that you can allocate to managed accounts as Linked to License allocations:
    • /{v2}/{accountid}/assets/summary/{resourceType}
  • The licenseType parameter in the response of these endpoints now supports Linked to License as a type of allocation:
    • /{v2}/{accountid}/assets/summary/{resourceType}
    • /{v2}/{accountid}/assets/allocations/{resourceType}
    • /{v2}/{accountid}/assets/licenses/{resourceType}
    • /{v2}/{accountid}/assets/assigned/{resourceType}
  • To update the allocation type to Linked to License, you can now specify the serialorLicense parameter in the request body of this endpoint:
    • /{v2}/{accountid}/assets/productName/{productName}/allocationType/{allocationType}
  • The productName parameter now supports these products:
    • Compliance_Reporting
    • ThreatSyncPlus_NDR
  • The resourceType parameter now supports these licenses:
    • complianceReporting
    • threatsyncNdr
  • For software products, these endpoints now include a usage response parameter, which shows the number of users or endpoints used by the account:
    • /{v2}/{accountid}/assets/summary/{resourceType}
    • /{v2}/{accountid}/assets/allocations/{resourceType}
  • Added support for WatchGuard MDR.
  • You can no longer use POST or PUT endpoints to create or update allocations with an allocation type of mixed.
  • You can now use the Allocations API to allocate and manage Advanced EPDR licenses.
  • GET endpoints now return allocation information for NFR licenses.
  • Version 2.0.0 of the Allocations API includes these new endpoints:
    • /{v2}/{accountid}/assets — Allocates an asset
    • /{v2}/{accountid}/assets — Deallocates an asset
    • /{v2}/{accountid}/assets/productName/{productName}/allocationType/{allocationType} — Updates an existing software allocation
    • /{v2}/{accountid}/assets/productName/{productName}/serialOrLicense/{serialOrLicense} — Updates an existing hardware allocation
    • /{v2}/{accountid}/assets/summary/{resourceType} — Gets an inventory summary for a Service Provider account
    • /{v2}/{accountid}/assets/allocations/{resourceType} — Gets a list of assets allocated to accounts managed by a Service Provider
    • /{v2}/{accountid}/assets/licenses/{resourceType} — Get a list of assets owned by a specific account
    • /{v2}/{accountid}/assets/assigned/{resourceType} — Gets a list of assets allocated to a specific account
  • Version 1 of the Allocations API is deprecated. Although version 1 endpoints continue to accept requests, we strongly recommend that you use version 2 of the Allocations API.
  • Initial release.