Update Trip

PUT

/trip/{tripId}

Update trip information such as driver, vehicle assignments, and facility timestamps. The request is stored for processing.

operationStatus:

Cancellation (value cancelled): The trip will be cancelled and future cancellation status' received from Octopus integration are ignored.

If the assigned truck has a GPS device, the only value admitted is atRisk, and other values are silently ignored. When set, the value is overridden by any other transition triggered.

If the assigned truck does not have a GPS device, all possible values are admitted and other transitions not set by this endpoint are ignored.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Trip update request has been successfully processed and stored

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://fmsapi.deltax.la/clients/trip/0017228764' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "driverLicense": "DF001100131",
    "truckPlate": "83AH5N",
    "truckEconomicNumber": "TRUCK001",
    "trailerPlate": "TRAIL001",
    "originArrivalDate": "2024-01-15T10:30:00.000Z",
    "originEntryDate": "2024-01-15T10:35:00.000Z",
    "originLeftDate": "2024-01-15T11:00:00.000Z"
}'

Response Example

200 - Success

{
    "message": "Trip updated successfully",
    "data": {
        "tripId": "0017228764",
        "clientTripUpdate": {
            "_id": "507f1f77bcf86cd799439014",
            "status": "pending",
            "clientId": "507f1f77bcf86cd799439011",
            "clientCode": "CLIENT001",
            "tripId": "0017228764",
            "tripUpdateData": {
                "driverLicense": "DF001100131",
                "truckPlate": "83AH5N",
                "originArrivalDate": "2024-01-15T10:30:00.000Z"
            },
            "loadingOrderId": "507f1f77bcf86cd799439012",
            "created": "2024-01-15T10:30:00.000Z"
        }
    }
}

Modified at 2025-12-05 18:15:18

Get Trip by ID

Create Incidence