Microsoft Azure IotCentralClient
Browse all Azure APIs44
AI ReadinessFoundational (D)44/100
Agent-ready OpenAPI document · curated by JenticIOTDevice Managementoauth210 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For Agents
Provision and manage Azure IoT Central applications, list app templates, and validate app names and subdomains via Azure Resource Manager.
Use for: I need to provision a new IoT Central application, List all IoT Central apps in my subscription, Check whether the subdomain 'acme-fleet' is available for IoT Central, Find the IoT Central app templates I can pick from
Not supported: Does not handle in-app device messaging, rules, dashboards, or telemetry - use for IoT Central application provisioning and inventory only.
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.
Install Jentic One Beta
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.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fazure.com%2Fiotcentralclient" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fazure.com%2Fiotcentralclient" | sh
jentic register # connects your agent to your Jentic One instanceJentic 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
Check whether a candidate subdomain is available before provisioning
Enumerate Microsoft.IoTCentral operations exposed on the subscription
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 your Jentic One instance 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
GET
/subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/appTemplates
List available app templates
Jentic AI Readiness Score
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
I
IotCentralClient
- Foundational (D)44/100
73
Foundational Compliance63
Developer Experience & Jentic Compatibility22
AI-Readiness & Agent Experience94
Agent Usability35
Security100
AI DiscoverabilityPowered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
73
Foundational Compliance
Base layer of spec validity and structural soundness.
Grade: A-Signals: 4
91%
Lint Results
Aggregated quality score from linter diagnostics, weighted by severity.
100%
Resolution Completeness
Percentage of `$ref` references that resolve successfully.
0%
Specification Validity
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
100%
Structural Integrity
Structural correctness score based on schema issues using logarithmic dampening.
63
Developer Experience & Jentic Compatibility
Clarity, completeness, and ingestion readiness for developers and tooling.
Grade: B-Signals: 4
0%
Example Density
How richly the API is illustrated with examples.
100%
Example Validity
Percentage of examples that conform to their schemas.
50%
Response Coverage
Percentage of operations with complete response definitions (success, client error, server error).
100%
Tooling Readiness
Health of API ingestion, bundling, and resolution within Jentic pipelines.
22
AI-Readiness & Agent Experience
Semantic breadth, depth, and agent comprehension for AI systems.
Grade: FSignals: 4
87%
Description Coverage
Coverage of descriptions across API elements.
0%
Error Standardization
Coverage of RFC 9457 Problem Details for error responses.
0%
OperationId Quality
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
0%
Summary Coverage
Coverage of summaries across operations/tags/info.
94
Agent Usability
Functional utility, complexity comfort, and AI orchestration readiness.
Grade: A+Signals: 1
94%
Complexity Comfort
Agent comfort level based on API operational and structural complexity.
35
Security
Trust, risk posture, and security compliance.
Grade: FSignals: 1
35%
Authentication Strength
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
100
AI Discoverability
Findability, semantic richness, and reasoning readiness.
Grade: A+Signals: 1
100%
Descriptive Richness
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the IoT Central management API by hand means registering an Azure AD app, negotiating OAuth 2.0 tokens for management.azure.com, and carrying subscription and resource-group scope through every provisioning call. Through Jentic you install once, import IotCentralClient from the API Directory, store the Azure AD credential once, and your agent calls it.
Permission scoping
This API puts the IoT Central application in the URL path (/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/IoTApps/{resourceName}), so a rule can pin your agent to one application: it can read and check availability for that app. You choose the operations it may call, so creating or replacing an application is not included unless you add it.
Credential isolation
Your Azure AD credential for the IoT Central control plane is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'list IoT Central applications' or 'check an IoT Central subdomain', and Jentic returns the matching IoT Central operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
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 with Jentic One, the self-hosted execution layer.
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 your Jentic One instance 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.
Can I limit what my agent is allowed to do with the Microsoft Azure IoT Central API?
Yes. Because you run Jentic One yourself, your own rules decide which IoT Central operations and credentials your agent may use. Since this API carries the application in the URL path (/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/IoTApps/{resourceName}), a rule can pin the agent to a single app so it only lists apps and checks name or subdomain availability. Higher-impact calls such as creating or replacing an IoT Central application are excluded unless you explicitly grant them, and the stored Azure AD credential is injected at execution time rather than exposed to the agent.
GET STARTED