Fetch Blueprint Drift status for devices

Request

Fetch Blueprint Drift status for a set of devices.

Returns each requested device's current Blueprint Drift state (compliant, drifted, or unknown) in a single batched call, so you don't need to query devices one at a time.

Security

drift_apiKey

Query

device_idsstring, <= 10000 characters^([0-9a-fA-F\\-]{36})(,([0-9a-fA-F\\-]{36}))*$required

Comma-separated list of device UUIDs (max 100 ids). Devices not found return with state: unknown in the response.

Example:device_ids=550e8400-e29b-41d4-a716-446655440001,550e8400-e29b-41d4-a716-446655440002

X-Tenant-Idstringrequired

X-Caller-Idstringrequired

cURL

curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v2/blueprint-drift/status?device_ids=550e8400-e29b-41d4-a716-446655440001%2C550e8400-e29b-41d4-a716-446655440002' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'X-Caller-Id: string' \
  -H 'X-Tenant-Id: string'

Responses

Blueprint Drift status result set

Bodyapplication/json

resultsArray of objects(drift_BlueprintDriftStatusItem)required

Response

{
  "results": [
    { … }
  ]
}