Microsoft Azure IotCentralClient — Apps

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure IotCentralClient — Apps
  description: 'Microsoft Azure IotCentralClient — Apps. 9 operations. Lead operation: Microsoft Azure Post Subscriptions
    Subscriptionid Providers Microsoft Iotcentral Apptemplates. Self-contained Naftiko capability covering one Microsoft Azure
    business surface.'
  tags:
  - Microsoft Azure
  - Apps
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: iotcentralclient-apps
    baseUri: https://management.azure.com
    description: Microsoft Azure IotCentralClient — Apps business capability. Self-contained, no shared references.
    resources:
    - name: subscriptions-subscriptionId-providers-Microsoft.IoTCentral-appTemplates
      path: /subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/appTemplates
      operations:
      - name: microsoftazureappslisttemplates
        method: POST
        description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Iotcentral Apptemplates
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionId-providers-Microsoft.IoTCentral-checkNameAvailabilit
      path: /subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/checkNameAvailability
      operations:
      - name: microsoftazureappschecknameavailability
        method: POST
        description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Iotcentral Checknameavailability
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: operationInputs
          in: body
          type: string
          description: Set the name parameter in the OperationInputs structure to the name of the IoT Central application
            to check.
          required: true
    - name: subscriptions-subscriptionId-providers-Microsoft.IoTCentral-checkSubdomainAvaila
      path: /subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/checkSubdomainAvailability
      operations:
      - name: microsoftazureappschecksubdomainavailability
        method: POST
        description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Iotcentral Checksubdomainavailability
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: operationInputs
          in: body
          type: string
          description: Set the name parameter in the OperationInputs structure to the subdomain of the IoT Central application
            to check.
          required: true
    - name: subscriptions-subscriptionId-providers-Microsoft.IoTCentral-iotApps
      path: /subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/iotApps
      operations:
      - name: microsoftazureappslistbysubscription
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Iotcentral Iotapps
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps
      operations:
      - name: microsoftazureappslistbyresourcegroup
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Iotcentral Iotapps
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}
      operations:
      - name: microsoftazureappsget
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Iotcentral Iotapps Resourcename
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: microsoftazureappscreateorupdate
        method: PUT
        description: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Iotcentral Iotapps Resourcename
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: App
          in: body
          type: string
          description: The IoT Central application metadata and security metadata.
          required: true
      - name: microsoftazureappsupdate
        method: PATCH
        description: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Iotcentral Iotapps Resourcename
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: AppPatch
          in: body
          type: string
          description: The IoT Central application metadata and security metadata.
          required: true
      - name: microsoftazureappsdelete
        method: DELETE
        description: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Iotcentral Iotapps Resourcename
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    namespace: iotcentralclient-apps-rest
    port: 8080
    description: REST adapter for Microsoft Azure IotCentralClient — Apps. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-iotcentral/apptemplates
      name: subscriptions-subscriptionid-providers-microsoft-iotcentral-apptemplates
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.IoTCentral-appTemplates.
      operations:
      - method: POST
        name: microsoftazureappslisttemplates
        description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Iotcentral Apptemplates
        call: iotcentralclient-apps.microsoftazureappslisttemplates
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-iotcentral/checknameavailability
      name: subscriptions-subscriptionid-providers-microsoft-iotcentral-checknameavailabilit
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.IoTCentral-checkNameAvailabilit.
      operations:
      - method: POST
        name: microsoftazureappschecknameavailability
        description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Iotcentral Checknameavailability
        call: iotcentralclient-apps.microsoftazureappschecknameavailability
        with:
          operationInputs: rest.operationInputs
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-iotcentral/checksubdomainavailability
      name: subscriptions-subscriptionid-providers-microsoft-iotcentral-checksubdomainavaila
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.IoTCentral-checkSubdomainAvaila.
      operations:
      - method: POST
        name: microsoftazureappschecksubdomainavailability
        description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Iotcentral Checksubdomainavailability
        call: iotcentralclient-apps.microsoftazureappschecksubdomainavailability
        with:
          operationInputs: rest.operationInputs
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-iotcentral/iotapps
      name: subscriptions-subscriptionid-providers-microsoft-iotcentral-iotapps
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.IoTCentral-iotApps.
      operations:
      - method: GET
        name: microsoftazureappslistbysubscription
        description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Iotcentral Iotapps
        call: iotcentralclient-apps.microsoftazureappslistbysubscription
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-iotcentral/iotapps
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazureappslistbyresourcegroup
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Iotcentral Iotapps
        call: iotcentralclient-apps.microsoftazureappslistbyresourcegroup
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-iotcentral/iotapps/{resourcename}
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazureappsget
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Iotcentral Iotapps Resourcename
        call: iotcentralclient-apps.microsoftazureappsget
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: microsoftazureappscreateorupdate
        description: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Iotcentral Iotapps Resourcename
        call: iotcentralclient-apps.microsoftazureappscreateorupdate
        with:
          App: rest.App
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: microsoftazureappsupdate
        description: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Iotcentral Iotapps Resourcename
        call: iotcentralclient-apps.microsoftazureappsupdate
        with:
          AppPatch: rest.AppPatch
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazureappsdelete
        description: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Iotcentral Iotapps Resourcename
        call: iotcentralclient-apps.microsoftazureappsdelete
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: iotcentralclient-apps-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure IotCentralClient — Apps. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: microsoft-azure-post-subscriptions-subscriptionid
      description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Iotcentral Apptemplates
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: iotcentralclient-apps.microsoftazureappslisttemplates
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-post-subscriptions-subscriptionid-2
      description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Iotcentral Checknameavailability
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: iotcentralclient-apps.microsoftazureappschecknameavailability
      with:
        operationInputs: tools.operationInputs
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-post-subscriptions-subscriptionid-3
      description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Iotcentral Checksubdomainavailability
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: iotcentralclient-apps.microsoftazureappschecksubdomainavailability
      with:
        operationInputs: tools.operationInputs
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid
      description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Iotcentral Iotapps
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: iotcentralclient-apps.microsoftazureappslistbysubscription
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid-2
      description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Iotcentral
        Iotapps
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: iotcentralclient-apps.microsoftazureappslistbyresourcegroup
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid-3
      description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Iotcentral
        Iotapps Resourcename
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: iotcentralclient-apps.microsoftazureappsget
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-put-subscriptions-subscriptionid
      description: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Iotcentral
        Iotapps Resourcename
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: iotcentralclient-apps.microsoftazureappscreateorupdate
      with:
        App: tools.App
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-patch-subscriptions-subscriptionid
      description: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
        Iotcentral Iotapps Resourcename
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: iotcentralclient-apps.microsoftazureappsupdate
      with:
        AppPatch: tools.AppPatch
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-delete-subscriptions-subscriptionid
      description: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
        Iotcentral Iotapps Resourcename
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: iotcentralclient-apps.microsoftazureappsdelete
      outputParameters:
      - type: object
        mapping: $.