diff --git a/docs/resources/virtual_environment_vm.md b/docs/resources/virtual_environment_vm.md
index 63a0a5bf..0dd16eb6 100644
--- a/docs/resources/virtual_environment_vm.md
+++ b/docs/resources/virtual_environment_vm.md
@@ -290,7 +290,9 @@ output "ubuntu_vm_public_key" {
 - `hostpci` - (Optional) A host PCI device mapping (multiple blocks supported).
     - `device` - (Required) The PCI device name for Proxmox, in form
       of `hostpciX` where `X` is a sequential number from 0 to 3.
-    - `id` - (Optional) The PCI device ID. Use either this or `mapping`.
+    - `id` - (Optional) The PCI device ID. This parameter is not compatible
+      with `api_token` and requires the root `username` and `password`
+      configured in the proxmox provider. Use either this or `mapping`.
     - `mapping` - (Optional) The resource mapping name of the device, for
       example gpu. Use either this or `id`.
     - `mdev` - (Optional) The mediated device ID to use.