ConnectCloud Developers

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 country
  • validFrom (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 allowance
  • id (string, read-only): Id of the rate row
  • lunchPercent (integer): Cut for lunch (40)
  • mileageCentsPerKm (integer): Mileage allowance (used from the home country's rate)
  • overnightCents (integer): Lodging lump sum per night
  • partialDayCents (integer): Allowance of departure/return days and single days over 8 hours
  • version (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 country
  • validFrom (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 allowance
  • id (string, read-only): Id of the rate row
  • lunchPercent (integer): Cut for lunch (40)
  • mileageCentsPerKm (integer): Mileage allowance (used from the home country's rate)
  • overnightCents (integer): Lodging lump sum per night
  • partialDayCents (integer): Allowance of departure/return days and single days over 8 hours
  • version (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}'

View as Markdown · Interactive reference · OpenAPI