Bulk Device Updates - SCCM Devices

Bulk device updates for sccm devices

Query Parameters

customerid string required

The customer ID specifies the API call

tenantid string required

The tenant ID specifies the API call

updateSource string required

Source of integration

application/json

Request Body required

devicelist object[] required
devices
Array [
deviceid string
Required field
serialNumber string
vendor string
model string
diskEncryptionStatus string
windowsInstalledPatches string
windowsInstalledSoftware string
windowsGUID string
sccmSite string
sccmDomain string
]

Responses

• 200
• 4XX
• 5XX

---

Successful Response

application/json

Schema

Example (from schema)

resolveSecurityAlertResponseExample

---

Schema

api string

The path used to call the IoT Security API: “device/bulkupdate”

ver string

The version of the IoT Security API: “v4.0”

code string

The code number indicating success: 1

message string

The message indicating success: “OK”

updatedDeviceNum integer

The number of devices that IoT Security successfully updated

{
  "api": "string",
  "ver": "string",
  "code": "string",
  "message": "string",
  "updatedDeviceNum": 0
}

{
  "api": "device/bulkUpdate",
  "ver": "v4.0",
  "code": 1,
  "message": "OK",
  "updatedDeviceNum": 5
}

Client Error Response

application/json

Schema

Example (from schema)

Bad Request

Forbidden access

Too many requests

---

Schema

code string

STATUS_CODE

msg string

GENERAL_MESSAGE

{
  "code": "string",
  "msg": "string"
}

{
  "code": 400,
  "msg": "Bad Request. This occurs when an HTTP request contains an invalid query string."
}

{
  "code": 403,
  "msg": "Forbidden access. Either the provided API key is invalid or it does not have the required RBAC permissions to run this API."
}

{
  "code": 429,
  "msg": "Too many requests. The number of requests for device details for a single device exceeded the rate limit of 180 queries per minute per tenant."
}

Server Error Response

application/json

Schema

Example (from schema)

resolveSecurityAlertResponseExample

---

Schema

code string

STATUS_CODE

msg string

GENERAL_MESSAGE

{
  "code": "string",
  "msg": "string"
}

{
  "code": 500,
  "msg": "Internal server error. A unified status for API communication type errors."
}

Loading...