Play in-cab audible alert sound for device

POST

/devices/{device_id}/playaudible

A utility endpoint that will push a command to the camera to play an audible in-cab alert sound immediately upon receipt of the request.

Due to the asynchronous nature of this API, there is an expected network delay between submiting the request and the server sending the request to the camera. To help with this, a future date-time value can be passed into the expires parameter to set an expiration for the prompt so that if the request is received after this time, it will be ignored. This will prevent any potential confusion of the driver by playing an alert too long after the initial trigger event.

User Role Permissions

The following table shows which user roles are allowed to send requests using this API endpoint.

Role	Permission
Partner
Partner View
Custom Partner
Fleet Manager
Group Manager
User
Custom User

Request

Path Params

Body Params multipart/form-data

Responses

🟢202Success

application/json

Body

🟠400Device is offline/unavailable

🟠400Invalid datetime format

🟠401Login Required

🟠404Record not found

🟠404Resource Not Found

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/devices//playaudible' \
--form 'audible_type="chime"' \
--form 'expires="20250310171530"'

Response Example

202 - Success

{
    "meta": {
        "code": 202
    },
    "response": "play-audible request sent to device.",
    "result": "OK"
}

Modified at 2025-10-15 13:41:00

Search devices

Get list of trip dates for device

Play in-cab audible alert sound for device

User Role Permissions#

Request

Responses

User Role Permissions