Get the assembled device config (latest active version, or a specific semver when provided; prefers S3 cache)

GET 
/api/v2/get_config/:configIdentifier/config/device-config/version/:semver

Get the assembled device config (latest active version, or a specific semver when provided; prefers S3 cache)

Request

Path Parameters

configIdentifier stringrequired

Config project ID, name, or device ID

semver stringrequired

Semantic version (e.g. 1.2.0). When omitted, the latest active version is returned.

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...