> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargeapi.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a Driver

Updates a driver. Parameters you omit keep their current values.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.chargeapi.co/v1/drivers/drv_ETjCYs2UoLbMuKHS0CKfu8EUxXGMMj2V \
    -H "Authorization: Bearer ch_sk_test_..." \
    --json '{
    "phone": "+33189000029"
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
      "id": "drv_ETjCYs2UoLbMuKHS0CKfu8EUxXGMMj2V",
      "object": "driver",
      "created": "2026-04-01T00:36:43.890Z",
      "email": "example@example.com",
      "fleets": ["flt_grOWx6EexbLtcXYJiCsSmRVeA5r1rbEc"],
      "license_number": null,
      "metadata": {},
      "name": "Example Driver",
      "phone": "+33189000029",
      "policy_ids": ["pol_dhAZs1vmCVr8gAkknRkPzJQ5u8EMQwFh"],
      "preferences": {
          "charging_speed": "fast",
          "currency": "eur",
          "default_payment_method": null,
          "max_price_per_kwh": null,
          "notifications": true,
          "preferred_charging_stations": ["chst_uiIgEAEpjxf5JVAowpX8AUuhy2x3wAMd"],
          "preferred_cpos": ["example_operator"]
      },
      "status": "active",
      "updated": "2026-04-01T01:36:42.785Z",
      "vehicles": ["veh_6T4Jc2F3VnFFAPu6dpWop9lduX6iBAbu"],
      "wallet_balance": 1875
  }
  ```
</ResponseExample>

## Parameters

<ParamField body="email" type="string">
  Updated contact email.
</ParamField>

<ParamField body="name" type="string">
  Updated full name.
</ParamField>

<ParamField body="phone" type="string">
  Updated phone number.
</ParamField>

<ParamField body="status" type="string">
  Set driver status.

  Available options: `active`, `suspended`, `archived`
</ParamField>

## More parameters

<ParamField body="license_number" type="string">
  Driver's license number to store or update.
</ParamField>

<ParamField body="metadata" type="object">
  Set of key-value pairs that you can attach to an object.
</ParamField>

<ParamField body="preferences" type="object">
  Driver preferences for charging behavior and routing.

  <Expandable title="properties">
    <ParamField body="charging_speed" type="string">
      Preferred charging speed.
    </ParamField>

    <ParamField body="currency" type="string">
      Preferred currency for cost display and billing.
    </ParamField>

    <ParamField body="default_payment_method" type="string | null">
      Default payment method ID assigned to the driver.
    </ParamField>

    <ParamField body="max_price_per_kwh" type="integer | null">
      Optional upper limit on acceptable charging price, in the smallest currency unit per kWh.
    </ParamField>

    <ParamField body="notifications" type="boolean">
      Whether to receive notifications about charging status and session progress.
    </ParamField>

    <ParamField body="preferred_charging_stations" type="array of string">
      List of preferred charging station IDs.
    </ParamField>

    <ParamField body="preferred_cpos" type="array of string">
      List of preferred charging network (CPO) IDs.
    </ParamField>
  </Expandable>
</ParamField>

## Returns

Returns the updated driver.