Delete Device Positions in a Time Range

Delete all stored positions for a specific device within a given time span.

WARNING

Deleting positions is irreversible and can compromise reporting accuracy. Ensure you target the correct device and time range.

Usage

use Carbon\CarbonImmutable;
use ThingsTelemetry\Traccar\Dto\StatusData;
use ThingsTelemetry\Traccar\Enums\Status;
use ThingsTelemetry\Traccar\Facades\Position;

$deviceId = 6;

$from = CarbonImmutable::parse('2025-11-22T18:30:00Z');
$to   = CarbonImmutable::parse('2025-12-23T18:30:00Z');

// returns ThingsTelemetry\Traccar\Dto\StatusData
$result = Position::deleteForDeviceInRange(deviceId: $deviceId, from: $from, to: $to); 

if ($result->status === Status::SUCCESS) {
    // Successfully deleted positions in the given range
}

IMPORTANT

The from timestamp must be strictly before the to timestamp, otherwise a Illuminate\Validation\ValidationException will be thrown.

Results

The response is a ThingsTelemetry\Traccar\Dto\StatusData object containing a ThingsTelemetry\Traccar\Enums\Status.

$result->status->value; // 'success' or 'failure'
$result->status->name;  // 'SUCCESS' or 'FAILURE'
$result->status->label(); // 'Success' or 'Failure'

Important Links

• Traccar: Delete positions for a device and time range
• Status enum reference