Breaking changes

Breaking changes are changes that will cause existing integrations and functionality to break unless you take remedial action.

  • API Date/Time Fields Standardized to UTC Format: All API endpoints now return date/time fields in standardized UTC format instead of local server time or mixed time zone formats.
    New Format
    • UTC Format: YYYY-MM-DD HH:mm:ss[.sss]Z
    • Time Zone: UTC+0 (GMT)
    • Example: 2025-01-15 14:30:25.123Z

    Applications consuming API responses that contain date/time fields must be updated to handle the new UTC format.

    Action Required
    • Review your integrations: Identify any code that processes date/time fields from BlackBerry AtHoc API responses.
    • Update date parsing logic: Modify your applications to expect and parse UTC formatted timestamps.
    • Test with different time zones: Verify your applications correctly handle UTC timestamps regardless of your organization time zone settings.
    This change affects all date/time fields returned by any BlackBerry AtHoc API endpoint, including but not limited to:
    • Created dates
    • Modified dates
    • Scheduled dates
    • Event timestamps
  • Weather type updates in weather alert rules: The following weather types were added:
    • 911 Telephone Outage
    • Blue Alert
    • Cold Weather Advisory
    • Evacuation Immediate
    • Extreme Heat Warning
    • Extreme Heat Watch
    • Tropical Cyclone Local Statement
    The following weather types were removed:
    • 911 Telephone Outage Emergency
    • Arroyo And Small Stream Flood Advisory
    • Blizzard Watch
    • Evacuation- Immediate
    • Excessive Heat Warning
    • Excessive Heat Watch
    • Freezing Rain Advisory
    • Hard Freeze Warning
    • Hard Freeze Watch
    • Hurricane Local Statement
    • Hydrologic Advisory
    • Lake Effect Snow Advisory
    • Lake Effect Snow Watch
    • Small Craft Advisory for Hazardous Seas
    • Small Craft Advisory for Rough Bar
    • Small Craft Advisory for Winds
    • Small Stream Flood Advisory
    • Tropical Depression Local Statement
    • Tropical Storm Local Statement
    • Typhoon Local Statement
    • Urban and Small Stream Flood Advisory
    • Wind Chill Advisory
    • Wind Chill Warning
    • Wind Chill Watch