---
title: "UPDATE a specific driver"
method: POST
path: "/v1/drivers/{uuid}"
tags: ["Drivers"]
---

# UPDATE a specific driver

`POST /v1/drivers/{uuid}`

Post a map of key value pairs for fields with the new value. A value of `null` is accepted (where marked as nullable) and will clear that field. Cleared fields will not be shown in the response, as `null` fields are stripped by default. If a field is not present in the map it will not be altered. **Fields not marked as nullable can be left out of the map all together so as not to be changed**

## Path parameters

- `uuid` string, uuid, required

## Request body

- DriverUpdateApiParams
  - `startDate` string, date, nullable
  - `organizationUuid` string, uuid
  - `gender` 'MALE' | 'FEMALE', nullable
  - `firstName` string
  - `middleName` string, nullable
  - `lastName` string
  - `emailWork` string, nullable — A valid email address.
  - `emailPrivate` string, nullable — A valid email address.
  - `phoneNumber` PhoneNumberDto
    - `number` string — A valid phone number.
    - `country` string — ISO 3166-1 Alpha-2 country code
  - `mobilePhoneNumber` PhoneNumberDto
    - `number` string — A valid phone number.
    - `country` string — ISO 3166-1 Alpha-2 country code
  - `notificationChannel` 'EMAIL' | 'SMS', nullable
  - `address` string, nullable
  - `zipCode` string, nullable
  - `city` string, nullable
  - `country` string, nullable — ISO 3166-1 Alpha-2 country code
  - `language` string, nullable — ISO 639-1 Language Code
  - `nationality` string, nullable — ISO 3166-1 Alpha-2 country code
  - `placeOfBirth` string, nullable
  - `birthDate` string, date, nullable
  - `internalId` string, nullable
  - `costCenter` string, nullable
  - `subCompany` string, nullable
  - `department` string, nullable
  - `location` string, nullable
  - `comment` string, nullable
  - `distanceToWorkplace` number, nullable
  - `employeePayment` number, nullable

## Response `200`

Successful operation.

- DriverDto
  - `uuid` string, uuid
  - `state` 'ACTIVE' | 'INACTIVE' | 'LEAVE'
  - `startDate` string, date
  - `gender` 'MALE' | 'FEMALE'
  - `firstName` string
  - `middleName` string
  - `lastName` string
  - `emailWork` string — A valid email address.
  - `emailWorkType` 'MANUAL' | 'AUTOMATIC'
  - `emailPrivate` string — A valid email address.
  - `phoneNumber` PhoneNumberDto
    - `number` string — A valid phone number.
    - `country` string — ISO 3166-1 Alpha-2 country code
  - `mobilePhoneNumber` PhoneNumberDto
    - `number` string — A valid phone number.
    - `country` string — ISO 3166-1 Alpha-2 country code
  - `notificationChannel` 'EMAIL' | 'SMS'
  - `address` string
  - `zipCode` string
  - `city` string
  - `country` string — ISO 3166-1 Alpha-2 country code
  - `language` string — ISO 639-1 Language Code
  - `nationality` string — ISO 3166-1 Alpha-2 country code
  - `placeOfBirth` string
  - `birthDate` string, date
  - `internalId` string
  - `costCenter` string
  - `subCompany` string
  - `department` string
  - `location` string
  - `comment` string
  - `distanceToWorkplace` number
  - `employeePayment` number
  - `eligibleForDriverBriefings` boolean
  - `eligibleForDriverLicenseChecks` boolean
  - `managementType` 'MANUAL' | 'AUTOMATIC'
  - `customFieldValuesByCategory` CustomFieldCategoryWithValuesDto[]
    - `uuid` string, uuid
    - `name` string
    - `position` integer
    - `customFieldValues` CustomFieldValueDto[]
      - `uuid` string, uuid
      - `textValue` string
      - `dateValue` string, date-time
      - `booleanValue` boolean
      - `integerValue` integer
      - `decimalValue` number
      - `monetaryAmountValue` MonetaryAmountDto
        - `amount` number
        - `currency` string — ISO 4217 alphabetic currency code
  - `organizationUuid` string, uuid

## Other responses

- `400` — Bad request - information on the invalid fields will be provided in the response body
- `404` — Driver not found.

---

[API](https://skmtc.net/avrios/apis/fleet-api-specifications.md) · [All operations](https://skmtc.net/avrios/apis/fleet-api-specifications/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avrios/fleet-api-specifications/revisions/78fc4b609513/schema)