Steps

Obtain an IoT Central API token or Azure AD bearer token — every REST API call requires an authorization header
Author the device template body: a DTMI `@id` (e.g. `dtmi:contoso:mythermostattemplate;1`), `@type: ["ModelDefinition","DeviceModel"]`, `@context`, and a DTDL v2 `capabilityModel` defining telemetry, properties, and commands
Create/publish the template with `PUT https://{appSubdomain}.azureiotcentral.com/api/deviceTemplates/{deviceTemplateId}?api-version=2022-07-31` — the `deviceTemplateId` in the URL must match the body's `@id`; this call is a create/upsert and IoT Central auto-generates default views
To modify fields on an already-created template (e.g. adding a cloud property), send `PATCH` to the same `.../deviceTemplates/{deviceTemplateId}?api-version=2022-07-31` URL with only the changed fields — current docs specify PATCH, not PUT, for in-place edits
Verify with `GET .../deviceTemplates/{deviceTemplateId}?api-version=2022-07-31`, and use `DELETE` on the same path to remove a template

Known gotchas

Views can only be created or edited through the IoT Central UI — the REST API only manages the device model (DTDL) portion of a template
The device template `@id` in the request body must match the `deviceTemplateId` path segment, and it is not the same value as the `capabilityModel`'s own `@id`
Current Microsoft Learn docs use PATCH (not PUT) for the documented "Update a device template" operation — PUT is confirmed only for the create/publish call; treat any claim that updates also use PUT as unverified

azure.microsoft.com · 6 steps · unrated

Roll out a firmware update to a device group using Azure Device Update for IoT Hub with automatic rollback on failure

learn.microsoft.com · 5 steps · unrated

Create and update work orders programmatically via UpKeep's REST API

onupkeep.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Create and update an Azure IoT Central device template via the REST API using PUT for creation

Steps

Known gotchas

Related routes

Give your agent this knowledge — and 15,500+ more routes

Need this verified for your stack — or a route we don't have yet?