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

# Set Default Units

Sets default units for resources (electricity, water, gas, waste, fuel, district heating, or currency) for user.

### Request Params

*None*

### Request Body

<ParamField path="units" type="object">
  An object specifying the default units for various resources / currency. The units must be on this list and in the specified abbreviation.
</ParamField>

<ParamField path="units.electricity" type="string">
  Default unit for electricity (e.g., kwh, mwh).
</ParamField>

<ParamField path="units.water" type="string">
  Default unit for water (e.g., gal, liters).
</ParamField>

<ParamField path="units.gas" type="string">
  Default unit for gas (e.g., cubic meters, therms).
</ParamField>

<ParamField path="units.waste" type="string">
  Default unit for waste (e.g., kilograms, tons).
</ParamField>

<ParamField path="units.fuel" type="string">
  Default unit for fuel (e.g., liters, gallons).
</ParamField>

<ParamField path="units.district_heating" type="string">
  Default unit for district heating (e.g., kWh, MWh).
</ParamField>

#### Approved Unit Abbreviations

af

btu

ccf

cgal

cubic yards

dekatherms

ft3

ft^3

ft³

gal

gigaliters

gj

hcf

kbtu

kcf

kcm

kgal

kj

l

liters

m3

m^3

mcf

megaliters

mgal

milliliters

mj

mmbtu

m³

tgal

therms

aed

ars

aud

bdt

canadian dollar

clp

cop

dkk

dollar

egp

euro

franc

hkd

idr

inr

mxn

myr

nok

nzd

pen

php

pkr

pound

real

rub

sar

sek

sgd

thb

try

vnd

won

yen

yuan

zar

barrel

metric ton

mg

tons

ton hours

gwh

mbtu

dth

kwh

mwh

ton

### Response

*None*
