Get rendered config for a device

GET 
/api/v2/device/:deviceId/config

Returns the fully assembled config for the given device by merging the latest ACTIVE revision of its CONFIG project with all applicable ConfigMap revisions. The result is cached in S3 and served from cache when no relevant database changes have occurred. Authenticate with the Device-Auth header.

Request

Path Parameters

deviceId stringrequired

Device ID

Responses

200

application/json

Schema

Schema

deviceId stringrequired

Device ID this config belongs to

configRevisionId objectrequired

Revision ID of the device config project used

semVer object

Semantic version of the active revision when this config was assembled

configRef object

Config release reference (projectId.projectName@semVer) of the active revision

groups objectrequired

Assembled config groups keyed by group name

metaDataTimestamps

object

Per-field last-writer ISO-8601 timestamps keyed by group name (mirrors groups) for the writable getapp_metadata and getapp_enrollment fields, used by the agent for LWW.

property name*

object

property name* date-time
computedAt stringrequired

Example (from schema)

{
  "deviceId": "string",
  "configRevisionId": {},
  "semVer": {},
  "configRef": {},
  "groups": {},
  "metaDataTimestamps": {
    "getapp_metadata": {
      "name": "2026-07-19T10:00:00.000Z"
    },
    "getapp_enrollment": {
      "deviceType": "2026-07-19T10:00:00.000Z"
    }
  },
  "computedAt": "string"
}

Loading...