Skip to content

Fetch per-setting Blueprint Drift Audit for a device

Request

Fetches a per-setting Blueprint Drift audit for a single device.

Returns a row for every setting evaluated against the device's assigned Blueprint, so you can see exactly which individual settings have drifted rather than just an overall status. Reponse varies by customer and feature availibility. Non-Architect customer where Blueprint Drift is not enabled returns an empty response. Architect customers where Blueprint Drift is not enabled due to not meeting the Esper Agent eligibility criteria returns a Version Mismatch response. Architect customers where Blueprint Drift is enabled returns the full Blueprint Drift response, including drift details.

About Blueprint Drift Per-Setting Audit Blueprint Drift detects when a device's actual configuration diverges from its assigned Blueprint. This endpoint provides the most granular view — a setting-by-setting comparison — used when the summary or batch status endpoints indicate a device has drifted and you need to know exactly what changed.

Key Fields / Query Parameters

  • deviceId — UUID of the device to audit

Common Use Cases

  • Diagnosing exactly which settings caused a device to be flagged as drifted
  • Verifying a specific setting was corrected after a remediation action
  • Providing detailed compliance evidence for a single device during an audit

Best Practices

  • Use this endpoint only after the summary or batch status endpoints indicate the device is drifted, to avoid unnecessary per-setting calls at scale
  • Cross-reference drifted settings against the device's assigned Blueprint configuration to plan remediation
  • Re-check after remediation to confirm the specific settings returned to compliant

Workflow

  1. Identify a drifted device via the summary or batch status endpoint
  2. GET this endpoint with the device's deviceId for the per-setting breakdown
  3. Remediate the drifted settings and re-check to confirm compliance
Security
drift_apiKey
Path
deviceIdstring, (uuid)required

Device identifier

cURL
curl -i -X GET \
  'https://develop-api.esper.io/_mock/openapi/v2/blueprint-drift/{deviceId}/status' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Per-setting Blueprint Drift details

Bodyapplication/json
device_idstring, (uuid)required

Device identifier

settingsArray of objects(drift_BlueprintDriftDeviceSetting)required
Response
{
  "device_id": "3bafab7b-4400-4bcf-8e6e-09f954699940",
  "settings": [
    { … }
  ]
}