Add VM inventory CSV endpoint to api-ref docs

Signed-off-by: Mihaela Balutoiu <mbalutoiu@cloudbasesolutions.com>

Author: mihaelabalutoiu

coriolis/api-refs/api_samples/endpoint/endpoint-inventory-resp.csv

@@ -0,0 +1,3 @@
+vm_id,vm_name,guest_id,firmware,num_cpu,memory_mb,nested_virtualization,dynamic_memory_enabled,secure_boot,os_type,disks,nics,boot_order,hostname,parent_vapp,host,power_state
+4cb7e5e1-d3c4-4b0a-8742-f2b1b3d9a1c2,web-server-01,ubuntu64Guest,efi,4,8192,False,True,False,linux,100GB; 50GB,Network adapter 1|00:50:56:aa:bb:cc|VM Network|10.0.0.10,,,web-server-01,,esxi-host-01.example.com,poweredOn
+9fa23b11-7e2a-4c10-a3f8-0d1e2f3c4a5b,db-server-01,windows9Server64Guest,bios,8,16384,False,False,False,windows,200GB; 100GB,Network adapter 1|00:50:56:aa:cc:dd|VM Network|10.0.0.20,,db-vapp,db-server-01,esxi-host-02.example.com,poweredOn

coriolis/api-refs/source/endpoint.inc

@@ -325,6 +325,64 @@ Response
   .. literalinclude:: ../api_samples/endpoint/endpoint-instance-show-resp.json
      :language: javascript
 
+Get Endpoint VM Inventory
+=========================
+
+.. rest_method:: GET /endpoints/{endpoint_id}/inventory
+
+Exports the full VM inventory of an endpoint as a CSV file. 
+
+**Preconditions**
+
+The endpoint must exist and the platform must support inventory export.
+
+Normal response codes: 200
+
+Error response codes: unauthorized(401), forbidden(403),
+itemNotFound(404)
+
+Request
+-------
+
+.. rest_parameters:: parameters.yaml
+
+   - endpoint_id : endpoint_id_path
+   - env : inventory_source_env
+
+Response
+--------
+
+The response body is a UTF-8 encoded CSV file with the following columns:
+
+- **vm_id** – Unique identifier (UUID) of the VM.
+- **vm_name** – Display name of the VM.
+- **guest_id** – Raw VMware guest OS identifier (e.g. ``ubuntu64Guest``).
+- **firmware** – Firmware type (``bios`` or ``efi``).
+- **num_cpu** – Number of vCPUs.
+- **memory_mb** – Memory in megabytes.
+- **nested_virtualization** – Whether nested virtualisation is enabled.
+- **dynamic_memory_enabled** – Whether dynamic memory is enabled.
+- **secure_boot** – Whether EFI Secure Boot is enabled.
+- **os_type** – Coriolis-normalised OS type (e.g. ``linux``, ``windows``).
+- **disks** – Semicolon-separated list of disk sizes (e.g. ``100GB; 50GB``).
+- **nics** – Semicolon-separated list of NIC entries, each formatted as
+  ``label|mac[|network[|ip1,ip2,...]]``.
+- **boot_order** – Semicolon-separated boot device list. May be empty if the
+  provider does not populate boot order information.
+- **hostname** – Guest hostname as reported by VMware Tools (empty if tools
+  are not running).
+- **parent_vapp** – Name of the parent vApp, if any.
+- **host** – ESXi host the VM is currently running on.
+- **power_state** – Current power state (e.g. ``poweredOn``, ``poweredOff``).
+
+The response is returned with ``Content-Type: text/csv`` and a
+``Content-Disposition: attachment`` header suggesting a filename of the form
+``vm_inventory_{endpoint_id}.csv``.
+
+**Example VM Inventory CSV Response**
+
+.. literalinclude:: ../api_samples/endpoint/endpoint-inventory-resp.csv
+
 Get Endpoint Destination Options
 ================================
 

coriolis/api-refs/source/parameters.yaml

@@ -96,6 +96,13 @@ instance_refresh:
   required: false
   type: boolean
   default: false
+inventory_source_env:
+  description: |
+    Optional base64-encoded JSON object containing source environment options
+    for the inventory export When omitted, the provider's defaults are used.
+  in: query
+  required: false
+  type: string
 show_deleted:
   description: |
     Whether to include deleted resources in the response.