---
title: "Create a new ESXi Installation job."
method: POST
path: "/jobs"
tags: ["jobs"]
---

# Create a new ESXi Installation job.

`POST /jobs`

Take installation details as json payload and create installation job per each host in 'hosts' list.<br>
Mandatory (minimal) input data parameters:
  - iso_image
  - root_pwd
  - host_netmask
  - host_gateway
  - installmethod
  - hosts list
  - - if installmethod is "pxeboot" at least one entry with {hostname, host_ip, macaddr}
  - - if installmethod is "cimc" one entry with {hostname, host_ip, cimc_ip}

In addition, if installmethod is set to "cimc" then "cimc_pwd" is required.
cimc_usr defaults to "admin" if not supplied.

Refer to schema definition for all parameters and default values.

## Request body

- JobsNew — Submit new job
  - `iso_image` string, required
  - `root_pwd` string, password, required
  - `vlan` integer
  - `vmnic` integer
  - `firstdisk` 'firstdiskfound' | 'firstdisk' | 'diskpath'
  - `firstdisktype` 'local' | 'remote' | 'usb'
  - `diskpath` string
  - `enablessh` boolean
  - `clearpart` boolean
  - `installmethod` 'pxeboot' | 'cimc', required
  - `cimc_usr` string
  - `cimc_pwd` string, password
  - `host_netmask` string, required
  - `host_gateway` string, required
  - `dns1` string
  - `dns2` string
  - `static_routes` object[]
    - `subnet_ip` string, required
    - `cidr` integer, required
    - `gateway` string, required
  - `hosts` object[], required
    - `hostname` string, required
    - `host_ip` string, required
    - `macaddr` string
    - `cimc_ip` string

## Response `200`

Successful operation - return list of job IDs

- string[] — List of job IDs

## Other responses

- `400` — Failed operation, check returned error message for details

---

[API](https://skmtc.net/cisco/apis/esxi-autoinstaller.md) · [All operations](https://skmtc.net/cisco/apis/esxi-autoinstaller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cisco/esxi-autoinstaller/revisions/dd322ba65a09/schema)