---
title: "Update a job entry."
method: PUT
path: "/jobs/{jobID}"
tags: ["jobs"]
---

# Update a job entry.

`PUT /jobs/{jobID}`

Updates the status of a particular job.<br>
```
 0: Ready to deploy
10: Connecting to CIMC
11: Mounting installation ISO
15: Server is booting
16: Installer is running
17: Running final reboot
18: Running cleanup tasks
20: Finished
25: Cancelled
30: Error
31: Error: Failed to login to CIMC
32: Error: Failed to mount installation ISO
34: Error: ESXi Installed but SSH was not enabled
35: Error: No response after final reboot
```

## Path parameters

- `jobID` string, required

## Query parameters

- `state` integer, required

## Response `200`

OK

- JobStatus
  - `hostname` string
  - `host_ip` string
  - `cimcip` string
  - `start_time` string
  - `finish_time` string
  - `status` string
  - `macaddr` string
  - `netmask` string
  - `gateway` string

## Changes

- **2022-12-20** `3bbcae0c2c61` — 1 info
  - for the `query` request parameter `state`, the max was increased from `32.00` to `35.00`
- **2022-12-19** `3589a21876a9` — 1 warning, 4 info
  - removed the optional property `cimc_ip` from the response with the `200` status
  - added the optional property `cimcip` to the response with the `200` status
  - added the optional property `gateway` to the response with the `200` status
  - added the optional property `macaddr` to the response with the `200` status
  - …1 more
- **2022-09-29** `f44a5cd0e2db` — 1 warning, 1 info
  - removed the optional property `cimcip` from the response with the `200` status
  - added the optional property `cimc_ip` to the response with the `200` status
- **2022-09-29** `dbbd297a610d` — 1 warning, 1 info
  - removed the optional property `ipaddr` from the response with the `200` status
  - added the optional property `host_ip` to the response with the `200` status
- **2021-12-22** `13fb23422cbc` — 1 breaking, 4 warning, 1 info
  - for the `query` request parameter `state`, the max was decreased from `35.00` to `32.00`
  - removed the optional property `gateway` from the response with the `200` status
  - removed the optional property `host_ip` from the response with the `200` status
  - removed the optional property `macaddr` from the response with the `200` status
  - …2 more

[Change history](https://skmtc.dev/cisco/apis/esxi-autoinstaller/changes/jobs/:jobID/put.md)

---

[API](https://skmtc.dev/cisco/apis/esxi-autoinstaller.md) · [All operations](https://skmtc.dev/cisco/apis/esxi-autoinstaller/llms.txt) · [OpenAPI document](https://skmtc.dev/cisco/apis/esxi-autoinstaller/revisions/dd322ba65a09?raw)