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

# Create a new Proxmox Installation job.

`POST /proxmox-jobs`

Take installation details as json payload and create Proxmox installation job per each host in 'hosts' list.<br>
Mandatory (minimal) input data parameters:
  - iso_image (Proxmox ISO)
  - root_pwd
  - host_gateway
  - cidr
  - installmethod (must be "cimc")
  - hosts list with {hostname, host_ip, cimc_ip}
  - cimc_pwd

cimc_usr defaults to "admin" if not supplied.

Refer to schema definition for all parameters and default values.

## Request body

- ProxmoxJobsNew — Submit new Proxmox installation job
  - `iso_image` string, required
  - `root_pwd` string, password, required
  - `installmethod` 'cimc', required
  - `cimc_usr` string
  - `cimc_pwd` string, password, required
  - `host_gateway` string, required
  - `cidr` string, required
  - `dns` string
  - `keyboard` string
  - `country` string
  - `timezone` string
  - `mailto` string, email
  - `filesystem` 'ext4' | 'xfs' | 'zfs' | 'btrfs'
  - `disk_list` string
  - `interface` string
  - `net_filter` 'ID_NET_NAME_SLOT' | 'ID_NET_NAME_PATH' | 'ID_NET_NAME_ONBOARD' | 'ID_VENDOR_ID' | 'ID_MODEL_ID' | 'ID_PATH' | 'ID_BUS' | 'ID_PCI_CLASS_FROM_DATABASE' | 'ID_PCI_SUBCLASS_FROM_DATABASE'
  - `custom_script` string — Optional custom bash script to run on first boot.
  - `hosts` object[], required
    - `hostname` string, required
    - `host_ip` string, required
    - `cimc_ip` string, required

## 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)