Freight Accessorial Automatic Rate Update V1 Ep

POST 
/v1/freight/accessorial/automatic/rate/update

Update Automatic Accessorial Rate

Updates an existing rate in an automatic accessorial's rate schedule. This allows you to modify the rate value, effective dates, or other properties of a previously created rate. The existing rate is replaced with the updated values.

Required Scopes (if.w)

Request

accessorial_id: str
Internal identifier of the automatic accessorial containing the rate to update.

---

rate_id: str
Internal identifier of the specific rate to update.

---

effective_from_date: datetime
The date when this rate becomes effective. Will be truncated to the start of day.

---

rate: float
The rate value to apply. Will be rounded to 5 decimal places.

---

effective_to_date: datetime | None = None
Optional date when this rate expires. If not specified, the rate remains active until a new rate is scheduled.

Response

Returns the updated automatic accessorial object with all fields as described in the Automatic Accessorial Overview endpoint, including:

id: str
Internal identifier for the accessorial.

---

name: str
Name of the accessorial.

---

rate: float | None = None
The current active rate for this accessorial.

---

next_scheduled_rate: AccessorialRate | None = None
The next scheduled rate change, if any.

---

rates: list[AccessorialRateRow] = []
Complete history of rates including the updated rate, with their effective dates and status (active, scheduled, or expired).

---

All other fields as documented in the Automatic Accessorial Overview response.

Responses

200

Successful Response

422

Validation Error

application/json

Example (from schema)

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Loading...