# Climate

Commands related to the climate control (HVAC) system.

## POST `/api/1/vehicles/{id}/command/auto_conditioning_start`

Start the climate control (HVAC) system. Will cool or heat automatically, depending on set temperature.

### Parameters

| Body Parameter   | Example  | Description                                               |
| ---------------- | -------- | --------------------------------------------------------- |
| manual\_override | socdoors | Optional, to override the low\_soc failure reason (<20%). |

### Example

```json
{
  "manual_override": "socdoors"
}
```

### Response

```json
{
  "reason": "",
  "result": true
}
```

## POST `/api/1/vehicles/{id}/command/auto_conditioning_stop`

Stop the climate control (HVAC) system.

### Response

```json
{
  "reason": "",
  "result": true
}
```

## POST `/api/1/vehicles/{id}/command/set_temps`

Sets the target temperature for the climate control (HVAC) system.

Note: Despite accepting two parameters, only the `driver_temp` will be used to set the target temperature, unless the "split" option is activated within the climate controls menu.

Note: The parameters are always in celsius, regardless of the region the car is in or the display settings of the car.

### Parameters

| Parameter       | Example | Description                                                 |
| --------------- | ------- | ----------------------------------------------------------- |
| driver\_temp    | 23.4    | The desired temperature on the driver's side in celsius.    |
| passenger\_temp | 23.4    | The desired temperature on the passenger's side in celsius. |

### Response

```json
{
  "reason": "",
  "result": true
}
```

## POST `/api/1/vehicles/{id}/command/set_preconditioning_max`

Toggles the climate controls between Max Defrost and the previous setting.

### Parameters

| Parameter | Example | Description                         |
| --------- | ------- | ----------------------------------- |
| on        | true    | True to turn on, false to turn off. |

### Response

```json
{
  "reason": "",
  "result": true
}
```

## POST `/api/1/vehicles/{id}/command/remote_seat_heater_request`

Sets the specified seat's heater level.

### Parameters

| Parameter | Example | Description                             |
| --------- | ------- | --------------------------------------- |
| heater    | 0       | The desired seat to heat. (0-5)         |
| level     | 3       | The desired level for the heater. (0-3) |

The `heater` parameter maps to the following seats:

| Number | Seat        |
| ------ | ----------- |
| 0      | Front Left  |
| 1      | Front right |
| 2      | Rear left   |
| 4      | Rear center |
| 5      | Rear right  |

### Response

```json
{
  "reason": "",
  "result": true
}
```

## POST `/api/1/vehicles/{id}/command/remote_seat_cooler_request`

Sets the specified seat's cooler level. (Refresh Model S & X)

### Parameters

These parameters need to be passed via the post body as `JSON`.

| Body Parameter      | Example | Description                             |
| ------------------- | ------- | --------------------------------------- |
| seat\_position      | 0       | The desired seat to cool. (0-5)         |
| seat\_cooler\_level | 3       | The desired level for the cooler. (0-3) |

The `seat_position` parameter maps to the following seats:

| Number | Seat        |
| ------ | ----------- |
| 0      | Front Left  |
| 1      | Front right |
| 2      | Rear left   |
| 4      | Rear center |
| 5      | Rear right  |

### Example

```json
{
  "seat_position": 0,
  "seat_cooler_level": 3
}
```

### Response

```json
{
  "reason": "",
  "result": true
}
```

## POST `/api/1/vehicles/{id}/command/remote_steering_wheel_heater_request`

Turn steering wheel heater on or off.

### Parameters

| Parameter | Example | Description                         |
| --------- | ------- | ----------------------------------- |
| on        | true    | True to turn on, false to turn off. |

### Response

```json
{
  "reason": "",
  "result": true
}
```

## POST `/api/1/vehicles/{id}/command/set_bioweapon_mode`

Enable or disable Bioweapon Defense Mode.

### Request

This endpoint requires json in the post body, with the singular parameter `on` which is either `true` or `false`. This endpoint will respond with the `result` as `true` even with no parameters or body specified.

```json
{
  "on": "true"
  "manual_override": "true"
}
```

### Response

```json
{
  "reason": "",
  "result": true
}
```

## POST `/api/1/vehicles/{id}/command/set_climate_keeper_mode`

Set the Climate Keeper mode.

### Request

This endpoint requires json in the post body, with the singular parameter `climate_keeper_mode` and a number as the value. Those map to the values below.

| Number | Mode         |
| ------ | ------------ |
| 0      | Off          |
| 1      | On - Default |
| 2      | Dog Mode     |
| 3      | Camp Mode    |

### Example

```json
{
  "climate_keeper_mode": 0
}
```

### Response

```json
{
  "reason": "",
  "result": true
}
```

## POST `/api/1/vehicles/{vehicle_id}/command/remote_auto_seat_climate_request`

Enables/disables Automatic Seat Climate on the specified seat.

### Parameters

These parameters need to be passed via the post body as `JSON`.

| Body Parameter       | Example | Description                              |
| -------------------- | ------- | ---------------------------------------- |
| auto\_seat\_position | 0       | The desired seat for auto climate. (0-5) |
| auto\_climate\_on    | true    | `true` to enable and `false` to disable. |

The `auto_seat_position` parameter maps to the following seats:

| Number | Seat        |
| ------ | ----------- |
| 0      | Front Left  |
| 1      | Front right |
| 2      | Rear left   |
| 4      | Rear center |
| 5      | Rear right  |

### Example

```json
{
  "auto_seat_position": 0,
  "auto_climate_on": "true"
}
```

### Response

```json
{
  "reason": "",
  "result": true
}
```

## POST `/api/1/vehicles/{vehicle_id}/command/set_cop_temp`

Sets the Cabin Overheat Protection (COP) temperature.

{% hint style="info" %}
This endpoint appears to be in progress and is not yet fully functional/disabled as of now (12-13-2022, MDY).
{% endhint %}

### Parameters

These parameters need to be passed via the post body as `JSON`.

| Body Parameter | Example | Description                                                |
| -------------- | ------- | ---------------------------------------------------------- |
| temp           | 40      | The COP temperature in Celcius (name is subject to change) |

### Example

```json
{
  "temp": "40"
}
```

### Response

```json
{
  "reason": "",
  "result": true
}
```

## POST `/api/1/vehicles/{vehicle_id}/command/set_cabin_overheat_protection`

Turns on the Cabin Overheat Protection (COP) and sets its mode.

### Parameters

These parameters need to be passed via the post body as `JSON`.

| Body Parameter | Example | Description                                    |
| -------------- | ------- | ---------------------------------------------- |
| on             | true    | Turns COP on/off.                              |
| fan\_only      | true    | Use only the fans, do not use/turn on HVAC/AC. |

### Example

```json
{
  "on": true,
  "fan_only": true
}
```

### Response

```json
{
  "reason": "",
  "result": true
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tesla-api.timdorr.com/vehicle/commands/climate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.