The following are upcoming changes to the Surfsight API may impact your use of the service.

• AI-12/AI-14 Connection Error Response Update

  
  Currently, our system returns a “500 Internal Server Error” when the AI-12/AI-14 connections between the tunnel and a device is lost due to a 30-second device timeout. We will be changing this to return a “417 Expectation Failed” status code for the following endpoints:

  • /devices/{imei}/cameras/{cameraId}/snapshot

  • /devices/{imei}/recording-ranges

• Error Handling for partner-bulk-add-devices

  
  We will be adding validations and specific error messages for device assignment failures. This includes a new error code (1007) and the message ("Device already assigned to this organization") when attempting to add a device already belonging to the specified organization. The existing error (1001) and message ("Device already assigned") will be returned if the device is assigned elsewhere.
  

• IMEI Validation for Audit Logs

  
  We will be implementing IMEI validation. If you attempt to retrieve audit logs using an invalid or non-existent IMEI, the system will return a “404 Not Found” error along with an informative message. Currently, an “Incorrect 200 OK” response is returned in such cases.
  

• Retiring APIs

  
  We will be sunsetting the email notification on or before September 2025. After this service is discontinued, the following APIs will be retired and might lead to breaking changes:

  • /rpc-send-alarms-report: 'Sends interval report to recipients'

  • /alarms: 'Create alarm'

  • /subscription: This function is used to save the GPS details of a given edge ID

  • /v1.1/devices/{serialNumber}/virtual-event': Triggers a given device to generate a

    virtual event

These changes will be implemented in the release scheduled for August 2025.

We understand that these changes may cause some disruption to your workflow, and we apologize for any inconvenience. If you have any questions or concerns, please reach out to your Technical Account Manager.

Thank you for your understanding and continued support.

NOTE: Lytx, Inc. owns the LYTX and SURFSIGHT trademarks and other related trademarks and logos. The TM or SM refer to a trademark or service mark, respectively, used by Lytx, Inc. The ® symbol refers to a trademark registered in the USA and elsewhere.