---
name: proxmox-api
description: Make an authenticated Proxmox API call
user_invocable: true
arguments:
  - name: args
    description: "METHOD PATH [--json]"
    required: true
---

# Proxmox API Skill

Make an authenticated Proxmox API call with proper token handling.

## Steps

1. Run the helper script:
   ```bash
   /home/maarten/dev/incus-contrib/bin/helpers/proxmox-api {{args}}
   ```
2. Parse the JSON response
3. Present the results in a readable format

## Notes

- The helper handles the `!` in `automation@pve!deploy` safely
- Reads host and token ID from `proxmox.yaml`, secret from env file
- Add `--json` for pretty-printed output
- Common paths:
  - `/nodes/pve/qemu` -- list all VMs
  - `/nodes/pve/qemu/{vmid}/status/current` -- VM status
  - `/nodes/pve/status` -- host resources
  - `/cluster/resources` -- cluster-wide resources
  - `/pools/{pool}` -- pool members