Change allowance rates (hr:travel:manage)
PUT /api/hr/v1/travel-rates/{id}
Module: HR · operationId: updateTravelRate · Tag: Travel expenses · Auth: access token (Authorization: Bearer <accessToken>)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string (uuid) | yes |
Request body
application/json (required)
country(string, required): ISO 3166-1 alpha-2 code of the countryvalidFrom(string (date), required): First day the rates apply (YYYY-MM-DD)breakfastPercent(integer): Cut for breakfast in percent of the full-day rate (20)dinnerPercent(integer): Cut for dinner (40)fullDayCents(integer): 24-hour allowanceid(string, read-only): Id of the rate rowlunchPercent(integer): Cut for lunch (40)mileageCentsPerKm(integer): Mileage allowance (used from the home country's rate)overnightCents(integer): Lodging lump sum per nightpartialDayCents(integer): Allowance of departure/return days and single days over 8 hoursversion(integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
Example:
{
"breakfastPercent": 20,
"country": "AT",
"dinnerPercent": 40,
"fullDayCents": 5000,
"id": "2b4d6f8b-0d2f-4b4d-8f6b-0d2f4b6d8f42",
"lunchPercent": 40,
"mileageCentsPerKm": 30,
"overnightCents": 11700,
"partialDayCents": 3300,
"validFrom": "2026-01-01",
"version": 1
}
Responses
- 200 Saved (
application/json) - 400 Error (
application/json) - 403 Error (
application/json) - 409 Error (
application/json)
Fields of the 200 answer:
country(string, required): ISO 3166-1 alpha-2 code of the countryvalidFrom(string (date), required): First day the rates apply (YYYY-MM-DD)breakfastPercent(integer): Cut for breakfast in percent of the full-day rate (20)dinnerPercent(integer): Cut for dinner (40)fullDayCents(integer): 24-hour allowanceid(string, read-only): Id of the rate rowlunchPercent(integer): Cut for lunch (40)mileageCentsPerKm(integer): Mileage allowance (used from the home country's rate)overnightCents(integer): Lodging lump sum per nightpartialDayCents(integer): Allowance of departure/return days and single days over 8 hoursversion(integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
Example 200 answer:
{
"breakfastPercent": 20,
"country": "AT",
"dinnerPercent": 40,
"fullDayCents": 5000,
"id": "2b4d6f8b-0d2f-4b4d-8f6b-0d2f4b6d8f42",
"lunchPercent": 40,
"mileageCentsPerKm": 30,
"overnightCents": 11700,
"partialDayCents": 3300,
"validFrom": "2026-01-01",
"version": 1
}
Example request
curl -X PUT 'https://api.mbcom.cloud/api/hr/v1/travel-rates/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"breakfastPercent":20,"country":"AT","dinnerPercent":40,"fullDayCents":5000,"id":"2b4d6f8b-0d2f-4b4d-8f6b-0d2f4b6d8f42","lunchPercent":40,"mileageCentsPerKm":30,"overnightCents":11700,"partialDayCents":3300,"validFrom":"2026-01-01","version":1}'