Allocations API Version History

This page lists updates to the Allocations API.

Latest Version

Version 2.3.0: 26 September 2024

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

Previous Versions

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