> ## 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 Fleet

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

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

<ResponseExample>
  ```json Response theme={null}
  {
      "id": "flt_XnW9iZdHLG0utAlIy1niQrATnLtvAX5e",
      "object": "fleet",
      "address": {
          "city": "Paris",
          "country": "FR",
          "line1": "10 Rue de la Paix",
          "line2": "Batiment A",
          "postal_code": "75002",
          "state": "Ile-de-France"
      },
      "created": "2026-04-01T00:23:21.210Z",
      "description": "Updated fleet description.",
      "email": "example@example.com",
      "metadata": {},
      "metric_system": "international_system",
      "name": "Example Fleet",
      "phone": null,
      "policy_ids": ["pol_RUAtrKscpYb1eJAdtfZvXIYyuagqN5qE"],
      "preferences": {
          "billing_cycle": "monthly",
          "default_currency": "eur",
          "default_payment_method": null,
          "notifications": true,
          "report_frequency": "weekly"
      },
      "status": "active",
      "timezone": "Europe/Paris",
      "total_drivers": 24,
      "total_energy_consumed_kwh": 4825.4,
      "total_sessions": 186,
      "total_vehicles": 18,
      "updated": "2026-04-01T02:23:28.028Z",
      "wallet_balance": 32150
  }
  ```
</ResponseExample>

## Parameters

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

<ParamField body="name" type="string">
  New display name for the fleet.
</ParamField>

<ParamField body="status" type="string">
  Set the operational status of the fleet.

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

<ParamField body="timezone" type="string">
  Updated IANA timezone identifier.
</ParamField>

## More parameters

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

<ParamField body="metric_system" type="string">
  Updated preferred unit system.

  Available options: `international_system`, `us_customary_system`, `imperial_system`
</ParamField>

<ParamField body="preferences" type="object">
  Account-level settings related to billing, reporting, and charging activity.

  <Expandable title="properties">
    <ParamField body="billing_cycle" type="string">
      Frequency of billing for the fleet (`monthly`, `weekly`, etc.).
    </ParamField>

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

    <ParamField body="default_payment_method" type="string">
      ID of the default payment method to use for charging sessions.
    </ParamField>

    <ParamField body="notifications" type="boolean">
      Whether drivers in this fleet receive session status notifications.
    </ParamField>

    <ParamField body="report_frequency" type="string">
      Frequency of automated report delivery (`weekly`, `monthly`, etc.).
    </ParamField>
  </Expandable>
</ParamField>

## Returns

Returns the updated fleet.