Skip to main content
PUT
/
trip
/
{trip_id}
Update trip
curl --request PUT \
  --url https://ctechnology.io/api/v2.2/trip/{trip_id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "deleted": true,
  "validation_score": 123,
  "name": "<string>",
  "driver": "<string>",
  "notes": "<string>",
  "fuel_manual_lt": 123,
  "visibility": "PUBLIC",
  "is_liked_by_me": true
}
'
{
  "header": {
    "api_version": "<string>",
    "status": "<string>",
    "message": "<string>",
    "permission_via": [
      {
        "permission": "<string>",
        "via": "me",
        "organization_id": "<string>"
      }
    ]
  },
  "data": {
    "id": "<string>",
    "vehicle_id": "<string>",
    "timestamp_start": "2023-11-07T05:31:56Z",
    "timestamp_end": "2023-11-07T05:31:56Z",
    "completed": true,
    "deleted": true,
    "valid": true,
    "validation_score": 123,
    "name": "<string>",
    "driver": "<string>",
    "image_rect_url": "<string>",
    "speed_max": 123,
    "speed_avg": 123,
    "distance_tot": 123,
    "distance_tot_gps": 123,
    "duration_tot": 123,
    "duration_cruising": 123,
    "battery_start_level_volt": 123,
    "battery_end_level_volt": 123,
    "visibility": "PUBLIC",
    "num_likes": 123,
    "timestamp_original_start": "2023-11-07T05:31:56Z",
    "timestamp_original_end": "2023-11-07T05:31:56Z",
    "on_land": true,
    "notes": "<string>",
    "fuel_manual_lt": 123,
    "distance_tot_can": 123,
    "distance_tot_odo": 123,
    "fuel_start_level_pct": 123,
    "fuel_start_level_lt": 123,
    "fuel_most_recent_pct": 123,
    "fuel_most_recent_vlt": 123,
    "fuel_used_pct": 123,
    "fuel_used_lt": 123,
    "fuel_num_refueled": 123,
    "fuel_refueled_pct": 123,
    "fuel_refueled_lt": 123,
    "fuel_avg_lt_per_100km": 123,
    "fuel_avg_pct_per_100km": 123,
    "start_energy_available_ah": 123,
    "end_energy_available_ah": 123,
    "continuous_energy_consumption_ah": 123,
    "start_energy_available_wh": 123,
    "end_energy_available_wh": 123,
    "continuous_energy_consumption_wh": 123,
    "start_energy_available_pct": 123,
    "end_energy_available_pct": 123,
    "continuous_energy_consumption_pct": 123,
    "n2k_operation_hours_tot": 123,
    "can_fuel_consumption_avg": 123,
    "can_fuel_consumption_max": 123,
    "can_fuel_consumption_tot": 123,
    "can_rpm_max": 123,
    "can_rpm_avg": 123,
    "is_liked_by_me": true
  }
}

Authorizations

​
Authorization
string
header
required

Note that the API key has to be sent as Token 123 where 123 is the key you received after logging in or by creating on the developer dashboard.

Path Parameters

​
trip_id
string
required

ID of trip to update.

Body

application/json

A single trip performed by a vehicle.

​
deleted
boolean

If this trip was deleted (by a user).

​
validation_score
number

A score in [0, 1] that describes the likelihood of this trip being valid. 1 means we are 100% confident this is a real trip, 0 means we are 100% confident this is not a real trip, but GPS / sensor noise.

​
name
string

The (user-given) name of this trip.

​
driver
string

The (user-given) driver name of this trip.

​
notes
string

(User-added) notes of this trip. Formatted using Markdown.

​
fuel_manual_lt
number

The amount the vehicle was refueled on this trip, as manually set by a user, in l (may be over 100%).

​
visibility
enum<string>

The visibility of this trip, e.g., if it is shared with the public or certain organizations, or kept for the user him-/herself.

Available options:
PUBLIC,
PRIVATE
​
is_liked_by_me
boolean

If the trip can be liked (is public or similar), this attribute is a short-hand to know if the currently logged in user him-/herself liked the trip.

Response

Successful update of this trip.

​
header
API Header Single · object
required

Default header sent along with single-resource responses.

​
data
Trip · object
required

A single trip performed by a vehicle.