# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Microsoft Azure EventGridManagementClient Event… version: 1.0.0 extends: openapi/microsoft-azure-event-subscriptions-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-10-01' generator: build-phrasing.py label: Generated by API Evangelist operations: 51 - target: $.paths['/{scope}/providers/Microsoft.EventGrid/eventSubscriptions/{eventSubscriptionName}'].get update: x-apievangelist-phrasing: intent: Get an event subscription at any scope effect: read questions: - What destination and filters does an Event Grid subscription at a given resource scope use? - Can I look up an event subscription by its full scope path instead of a topic name? instructions: - text: Get event subscription {eventSubscriptionName} at scope {scope}. slots: eventSubscriptionName: path.eventSubscriptionName scope: path.scope - text: Show how {eventSubscriptionName} is configured under {scope}. slots: eventSubscriptionName: path.eventSubscriptionName scope: path.scope method: generated generated: '2026-10-01' - target: $.paths['/{scope}/providers/Microsoft.EventGrid/eventSubscriptions/{eventSubscriptionName}'].put update: x-apievangelist-phrasing: intent: Create or update an event subscription at a scope effect: write questions: - How do I subscribe to events from a resource group or storage account using its scope path? - Can I replace an existing event subscription at a scope by putting it again with the same name? instructions: - text: Create event subscription {eventSubscriptionName} at scope {scope} with properties {properties}. slots: eventSubscriptionName: path.eventSubscriptionName scope: path.scope properties: requestBody.properties - text: Create or overwrite the {eventSubscriptionName} subscription registered on {scope}. slots: eventSubscriptionName: path.eventSubscriptionName scope: path.scope method: generated generated: '2026-10-01' - target: $.paths['/{scope}/providers/Microsoft.EventGrid/eventSubscriptions/{eventSubscriptionName}'].delete update: x-apievangelist-phrasing: intent: Delete an event subscription at a scope effect: destructive questions: - How do I remove an Event Grid subscription that sits on an arbitrary resource scope? - Does deleting a scope-level event subscription stop deliveries to its endpoint? instructions: - text: Delete event subscription {eventSubscriptionName} from scope {scope}. slots: eventSubscriptionName: path.eventSubscriptionName scope: path.scope - text: Remove the {eventSubscriptionName} subscription attached to {scope}. slots: eventSubscriptionName: path.eventSubscriptionName scope: path.scope method: generated generated: '2026-10-01' - target: $.paths['/{scope}/providers/Microsoft.EventGrid/eventSubscriptions/{eventSubscriptionName}'].patch update: x-apievangelist-phrasing: intent: Update an event subscription at a scope effect: write questions: - Can I change the retry policy or dead-letter destination of a scope-level event subscription? - Is it possible to add an expiration time to an event subscription I already made on a resource scope? instructions: - text: Update the filter on event subscription {eventSubscriptionName} at scope {scope} to {filter}. slots: eventSubscriptionName: path.eventSubscriptionName scope: path.scope filter: requestBody.filter - text: Set expiry {expirationTimeUtc} on the {eventSubscriptionName} subscription under {scope}. slots: expirationTimeUtc: requestBody.expirationTimeUtc eventSubscriptionName: path.eventSubscriptionName scope: path.scope method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/topics/{topicName}/eventSubscriptions/{eventSubscriptionName}'].get update: x-apievangelist-phrasing: intent: Get a nested subscription on a domain topic effect: read questions: - What endpoint does a nested subscription on one topic inside an Event Grid domain deliver to? - Can I inspect a single subscription that belongs to a topic within my domain? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get {eventSubscriptionName} on topic {topicName} of domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName domainName: path.domainName - text: Show nested subscription {eventSubscriptionName} for domain topic {topicName} in {domainName}. slots: eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName domainName: path.domainName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/topics/{topicName}/eventSubscriptions/{eventSubscriptionName}'].put update: x-apievangelist-phrasing: intent: Create a nested subscription on a domain topic effect: write questions: - How do I subscribe an endpoint to just one topic inside an Event Grid domain? - Can I create or replace a nested event subscription on a domain topic? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, create {eventSubscriptionName} on topic {topicName} of domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName domainName: path.domainName - text: Create or replace nested subscription {eventSubscriptionName} on domain topic {topicName} in {domainName} using {properties}. slots: eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName domainName: path.domainName properties: requestBody.properties method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/topics/{topicName}/eventSubscriptions/{eventSubscriptionName}'].delete update: x-apievangelist-phrasing: intent: Delete a nested subscription on a domain topic effect: destructive questions: - How can I drop a subscription from a single topic inside my Event Grid domain? - Is a nested domain-topic subscription removed permanently when I delete it? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, delete {eventSubscriptionName} from topic {topicName} of domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName domainName: path.domainName - text: Remove nested subscription {eventSubscriptionName} from domain topic {topicName} in {domainName}. slots: eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName domainName: path.domainName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/topics/{topicName}/eventSubscriptions/{eventSubscriptionName}'].patch update: x-apievangelist-phrasing: intent: Update a nested subscription on a domain topic effect: write questions: - Can I change the retry policy on a subscription tied to one topic in my domain? - Which settings of a nested domain-topic subscription can I patch, like labels or dead-lettering? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, patch {eventSubscriptionName} on topic {topicName} of domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName domainName: path.domainName - text: Set retry policy {retryPolicy} on nested subscription {eventSubscriptionName} for domain topic {topicName} in {domainName}. slots: retryPolicy: requestBody.retryPolicy eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName domainName: path.domainName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}/eventSubscriptions/{eventSubscriptionName}'].get update: x-apievangelist-phrasing: intent: Get an event subscription on a custom topic effect: read questions: - What filters and destination does a subscription on my Event Grid custom topic have? - Can I fetch one subscription of a custom topic by its name? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get subscription {eventSubscriptionName} of custom topic {topicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName - text: Show event subscription {eventSubscriptionName} on topic {topicName}. slots: eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}/eventSubscriptions/{eventSubscriptionName}'].put update: x-apievangelist-phrasing: intent: Create a subscription on a custom topic effect: write questions: - How do I route events from my custom Event Grid topic to a webhook or queue? - Can I create a new subscription on a custom topic or overwrite one with the same name? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, create subscription {eventSubscriptionName} on custom topic {topicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName - text: Subscribe {eventSubscriptionName} to topic {topicName} with properties {properties}. slots: eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName properties: requestBody.properties method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}/eventSubscriptions/{eventSubscriptionName}'].delete update: x-apievangelist-phrasing: intent: Delete an event subscription on a custom topic effect: destructive questions: - How can I stop a custom topic from sending events to an old endpoint? - What happens to a custom topic's subscription once I delete it? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, delete subscription {eventSubscriptionName} of custom topic {topicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName - text: Unsubscribe {eventSubscriptionName} from topic {topicName}. slots: eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}/eventSubscriptions/{eventSubscriptionName}'].patch update: x-apievangelist-phrasing: intent: Update an event subscription on a custom topic effect: write questions: - Can I point an existing custom-topic subscription at a new destination? - Is it possible to add labels or a dead-letter target to a subscription on my custom topic? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, patch subscription {eventSubscriptionName} of custom topic {topicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName - text: Change the destination of {eventSubscriptionName} on topic {topicName} to {destination}. slots: eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName destination: requestBody.destination method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/eventSubscriptions/{eventSubscriptionName}'].get update: x-apievangelist-phrasing: intent: Get a domain-level event subscription effect: read questions: - What does a subscription set on an entire Event Grid domain look like? - Can I fetch a subscription that covers a whole domain rather than one of its topics? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get domain-wide subscription {eventSubscriptionName} of domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName domainName: path.domainName - text: Show domain-level subscription {eventSubscriptionName} on {domainName}. slots: eventSubscriptionName: path.eventSubscriptionName domainName: path.domainName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/eventSubscriptions/{eventSubscriptionName}'].put update: x-apievangelist-phrasing: intent: Create a subscription on a whole domain effect: write questions: - How do I receive events from every topic in an Event Grid domain with one subscription? - Can I create or replace a domain-wide event subscription? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, create domain-wide subscription {eventSubscriptionName} on domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName domainName: path.domainName - text: Subscribe {eventSubscriptionName} to all of domain {domainName} with properties {properties}. slots: eventSubscriptionName: path.eventSubscriptionName domainName: path.domainName properties: requestBody.properties method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/eventSubscriptions/{eventSubscriptionName}'].delete update: x-apievangelist-phrasing: intent: Delete a domain-level event subscription effect: destructive questions: - How do I remove a subscription that listens to an entire Event Grid domain? - Does deleting a domain-wide subscription affect subscriptions on the domain's topics? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, delete domain-wide subscription {eventSubscriptionName} of domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName domainName: path.domainName - text: Remove domain-level subscription {eventSubscriptionName} from {domainName}. slots: eventSubscriptionName: path.eventSubscriptionName domainName: path.domainName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/eventSubscriptions/{eventSubscriptionName}'].patch update: x-apievangelist-phrasing: intent: Update a domain-level event subscription effect: write questions: - Can I change the event delivery schema on a subscription that spans my whole domain? - Which properties of a domain-wide subscription can be patched after creation? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, patch domain-wide subscription {eventSubscriptionName} of domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName domainName: path.domainName - text: Set delivery schema {eventDeliverySchema} on domain-level subscription {eventSubscriptionName} for {domainName}. slots: eventDeliverySchema: requestBody.eventDeliverySchema eventSubscriptionName: path.eventSubscriptionName domainName: path.domainName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/systemTopics/{systemTopicName}/eventSubscriptions/{eventSubscriptionName}'].get update: x-apievangelist-phrasing: intent: Get a subscription on a system topic effect: read questions: - How can I inspect a subscription listening to Azure service events through a system topic? - Can I fetch one subscription of a system topic by name? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get {eventSubscriptionName} on system topic {systemTopicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName systemTopicName: path.systemTopicName - text: Show system-topic subscription {eventSubscriptionName} of {systemTopicName}. slots: eventSubscriptionName: path.eventSubscriptionName systemTopicName: path.systemTopicName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/systemTopics/{systemTopicName}/eventSubscriptions/{eventSubscriptionName}'].put update: x-apievangelist-phrasing: intent: Create a subscription on a system topic effect: write questions: - How do I react to Azure service events like blob uploads by subscribing to a system topic? - Can I update an existing system-topic subscription by creating it again? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, create {eventSubscriptionName} on system topic {systemTopicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName systemTopicName: path.systemTopicName - text: Subscribe {eventSubscriptionName} to system topic {systemTopicName} with {properties}. slots: eventSubscriptionName: path.eventSubscriptionName systemTopicName: path.systemTopicName properties: requestBody.properties method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/systemTopics/{systemTopicName}/eventSubscriptions/{eventSubscriptionName}'].delete update: x-apievangelist-phrasing: intent: Delete a subscription on a system topic effect: destructive questions: - How do I stop receiving Azure service events from a system topic subscription? - Can a deleted system-topic subscription be recovered? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, delete {eventSubscriptionName} from system topic {systemTopicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName systemTopicName: path.systemTopicName - text: Remove system-topic subscription {eventSubscriptionName} of {systemTopicName}. slots: eventSubscriptionName: path.eventSubscriptionName systemTopicName: path.systemTopicName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/systemTopics/{systemTopicName}/eventSubscriptions/{eventSubscriptionName}'].patch update: x-apievangelist-phrasing: intent: Update a subscription on a system topic effect: write questions: - Can I tighten the event filter on a subscription to a system topic? - What can I patch on a system-topic subscription, such as its destination or retries? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, patch {eventSubscriptionName} on system topic {systemTopicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName systemTopicName: path.systemTopicName - text: Update the filter of system-topic subscription {eventSubscriptionName} on {systemTopicName} to {filter}. slots: eventSubscriptionName: path.eventSubscriptionName systemTopicName: path.systemTopicName filter: requestBody.filter method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/systemTopics/{systemTopicName}/eventSubscriptions/{eventSubscriptionName}/getFullUrl'].post update: x-apievangelist-phrasing: intent: Get the full URL of a system-topic subscription effect: read questions: - Can I see the full endpoint URL of a subscription on a system topic? - Where is the unmasked webhook address of my system-topic subscription? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get the full URL of {eventSubscriptionName} on system topic {systemTopicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName systemTopicName: path.systemTopicName - text: Reveal the endpoint URL of system-topic subscription {eventSubscriptionName} for {systemTopicName}. slots: eventSubscriptionName: path.eventSubscriptionName systemTopicName: path.systemTopicName method: generated generated: '2026-10-01' - target: $.paths['/{scope}/providers/Microsoft.EventGrid/eventSubscriptions/{eventSubscriptionName}/getFullUrl'].post update: x-apievangelist-phrasing: intent: Get the full endpoint URL of a scope-level subscription effect: read questions: - Where can I see the complete webhook URL, including query secrets, for an event subscription at a scope? - Can I retrieve the unmasked destination URL of a scope-level Event Grid subscription? instructions: - text: Get the full endpoint URL of event subscription {eventSubscriptionName} at scope {scope}. slots: eventSubscriptionName: path.eventSubscriptionName scope: path.scope - text: Reveal the complete destination URL for {eventSubscriptionName} on {scope}. slots: eventSubscriptionName: path.eventSubscriptionName scope: path.scope method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/systemTopics/{systemTopicName}/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List subscriptions on a system topic effect: read questions: - Which subscriptions are listening on a given system topic? - Can I filter the subscriptions of a system topic and limit the page size? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, list subscriptions on system topic {systemTopicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName systemTopicName: path.systemTopicName - text: List up to {top} system-topic subscriptions on {systemTopicName} matching {filter}. slots: top: query.$top systemTopicName: path.systemTopicName filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/partnerTopics/{partnerTopicName}/eventSubscriptions/{eventSubscriptionName}'].get update: x-apievangelist-phrasing: intent: Get a subscription on a partner topic effect: read questions: - How can I inspect a subscription receiving events from a partner topic? - Can I fetch a single partner-topic subscription by name? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get {eventSubscriptionName} on partner topic {partnerTopicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName partnerTopicName: path.partnerTopicName - text: Show partner-topic subscription {eventSubscriptionName} of {partnerTopicName}. slots: eventSubscriptionName: path.eventSubscriptionName partnerTopicName: path.partnerTopicName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/partnerTopics/{partnerTopicName}/eventSubscriptions/{eventSubscriptionName}'].put update: x-apievangelist-phrasing: intent: Create a subscription on a partner topic effect: write questions: - How do I route events coming from a SaaS partner topic to my own endpoint? - Can I create or overwrite a subscription on a partner topic? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, create {eventSubscriptionName} on partner topic {partnerTopicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName partnerTopicName: path.partnerTopicName - text: Subscribe {eventSubscriptionName} to partner topic {partnerTopicName} with {properties}. slots: eventSubscriptionName: path.eventSubscriptionName partnerTopicName: path.partnerTopicName properties: requestBody.properties method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/partnerTopics/{partnerTopicName}/eventSubscriptions/{eventSubscriptionName}'].delete update: x-apievangelist-phrasing: intent: Delete a subscription on a partner topic effect: destructive questions: - How do I stop forwarding partner events by removing a partner-topic subscription? - Is deleting a partner-topic subscription reversible? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, delete {eventSubscriptionName} from partner topic {partnerTopicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName partnerTopicName: path.partnerTopicName - text: Remove partner-topic subscription {eventSubscriptionName} of {partnerTopicName}. slots: eventSubscriptionName: path.eventSubscriptionName partnerTopicName: path.partnerTopicName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/partnerTopics/{partnerTopicName}/eventSubscriptions/{eventSubscriptionName}'].patch update: x-apievangelist-phrasing: intent: Update a subscription on a partner topic effect: write questions: - Can I add a dead-letter destination to a partner-topic subscription? - Which parts of a partner-topic subscription can I patch after it is created? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, patch {eventSubscriptionName} on partner topic {partnerTopicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName partnerTopicName: path.partnerTopicName - text: Set dead-letter destination {deadLetterDestination} on partner-topic subscription {eventSubscriptionName} for {partnerTopicName}. slots: deadLetterDestination: requestBody.deadLetterDestination eventSubscriptionName: path.eventSubscriptionName partnerTopicName: path.partnerTopicName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/partnerTopics/{partnerTopicName}/eventSubscriptions/{eventSubscriptionName}/getFullUrl'].post update: x-apievangelist-phrasing: intent: Get the full URL of a partner-topic subscription effect: read questions: - Can I see the complete endpoint URL of a subscription on a partner topic? - Where is the unmasked webhook address for my partner-topic subscription? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get the full URL of {eventSubscriptionName} on partner topic {partnerTopicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName partnerTopicName: path.partnerTopicName - text: Reveal the endpoint URL of partner-topic subscription {eventSubscriptionName} for {partnerTopicName}. slots: eventSubscriptionName: path.eventSubscriptionName partnerTopicName: path.partnerTopicName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/partnerTopics/{partnerTopicName}/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List subscriptions on a partner topic effect: read questions: - Which subscriptions are consuming events from a given partner topic? - Can I filter a partner topic's subscriptions and cap how many are returned? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, list subscriptions on partner topic {partnerTopicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName partnerTopicName: path.partnerTopicName - text: List up to {top} partner-topic subscriptions on {partnerTopicName} matching {filter}. slots: top: query.$top partnerTopicName: path.partnerTopicName filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/topics/{topicName}/eventSubscriptions/{eventSubscriptionName}/getFullUrl'].post update: x-apievangelist-phrasing: intent: Get the full URL of a nested domain-topic subscription effect: read questions: - Can I see the complete webhook URL behind a nested subscription on a domain topic? - Where do I find the unmasked endpoint of a subscription on one topic of my domain? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get the full URL of {eventSubscriptionName} on topic {topicName} of domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName domainName: path.domainName - text: Reveal the endpoint URL for nested subscription {eventSubscriptionName} on domain topic {topicName}, domain {domainName}. slots: eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName domainName: path.domainName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}/eventSubscriptions/{eventSubscriptionName}/getFullUrl'].post update: x-apievangelist-phrasing: intent: Get the full URL of a custom-topic subscription effect: read questions: - Can I retrieve the full webhook URL for a subscription on my custom topic? - Where is the complete endpoint address of a custom topic subscription shown? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get the full URL of {eventSubscriptionName} on custom topic {topicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName - text: Unmask the webhook address that custom topic {topicName} uses for {eventSubscriptionName}. slots: topicName: path.topicName eventSubscriptionName: path.eventSubscriptionName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/eventSubscriptions/{eventSubscriptionName}/getFullUrl'].post update: x-apievangelist-phrasing: intent: Get the full URL of a domain-level subscription effect: read questions: - Can I see the unmasked endpoint of a subscription covering an entire domain? - Where do I get the complete webhook address for a domain-wide Event Grid subscription? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get the full URL of domain-wide subscription {eventSubscriptionName}, domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName domainName: path.domainName - text: Reveal the endpoint URL of domain-level subscription {eventSubscriptionName} on {domainName}. slots: eventSubscriptionName: path.eventSubscriptionName domainName: path.domainName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.EventGrid/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List global event subscriptions in a subscription effect: read questions: - What global Event Grid subscriptions exist across my whole Azure subscription? - Can I get an aggregated list of every global event subscription with a name filter? instructions: - text: List all global event subscriptions in Azure subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId - text: List up to {top} global event subscriptions in {subscriptionId} matching {filter}. slots: top: query.$top subscriptionId: path.subscriptionId filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.EventGrid/topicTypes/{topicTypeName}/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List global subscriptions for a topic type effect: read questions: - Which global event subscriptions exist for a topic type such as resource groups across my subscription? - Can I list subscription-wide global subscriptions narrowed to one topic type? instructions: - text: List global event subscriptions for topic type {topicTypeName} in Azure subscription {subscriptionId}. slots: topicTypeName: path.topicTypeName subscriptionId: path.subscriptionId - text: Show the first {top} global subscriptions of topic type {topicTypeName}. slots: top: query.$top topicTypeName: path.topicTypeName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List global event subscriptions in a resource group effect: read questions: - What global event subscriptions are defined inside one resource group? - Can I filter the global subscriptions of a resource group by name? instructions: - text: List global event subscriptions in resource group {resourceGroupName} of Azure subscription {subscriptionId}. slots: resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Find global subscriptions in group {resourceGroupName} matching {filter}. slots: resourceGroupName: path.resourceGroupName filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topicTypes/{topicTypeName}/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List a resource group's global subscriptions by topic type effect: read questions: - Which global subscriptions of a particular topic type live in my resource group? - Can I narrow a resource group's global event subscriptions to one topic type? instructions: - text: List global subscriptions of topic type {topicTypeName} in resource group {resourceGroupName}, Azure subscription {subscriptionId}. slots: topicTypeName: path.topicTypeName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Show up to {top} {topicTypeName} global subscriptions in group {resourceGroupName}. slots: top: query.$top topicTypeName: path.topicTypeName resourceGroupName: path.resourceGroupName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.EventGrid/locations/{location}/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List regional event subscriptions in a subscription effect: read questions: - Which event subscriptions exist in a specific Azure region across my subscription? - Can I list regional Event Grid subscriptions for one location with a filter? instructions: - text: List regional event subscriptions in location {location} for Azure subscription {subscriptionId}. slots: location: path.location subscriptionId: path.subscriptionId - text: List up to {top} regional subscriptions in {location} matching {filter}. slots: top: query.$top location: path.location filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/locations/{location}/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List regional subscriptions in a resource group effect: read questions: - What regional event subscriptions does a resource group have in a given location? - Can I filter one resource group's subscriptions to a single region? instructions: - text: List regional event subscriptions in {location} for resource group {resourceGroupName}, Azure subscription {subscriptionId}. slots: location: path.location resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Find regional subscriptions of group {resourceGroupName} in {location} matching {filter}. slots: resourceGroupName: path.resourceGroupName location: path.location filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.EventGrid/locations/{location}/topicTypes/{topicTypeName}/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List regional subscriptions for a topic type effect: read questions: - Which event subscriptions of a given topic type exist in one region of my subscription? - Can I combine a location and a topic type when listing subscription-wide event subscriptions? instructions: - text: List regional subscriptions of topic type {topicTypeName} in {location} for Azure subscription {subscriptionId}. slots: topicTypeName: path.topicTypeName location: path.location subscriptionId: path.subscriptionId - text: Show up to {top} {topicTypeName} subscriptions located in {location}. slots: top: query.$top topicTypeName: path.topicTypeName location: path.location method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/locations/{location}/topicTypes/{topicTypeName}/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List a resource group's regional subscriptions by topic type effect: read questions: - What event subscriptions of one topic type exist in a region for a single resource group? - Can I scope a regional subscription listing to both a resource group and a topic type? instructions: - text: List {topicTypeName} subscriptions in {location} for resource group {resourceGroupName}, Azure subscription {subscriptionId}. slots: topicTypeName: path.topicTypeName location: path.location resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Find {topicTypeName} subscriptions of group {resourceGroupName} in region {location} matching {filter}. slots: topicTypeName: path.topicTypeName resourceGroupName: path.resourceGroupName location: path.location filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{providerNamespace}/{resourceTypeName}/{resourceName}/providers/Microsoft.EventGrid/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List event subscriptions on a specific resource effect: read questions: - Which event subscriptions have been created for a particular Azure resource, like one storage account? - Can I list subscriptions on a resource by giving its provider namespace, type and name? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, list event subscriptions on {providerNamespace}/{resourceTypeName}/{resourceName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName providerNamespace: path.providerNamespace resourceTypeName: path.resourceTypeName resourceName: path.resourceName - text: List up to {top} event subscriptions on resource {resourceName} of type {resourceTypeName} in {providerNamespace}. slots: top: query.$top resourceName: path.resourceName resourceTypeName: path.resourceTypeName providerNamespace: path.providerNamespace method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List subscriptions on a custom topic effect: read questions: - Which event subscriptions have been created for my custom Event Grid topic? - Can I filter a custom topic's subscriptions and limit the number returned? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, list all subscriptions of custom topic {topicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName topicName: path.topicName - text: Return the first {top} custom-topic subscriptions under {topicName} whose names match {filter}. slots: top: query.$top topicName: path.topicName filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List subscriptions on a domain effect: read questions: - Which domain-level event subscriptions exist on my Event Grid domain? - Can I filter and cap the list of subscriptions on a domain? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, list domain-level subscriptions for domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName domainName: path.domainName - text: List up to {top} subscriptions on domain {domainName} matching {filter}. slots: top: query.$top domainName: path.domainName filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/topics/{topicName}/providers/Microsoft.EventGrid/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List extension subscriptions for a domain topic effect: read questions: - Which event subscriptions were created against a domain topic as an extension resource? - Can I page through the provider-level subscriptions on a domain topic with a top limit? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, list extension-style subscriptions for topic {topicName} of domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName topicName: path.topicName domainName: path.domainName - text: List the first {top} provider-level subscriptions registered on domain topic {topicName} in {domainName}. slots: top: query.$top topicName: path.topicName domainName: path.domainName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/topics/{topicName}/eventSubscriptions'].get update: x-apievangelist-phrasing: intent: List nested subscriptions on a domain topic effect: read questions: - What nested event subscriptions exist on a particular topic inside my Event Grid domain? - Can I filter the nested subscriptions of a domain topic by name and cap how many come back? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, list nested subscriptions on topic {topicName} of domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName topicName: path.topicName domainName: path.domainName - text: List up to {top} nested subscriptions on domain topic {topicName} in {domainName} matching {filter}. slots: top: query.$top topicName: path.topicName domainName: path.domainName filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/{scope}/providers/Microsoft.EventGrid/eventSubscriptions/{eventSubscriptionName}/getDeliveryAttributes'].post update: x-apievangelist-phrasing: intent: Get delivery attributes of a scope-level subscription effect: read questions: - Which custom delivery headers are set on an event subscription at a resource scope? - Can I list the delivery attribute mappings for an Event Grid subscription by its scope? instructions: - text: Get delivery attributes for event subscription {eventSubscriptionName} at scope {scope}. slots: eventSubscriptionName: path.eventSubscriptionName scope: path.scope - text: List the header mappings configured on {eventSubscriptionName} under {scope}. slots: eventSubscriptionName: path.eventSubscriptionName scope: path.scope method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/systemTopics/{systemTopicName}/eventSubscriptions/{eventSubscriptionName}/getDeliveryAttributes'].post update: x-apievangelist-phrasing: intent: Get delivery attributes of a system-topic subscription effect: read questions: - What delivery headers does my system-topic subscription add to events? - Can I read the delivery attributes of a subscription on a system topic? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get delivery attributes of {eventSubscriptionName} on system topic {systemTopicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName systemTopicName: path.systemTopicName - text: List header mappings for system-topic subscription {eventSubscriptionName} of {systemTopicName}. slots: eventSubscriptionName: path.eventSubscriptionName systemTopicName: path.systemTopicName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/partnerTopics/{partnerTopicName}/eventSubscriptions/{eventSubscriptionName}/getDeliveryAttributes'].post update: x-apievangelist-phrasing: intent: Get delivery attributes of a partner-topic subscription effect: read questions: - What delivery headers are configured on a partner-topic subscription? - Can I read delivery attribute mappings for a subscription on a partner topic? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get delivery attributes of {eventSubscriptionName} on partner topic {partnerTopicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName partnerTopicName: path.partnerTopicName - text: List header mappings for partner-topic subscription {eventSubscriptionName} of {partnerTopicName}. slots: eventSubscriptionName: path.eventSubscriptionName partnerTopicName: path.partnerTopicName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/topics/{topicName}/eventSubscriptions/{eventSubscriptionName}/getDeliveryAttributes'].post update: x-apievangelist-phrasing: intent: Get delivery attributes of a domain-topic subscription effect: read questions: - Which delivery headers are attached to a nested subscription on a domain topic? - Can I read the delivery attribute mappings for a subscription on one topic of an Event Grid domain? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get delivery attributes of {eventSubscriptionName} on topic {topicName}, domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName domainName: path.domainName - text: List header mappings on nested subscription {eventSubscriptionName} for domain topic {topicName} in {domainName}. slots: eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName domainName: path.domainName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}/eventSubscriptions/{eventSubscriptionName}/getDeliveryAttributes'].post update: x-apievangelist-phrasing: intent: Get delivery attributes of a custom-topic subscription effect: read questions: - What custom delivery headers does a subscription on my custom topic send? - Can I read the delivery attributes configured for a custom topic's subscription? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get delivery attributes of {eventSubscriptionName} on custom topic {topicName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName topicName: path.topicName - text: Show the delivery headers custom topic {topicName} attaches for {eventSubscriptionName}. slots: topicName: path.topicName eventSubscriptionName: path.eventSubscriptionName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/eventSubscriptions/{eventSubscriptionName}/getDeliveryAttributes'].post update: x-apievangelist-phrasing: intent: Get delivery attributes of a domain-level subscription effect: read questions: - What delivery headers does a subscription on my whole Event Grid domain attach? - Can I list delivery attribute mappings for a domain-wide subscription? instructions: - text: In subscription {subscriptionId}, group {resourceGroupName}, get delivery attributes of domain-wide subscription {eventSubscriptionName}, domain {domainName}. slots: subscriptionId: path.subscriptionId resourceGroupName: path.resourceGroupName eventSubscriptionName: path.eventSubscriptionName domainName: path.domainName - text: List header mappings on domain-level subscription {eventSubscriptionName} for {domainName}. slots: eventSubscriptionName: path.eventSubscriptionName domainName: path.domainName method: generated generated: '2026-10-01'