Get sensor and command definitions
GET/api/v1/devices/{deviceId}/capabilities/schema
Get the DTDL Interfaces for one category of configuration types. Applies to WEDA Node and SubNode whose agent provides a capability model (agent SDK version 1.2 or later); otherwise 422. A Custom Device returns 404.
'type=configs' returns the sensor-config Interfaces (used together with GET capabilities/sensors); 'type=commands' returns the command Interfaces. The DTDL is returned verbatim, including the base Interfaces reached through 'extends'. Resolve a sensor's definition by matching its dtmi (from GET capabilities/sensors) against an entry's '@id'.
The DTDL defines a sensor's runtime configuration as 'Report' only, so that is the sole name this schema uses. The 'config' key also accepted by PATCH telemetry-configs carries the same object and has no separate definition here.
Independent of the device's current desired/reported configuration and of which sensors the device actually has.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 503
DTDL Interfaces for the requested category
'type' is neither 'configs' nor 'commands', or the caller's resource_access claim could not be parsed
Authentication is required
The caller's token carries no role in the organization owning this device
Device not found, or outside the organizations the caller can access
The target device's agent provides no capability model, so this operation cannot be served
The device's capability report could not be read. Transient and not a statement about the device; retry.