Warning: Deprecated! Get the assembled device config for a specific semver (prefers S3 cache)

GET 
/api/v1/get_config/:configIdentifier/config/device-config/:deviceId/version/:semver

deprecated

Deprecated: the deviceId path param duplicates the config identifier. Use the v2 endpoint /v2/get_config/{configIdentifier}/config/device-config/version/{semver} instead.

Request

Path Parameters

deviceId stringrequired

Device ID

semver stringrequired

Semantic version (e.g. 1.2.0)

configIdentifier anyrequired

Config project ID or name (used for access control)

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