Ludus 2 is in BETA. This API is subject to change until Ludus 2 is released.
Ludus API
Copy Page
Ludus API
Host Management
Retrieve the ludus version
GET
Retrieve the ludus license
GET
Diagnostics
GET
Ansible Management
Retrieve available subscription roles
GET
Install subscription roles
POST
Get role variables for one or more Ansible roles
POST
Move or copy roles between global and local scopes
PATCH
Retrieve available Ansible roles and collections
GET
Install or Remove an Ansible role
POST
Install an Ansible role from local directory
PUT
Install an Ansible collection
POST
User Management
whoami
Get Default Range ID
Set Default Range ID
Get user group memberships
List user details
Add a user to the system
Remove a user from the system
Get proxmox creds for a user
Set the Ludus and Proxmox creds for the user
Reset and retrieve the Ludus API key for a user
List all users
Retrieve a WireGuard configuration file for a user
Range Management
VM Management
Destroy VM
List range VMs, power state, and testing state
Delete a range from the database and proxmox host
Stop the range deployment ansible process
Stop and delete all range VMs
List all tags available to use with deploy
List summary information for all ranges
Retrieve range configuration
Update the range configuration
Retrieve an example range configuration
Deploy the range
Retrieve the latest range logs
Retrieve /etc/hosts file for the range
Retrieve a ssh config
Retrieve a zip file of RDP configs
Retrieve an ansible inventory
Create a new range
Assign a range to a user (admin only)
Revoke range access from a user (admin only)
List users with access to a range (admin only)
List ranges accessible to the user
Power State Management
Power on range VMs
Power off range VMs
Testing State Management
Snapshot and enter testing state
Revert and exit testing state
Allow a domain
Deny a domain
Update a VM or group
Anti-Sandbox Management
Enable anti-sandbox for a VM or multiple VMs (enterprise)
Install the custom QEMU/OMVF packages
Install the standard QEMU/OMVF packages
Template Management
Retrieve a list of VM templates
Build templates
Install an Ansible role from local directory
Delete a template
Kill packer processes for user
Retrieve the latest packer logs
Get the status of packer builds
Snapshot Management
Get all snapshots for a range
Take a snapshot of a VM or multiple VMs
Roll back to a snapshot of a VM or multiple VMs
Delete a snapshot from a VM or multiple VMs
KMS Management
Setup the KMS VM and install the KMS server
License Windows VMs using the KMS server
Group Management
Create a new group
List all groups
Delete a group
List group members
Add users to group
Remove users from group
List group ranges
Add ranges to group
Remove ranges from group
Migration
Migrate SQLite to PocketBase
Virtual Consoles
Get Console Websocket Ticket
Connect to VM Console WebSocket
Schemas
Group Management
BulkAddUsersToGroupRequest
BulkRemoveUsersFromGroupRequest
BulkAddRangesToGroupRequest
BulkRemoveRangesFromGroupRequest
BulkGroupOperationResponse
BulkGroupOperationErrorItem
userID
rangeID
UserObject
UserAPIKeyObject
UserCredentialObject
RangeObject
UserMembershipObject
VMObject
Domain
IP
AllowPayload
SnapshotInfo
ErrorInfo
SnapshotCreatePayload
LicenseDataObject
IP
Copy Page
"203.0.113.4"