IotCentralClient

Name: IotCentralClient API
Brand: IotCentralClient
Availability: InStock

★ Only Publicly Available OpenAPI DocumentIOTDevice Managementoauth210 EndpointsREST

For Agents

Provision and manage Azure IoT Central applications, list app templates, and validate app names and subdomains via Azure Resource Manager.

Connect the IotCentralClient to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the IotCentralClient, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with IotCentralClient API.

Create or update an IoT Central application in a resource group

List all IoT Central applications across a subscription or filtered by resource group

Browse the catalogue of available IoT Central app templates

Check whether a candidate IoT Central application name is available

GET STARTED

Start building with IotCentralClient API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for IotCentralClient, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for IotCentralClient, keeping it validated and agent-ready. The Microsoft.IoTCentral resource provider API manages Azure IoT Central applications in an Azure subscription. It exposes 10 ARM endpoints to create and update IoT Central apps, list them by subscription or resource group, browse the catalogue of app templates, and check that a chosen name and subdomain are available before provisioning.

Use Cases

Patterns agents use IotCentralClient API for, with concrete tasks.

★ Provisioning Customer-Specific IoT Central Tenants

SaaS providers that resell IoT Central to their customers script the creation of a new IoT Central application per customer, including subdomain availability checks before commit. The API provides checkSubdomainAvailability and checkNameAvailability so the provisioning flow fails fast on collisions. End-to-end provisioning of a new tenant is a few minutes through ARM.

Check subdomain availability for 'customer-acme', then if available PUT a new IoT Central app named 'customer-acme' in resource group 'rg-iot' using the ST1 sku.

Subscription-Wide IoT Central Inventory

Operations teams enumerate every IoT Central app across a subscription to track sprawl, audit billing, and align tagging. The API supports both a subscription-wide list and a resource-group-scoped list, so the inventory script can pivot by team or environment. Inventory completes in seconds for typical fleets.

List all IoTApps in the subscription and emit a CSV with name, resourceGroup, location, and sku.

Template-Driven Application Bootstrapping

Pick the right IoT Central template for a given vertical by listing /appTemplates and matching by name or industry tag, then provision the app referencing that template. Because templates are queried separately from app creation, automation can validate the template choice before issuing the PUT. Bootstrapping a templated app takes minutes.

List appTemplates and pick the one whose name contains 'retail', then provision an IoT Central app referencing that template.

Agent-Driven IoT Central Provisioning via Jentic

An AI agent can stand up IoT Central applications through Jentic without holding raw Azure AD credentials. The agent searches Jentic for 'create an Azure IoT Central application', loads the operation schema, and executes with subscriptionId, resourceGroupName, and the desired subdomain. Jentic's MAXsystem injects a scoped bearer token for management.azure.com.

Use the Jentic MCP tool azure_iotcentral_create_app to create app 'demo-fleet' in resource group 'rg-iot' with subdomain 'demo-fleet'.

Key Endpoints

10 endpoints — jentic publishes the only available openapi specification for iotcentralclient, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/IoTApps

List IoT Central apps in the subscription

GET

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/IoTApps

List IoT Central apps in a resource group

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/IoTApps/{resourceName}

Create or update an IoT Central app

POST

/subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/checkNameAvailability

Check whether an app name is available

POST

/subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/checkSubdomainAvailability

Check whether a subdomain is available

GET

/subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/appTemplates

List available app templates

GET

/subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/IoTApps

List IoT Central apps in the subscription

GET

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/IoTApps

List IoT Central apps in a resource group

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/IoTApps/{resourceName}

Create or update an IoT Central app

POST

/subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/checkNameAvailability

Check whether an app name is available

POST

/subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/checkSubdomainAvailability

Check whether a subdomain is available

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Azure AD OAuth 2.0 client secrets for management.azure.com are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped bearer tokens — raw client secrets never enter the agent's context.

Intent-based discovery

Agents search Jentic by intent (e.g. 'create an Azure IoT Central application') and Jentic returns the matching Microsoft.IoTCentral operation with its parameter schema, so the agent can call the right endpoint without parsing ARM docs.

Time to first call

Direct IoT Central RP integration: 1-2 days to wire AAD against the management audience and handle ARM long-running operations. Through Jentic: under 1 hour — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Azure IoT Hub

IoT Hub is the unmanaged building block under IoT Central; choose it when you want raw device messaging without the IoT Central UI.

Choose IoT Hub when the workload needs full control over device messaging and routing rather than a SaaS app shell.

Complementary

Azure IoT Device Provisioning Service

DPS handles zero-touch device provisioning into IoT Hub or IoT Central applications.

Use DPS to onboard devices automatically into an IoT Central app created with this API.

Complementary

Azure Digital Twins (IoT Spaces)

Digital Twins models the physical environment that IoT Central apps observe.

Use Digital Twins when the workload needs spatial graphs alongside the IoT Central app data.

FAQs

Specific to using IotCentralClient API through Jentic.

Why is there no official OpenAPI spec for IotCentralClient?

Microsoft does not publish a maintained OpenAPI 3 specification for the Microsoft.IoTCentral resource provider. Jentic generates and maintains this spec so that AI agents and developers can call IotCentralClient via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the IotCentralClient use?

It uses Azure Active Directory OAuth 2.0 against management.azure.com with the user_impersonation scope, the standard ARM auth. Through Jentic the AAD client secret is held in the Jentic vault (MAXsystem) and a scoped bearer token is injected per call so the agent never sees raw secrets.

Can I check subdomain availability before creating an app?

Yes. POST to /subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/checkSubdomainAvailability with the candidate subdomain in the request body. The response indicates whether it is taken and surfaces a reason code if it is invalid.

What are the rate limits for IotCentralClient?

It runs on the Azure Resource Manager plane and inherits ARM throttling — typically 12,000 reads and 1,200 writes per hour per subscription, surfaced via x-ms-ratelimit-remaining-subscription-* headers. The IoT Central RP itself does not document tighter limits at the management surface.

How do I create an IoT Central app through Jentic?

Run pip install jentic, then search Jentic with 'create an Azure IoT Central application', load the create-app operation, and execute with subscriptionId, resourceGroupName, resourceName, location, and subdomain. Jentic returns the deployed app resource.

Does this API manage devices inside an IoT Central app?

No. This is the management plane that creates and tracks IoT Central application resources. To manage devices, dashboards, rules, and telemetry inside an IoT Central app, use the IoT Central per-application data-plane API at {subdomain}.azureiotcentral.com instead.