Allocations API Version History

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.

• 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.