> For the complete documentation index, see [llms.txt](https://tesla-api.timdorr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tesla-api.timdorr.com/vehicle/commands/softwareupdate.md).

# Software Updates

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

Schedules a software update to be installed, if one is available.

### Parameters

| Parameter   | Example | Description                                                                            |
| ----------- | ------- | -------------------------------------------------------------------------------------- |
| offset\_sec | 7200    | How many seconds in the future to schedule the update. Set to 0 for immediate install. |

### Response

```json
{
  "expected_duration_sec": 3000,
  "reason": "",
  "result": true,
  "scheduled_time_ms": 1685735308001,
  "status": "scheduled",
  "warning_time_remaining_ms": 120000
}
```

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

Cancels a software update, if one is scheduled and has not yet started.

### Response

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