API Updates for 25.6.0

Released 2025-06-17

The 25.6.0 release brings several important changes to the Forward Networks API, including new operations, scheduled deprecations, and refinements to models and responses. 

For a full list of changes and updates, check out the 25.6.0 Release Notes.

Scheduled Deprecations

Prepare for upcoming breaking changes in future releases:

• Release 25.7
  Legacy device credential APIs will be removed. Use the /cli-credentials and /http-credentials endpoints instead.

• Release 25.9

  • Legacy /deviceSources APIs will be removed in favor of /classic-devices.

  • Several legacy device access APIs tied to snapshot context are moving to more flexible network-level endpoints.

New API Endpoints

• Classic Devices (/classic-devices) – A unified way to manage legacy device sources.

• Device Tags (/device-tags) – Enables better organization and filtering of devices by custom tags.

• Moved Device Operations – New versions of device-related endpoints now accept an optional snapshotId query parameter.

New API Models

• Introduced models for Classic Devices and Device Tags to support the new APIs.

Model and Field Updates

• Timezone Formatting Fix: CollectionSchedule.timeZone values now follow standard formats (e.g., America/Los_Angeles).

• Device Model Enhancements:

  • New collectionError value: FILE_TRANSFER_FAILED

  • Renamed OS and platform values: aruba_cx_switch → aruba_aos_cx

• Similar renames for DeviceSource, MissingDevice, and Vulnerability resources to reflect Aruba platform updates.

Notable Internal Changes

• Unpublished API GET /api/networks/{networkId}/devices/status has been removed.

• Use the new ?with=testResult query param on device and endpoint queries to access connectivity test results.