---
title: "Update an event subscription"
method: PATCH
path: "/{scope}/providers/Microsoft.EventGrid/eventSubscriptions/{eventSubscriptionName}"
tags: ["EventSubscriptions"]
---

# Update an event subscription

`PATCH /{scope}/providers/Microsoft.EventGrid/eventSubscriptions/{eventSubscriptionName}`

Asynchronously updates an existing event subscription.

## Path parameters

- `scope` string, required
- `eventSubscriptionName` string, required

## Query parameters

- `api-version` string, required

## Request body

- EventSubscriptionUpdateParameters — Properties of the Event Subscription update
  - `destination` EventSubscriptionDestination — Information about the destination for an event subscription
    - `endpointType` 'WebHook' | 'EventHub' | 'StorageQueue' | 'HybridConnection', required — Type of the endpoint for the event subscription destination
  - `filter` EventSubscriptionFilter — Filter for the Event Subscription
    - `subjectBeginsWith` string — An optional string to filter events for an event subscription based on a resource path prefix. The format of this depends on the publisher of the events. Wildcard characters are not supported in this path.
    - `subjectEndsWith` string — An optional string to filter events for an event subscription based on a resource path suffix. Wildcard characters are not supported in this path.
    - `includedEventTypes` string[] — A list of applicable event types that need to be part of the event subscription. If it is desired to subscribe to all event types, the string "all" needs to be specified as an element in this list.
    - `isSubjectCaseSensitive` boolean — Specifies if the SubjectBeginsWith and SubjectEndsWith properties of the filter should be compared in a case sensitive manner.
  - `labels` string[] — List of user defined labels.
  - `eventDeliverySchema` 'EventGridSchema' | 'InputEventSchema' | 'CloudEventV01Schema' — The event delivery schema for the event subscription.
  - `retryPolicy` RetryPolicy — Information about the retry policy for an event subscription
    - `maxDeliveryAttempts` integer — Maximum number of delivery retry attempts for events.
    - `eventTimeToLiveInMinutes` integer — Time To Live (in minutes) for events.
  - `deadLetterDestination` DeadLetterDestination — Information about the dead letter destination for an event subscription. To configure a deadletter destination, do not directly instantiate an object of this class. Instead, instantiate an object of a derived class. Currently, StorageBlobDeadLetterDestination is the only class that derives from this class.
    - `endpointType` 'StorageBlob', required — Type of the endpoint for the dead letter destination

## Response `201`

EventSubscription update request accepted.

- EventSubscription — Definition of a Resource
  - `id` string — Fully qualified identifier of the resource
  - `name` string — Name of the resource
  - `type` string — Type of the resource

## Other responses

- `default` — *** Error Responses: *** * 400 Bad Request. * 500 Internal Server Error.

---

[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/fa09cb9bac15/schema)