---
title: "PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthBot/healthBots/{botName}"
method: PATCH
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthBot/healthBots/{botName}"
tags: ["HealthBots"]
---

# PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthBot/healthBots/{botName}

`PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthBot/healthBots/{botName}`

Patch a HealthBot.

## Path parameters

- `botName` string, required

## Parameters

- `../../../../../common-types/resource-management/v3/types.json#/components/parameters/ApiVersionParameter` — unresolved $ref
- `../../../../../common-types/resource-management/v3/types.json#/components/parameters/SubscriptionIdParameter` — unresolved $ref
- `../../../../../common-types/resource-management/v3/types.json#/components/parameters/ResourceGroupNameParameter` — unresolved $ref

## Request body

- HealthBotUpdateParameters — Parameters for updating a Azure Health Bot.
  - `properties` HealthBotProperties — The properties of a Azure Health Bot. The Health Bot Service is a cloud platform that empowers developers in Healthcare organizations to build and deploy their compliant, AI-powered virtual health assistants and health bots, that help them improve processes and reduce costs.
    - `provisioningState` string — The provisioning state of the Azure Health Bot resource.
    - `botManagementPortalLink` string — The link.
    - `keyVaultProperties` KeyVaultProperties — Properties of the key vault.
      - `keyName` string, required — The name of the key vault key.
      - `keyVersion` string — The version of the key vault key.
      - `keyVaultUri` string, required — The Uri of the key vault.
      - `userIdentity` string — The user assigned identity (ARM resource id) that has access to the key.
    - `accessControlMethod` string — The access control method for the Azure Health Bot resource.
  - `tags` object — Tags for a Azure Health Bot.
  - `sku` Sku — The resource model definition representing SKU
    - `name` 'F0' | 'C0' | 'PES' | 'C1', required — The name of the Azure Health Bot SKU
  - `identity` Identity — Identity for the resource.
    - `principalId` string — The principal ID of resource identity. This property will only be provided for a system assigned identity.
    - `tenantId` string — The tenant ID of resource. This property will only be provided for a system assigned identity.
    - `type` 'SystemAssigned' | 'UserAssigned' | 'SystemAssigned, UserAssigned' | 'None' — The identity type. The type 'SystemAssigned, UserAssigned' includes both an implicitly created identity and a set of user assigned identities. The type 'None' will remove any identities from the Azure Health Bot
    - `userAssignedIdentities` object — The list of user identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
  - `location` string

## Response `200`

Azure operation completed successfully.

- HealthBot — unresolved $ref

## Other responses

- `201` — Resource 'HealthBot' create operation succeeded
- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/healthbot-microsoft-healthbot.md) · [All operations](https://skmtc.net/azure/apis/healthbot-microsoft-healthbot/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/healthbot-microsoft-healthbot/revisions/73a2a22e82a0/schema)
