Upload/Update Device Image

Upload or update a device image on your Traccar server.

DANGER

• This endpoint is uploading device images to your Traccar server but the image is not displayed on the Traccar UI web interface.
• We are investigating this issue.

IMPORTANT

• Only the following image types are supported: image/jpeg, image/png, image/gif, image/webp, image/svg+xml.
• Maximum image size is 512000 bytes (500 KB). Larger images will be rejected before the request is sent.

Usage (application)

use ThingsTelemetry\Traccar\Facades\Device;
use Illuminate\Http\UploadedFile;

// From a controller/form request, you typically receive an Illuminate\Http\UploadedFile
$uploaded = request()->file('image'); // instance of UploadedFile

// returns string like "device.png"
$filename = Device::updateImage(deviceId: 6, file: $uploaded);

You may also pass a string path:

$filename = Device::updateImage(
    deviceId: 6, 
    file: base_path('tests/fixtures/device.png')
);

Results

The response is a string representing the stored filename (e.g., device.png).

$filename; // 'device.png'

Validation

Before sending the request, Laravel validation ensures:

Field	Rules
device_id	required, integer, min:1
file	required, image, max:500 (KB). JPEG, PNG, GIF, WebP, or SVG images up to 500 KB (max 500 KB as enforced by File::image(allowSvg: true)->max(500)).

If validation fails, an Illuminate\Validation\ValidationException is thrown. Make sure to catch it.

Important Links

• Traccar API: Device Image