Firebox Management API Version History

This page lists updates to the Firebox Management API.

Latest Version

Version 1.23.0: 15 August 2024

  • You can now specify a maximum of 50 devices in requests to enable, disable, and deploy global exceptions for these endpoints:
    • /v1/commands/{accountid}/global_exceptions/enable
    • /v1/commands/{accountid}/global_exceptions/disable
    • /v1/commands/{accountid}/deployments
  • API responses are updated for these endpoints:
    • /{v1}/commands/{accountid}/deployments

    • /{v1}/commands/{accountid}/transactions

    • /{v1}/commands/{accountid}/transactions/{objectid}

    • /{v1}/commands/{accountid}/transactions/{objectid}

    • /{v1}/commands/{accountid}/transactions/{objectid}

Previous Versions

  • The WebBlocker exception name parameter can now include only letters, numbers, spaces, parentheses "()", asterisks "*", periods ".", hyphens "-", and underscores "_".
  • The API specification now indicates that the WebBlocker exception name parameter has a maximum length of 58 characters.
  • Version 2 of these endpoints include new limit and start_after request parameters to support pagination:
    • /v2/configuration/{accountid}/exceptions
    • /v2/configuration/{accountid}/exceptions/blockedsite
    • /v2/configuration/{accountid}/exceptions/botnet
    • /v2/configuration/{accountid}/exceptions/file
    • /v2/configuration/{accountid}/exceptions/ips
    • /v2/configuration/{accountid}/exceptions/geolocation
    • /v2/configuration/{accountid}/exceptions/webblocker

    Version 1 of these GET endpoints are deprecated but continue to accept requests.

The device and devices request parameters now accept both integers and strings. For standalone Fireboxes, specify only the numbers from the device ID (12345). For FireClusters, specify the full device ID (FBCL-12345).

  • New endpoints to retrieve, update, and delete transactions:
    • /{v1}/commands/{accountid}/transactions
    • /{v1}/commands/{accountid}/transactions/{objectid}
    • /{v1}/commands/{accountid}/transactions/{objectid}

    For more information, see Deployments.

  • The description request body parameter is no longer required when you create or update an exception.
  • The maximum length of the name parameter for WebBlocker exceptions is now 63 characters (reduced from 127 characters). The parameter no longer has any pattern restrictions.
  • Updated pattern values in these schemas:
    • ipv4_address_string
    • ipv4_cidr_string
    • ipv4_range_type
    • fqdn_type
    • webblocker_exception_base
  • Initial Beta release.