Allocations API Version History
This page lists updates to the Allocations API.
Latest Version
Version 2.3.12: 04 December 2025
- The productName parameter now supports Open_MDR as a product name in all allocation endpoints.
Previous Versions
- 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.
- Updated endpoint to retrieve a list of all assets for your managed account:
/api/{v1}/{accountid}/assets/{resourceType}
For more information, see Get Device or Software License Allocation List.
- New endpoint to retrieve a hierarchy of all allocated assets for your managed and delegated accounts:
/api/{v1}/{accountid}/assetsAllocation
For more information, see Get Asset Allocation List for Managed and Delegated Accounts.
- Initial release.