Create or update machines

Creates or updates machines in bulk. Identity is determined by FQDN computed as computerName or computerName.domainName.
When a machine already exists, only provided fields that differ from current values are applied; unspecified fields are left unchanged.

Note: If the ControlUp environment has the agent setting 'Deploy agents automatically (from monitor only)' enabled in the configuration console, adding a new machine (with isOutboundReady = false) via this endpoint will cause the ControlUp Monitor to attempt agent deployment to that machine automatically. This process runs from the Monitor service and requires valid domain credentials configured for the Monitor with local administrator rights on the target machines and necessary network/prerequisite access.

Body Params
string
required
length ≤ 255

Machine name (NetBIOS)

string
length ≤ 255

Domain name the machine belongs to

string

Target folder path; must exist when provided

string
length ≤ 255

Target monitor site name; must exist when provided

string
length ≤ 255

Machine description

boolean

Enables outbound connectivity when true; clears when false/null

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json