---
title: "Update a topic."
method: PATCH
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}"
tags: ["Topics"]
---

# Update a topic.

`PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}`

Asynchronously updates a topic with the specified parameters.

## Path parameters

- `topicName` string, required

## Parameters

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

## Request body

- TopicUpdateParameters — Properties of the Topic update
  - `tags` object — Tags of the Topic resource.
  - `identity` IdentityInfo — The identity information for the resource.
    - `type` 'None' | 'SystemAssigned' | 'UserAssigned' | 'SystemAssigned, UserAssigned' — The type of managed identity used. The type 'SystemAssigned, UserAssigned' includes both an implicitly created identity and a set of user-assigned identities. The type 'None' will remove any identity.
    - `principalId` string — The principal ID of resource identity.
    - `tenantId` string — The tenant ID of resource.
    - `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}'. This property is currently not used and reserved for future usage.
  - `properties` TopicUpdateParameterProperties — Information of topic update parameter properties.
    - `publicNetworkAccess` 'Enabled' | 'Disabled' | 'SecuredByPerimeter' — This determines if traffic is allowed over public network. By default it is enabled. You can further restrict to specific IPs by configuring <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicUpdateParameterProperties.InboundIpRules" />
    - `inboundIpRules` InboundIpRule[] — This can be used to restrict traffic from specific IPs instead of all IPs. Note: These are considered only if PublicNetworkAccess is enabled.
      - `ipMask` string — IP Address in CIDR notation e.g., 10.0.0.0/8.
      - `action` 'Allow' — Action to perform based on the match or no match of the IpMask.
    - `minimumTlsVersionAllowed` '1.0' | '1.1' | '1.2' — Minimum TLS version of the publisher allowed to publish to this domain
    - `disableLocalAuth` boolean — This boolean is used to enable or disable local auth. Default value is false. When the property is set to true, only Microsoft Entra ID token will be used to authenticate if user is allowed to publish to the topic.
    - `dataResidencyBoundary` 'WithinGeopair' | 'WithinRegion' — The data residency boundary for the topic.
    - `eventTypeInfo` EventTypeInfo — The event type information for Channels.
      - `kind` 'Inline' — The kind of event type used.
      - `inlineEventTypes` object — A collection of inline event types for the resource. The inline event type keys are of type string which represents the name of the event. An example of a valid inline event name is "Contoso.OrderCreated". The inline event type values are of type InlineEventProperties and will contain additional information for every inline event type.
  - `sku` ResourceSku — Describes an EventGrid Resource Sku.
    - `name` 'Basic' | 'Premium' — The Sku name of the resource. The possible values are: Basic or Premium.

## Response `200`

OK

## Other responses

- `201` — Topic update request accepted.
- `default` — *** Error Responses: *** * 400 Bad Request. * 500 Internal Server Error.

## Changes

- **2026-07-13** (2017-06-15-preview) `285f714f3339` — 2 warning
  - the optional response header `Location` removed for the status `201`
  - the optional response header `Retry-After` removed for the status `201`
- **2026-07-13** (2017-06-15-preview) `6114a105ef69` — 3 warning
  - deleted the `path` request parameter `resourceGroupName`
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`
- **2026-07-13** (2017-06-15-preview) `93474e2eb953` — 1 info
  - added the success response with the status `200`
- **2026-07-13** (2017-06-15-preview) `dadddcd62373` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/eventgrid-microsoft-eventgrid-eventgrid/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.EventGrid/topics/:topicName/patch.md)

---

[API](https://skmtc.dev/azure/apis/eventgrid-microsoft-eventgrid-eventgrid.md) · [All operations](https://skmtc.dev/azure/apis/eventgrid-microsoft-eventgrid-eventgrid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/eventgrid-microsoft-eventgrid-eventgrid/revisions/285f714f3339/schema)