Response API

Isolate Computers

Isolate computers on the network to prevent threats from spreading and/or block the exfiltration of confidential data.

Request

Command	POST
URL	/api/v1/applications/remediations/muids/isolate
Required parameters in the HTTP message body	JSON object with the list of MUIDs of the computers you want to isolate. MUIDs: List of MUIDs.
Headers	Accept: application/json Content-Type: application/json-patch+json
Format of the call to isolate computers

Response

List of JSON objects, each with the operation result.

JSON object field	Description
MUID	MUID of the computer affected by the operation.
deviceId	Deprecated field.
requestAccepted	True
errorCode	“null”
errorMessage	“null”
Response JSON object to a request to isolate computers

Deisolate Computers

Deisolate computers on the network after you have prevented threats from spreading and/or blocked the exfiltration of confidential data.

Request

Command	POST
URL	/api/v1/applications/remediations/muids/deisolate
Required parameters in the HTTP message body	JSON object with the list of MUIDs of the computers you want to deisolate. MUIDs: List of MUIDs.
Headers	Accept: application/json Content-Type: application/json-patch+json
Format of the call to deisolate computers

Response

List of JSON objects, each with the operation result.

JSON object field	Description
MUID	MUID of the affected computer.
deviceId	Deprecated field.
requestAccepted	True
errorCode	“null”
errorMessage	“null”
Response JSON object to a request to isolate computers

Restart

Restart a list of computers to update software or troubleshoot computer problems.

Request

Command	POST
URL	/api/v1/applications/remediations/muids/reboot
Required parameters in the HTTP message body	JSON object with the list of MUIDs of the computers you want to restart. MUIDs: List of MUIDs.
Headers	Accept: application/json Content-Type: application/json-patch+json
Format of the call to restart computers

Response

List of JSON objects, each with the operation result.

JSON object field	Description
MUID	MUID of the affected computer.
deviceId	Deprecated field.
requestAccepted	True
errorCode	“null”
errorMessage	“null”
Response JSON object to a request to restart computers

Example of API call to Isolate, Deisolate, and Restart Computers

This example isolates, deisolates, and restarts computers with these MUIDs: “3333-4444” and “5555-6666”.

#Headers for the API call including the access token

h_request_remediation = {

'Authorization': f'Bearer {access_token}',

'Accept': 'application/json',

'Content-Type': 'application/json-patch+json'

}

#JSON object with the list of MUIDs

muids_data={'muids':['3333-4444','5555-6666']}

#Aim: To isolate a list of computers

#call URL

url_isolate = f'https://api.orion.cytomic.ai/api/v1/applications/remediations/muids/isolate'

r = requests.post(url_isolate, headers=h_request_remediation, json=muids_data, verify=False)

#Returns a JSON object with the operation result

isolate=r.json()

#Aim: To deisolate a list of computers

#call URL

url_deisolate = f'https://api.orion.cytomic.ai/api/v1/applications/remediations/muids/deisolate'

r = requests.post(url_deisolate, headers=h_request_remediation, json=muids_data, verify=False)

#Returns a JSON object with the operation result

deisolate=r.json()

#Aim: To testart a list of computers

#call URL

url_reboot = f'https://api.orion.cytomic.ai/api/v1/applications/remediations/muids/reboot'

r = requests.post(url_reboot, headers=h_request_remediation, json=muids_data, verify=False)

#Returns a JSON object with the operation result

reboot=r.json()