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

Header Parameters

Device-Auth any

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

configFiles

object[]

Binary config files attached to the active revision. The agent fetches these through the standard delivery flow (catalogId == configRef) when present.

Array [

fileName stringrequired

File name as uploaded

group object

Associated config group name, or null when the file belongs to no specific group

size object

File size in bytes

sha256 object

SHA-256 hex digest of the file content

itemKey stringrequired

Delivery item key: ${catalogId}@${fileName}, matching the standard delivery response

]

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"
    }
  },
  "configFiles": [
    {
      "fileName": "string",
      "group": {},
      "size": {},
      "sha256": {},
      "itemKey": "string"
    }
  ],
  "computedAt": "string"
}

Loading...