Microsoft Azure Topics API

The Topics API from Microsoft Azure — 15 operation(s) for topics.

Documentation GitHub OpenAPI

Operations 20

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /topics/{topicName}:publish Publish a CloudEvent to a namespace topic · Microsoft Azure Post Topics Topicname:publish #

Ask an LLM

“How can I publish a single CloudEvent to an Event Grid namespace topic?”

“Which CloudEvent fields are mandatory when publishing to a namespace topic?”

Tell an agent

Publish a CloudEvent with id {id}, source {source} and type {type} to namespace topic {topicName}.

Send an event of type {type} with spec version {specversion} to topic {topicName}, subject {subject}.

POST /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:receive Receive a batch of events from a subscription · Microsoft Azure Post Topics Topicname Eventsubscriptions… #

Ask an LLM

“How can I pull a batch of CloudEvents from a namespace topic event subscription?”

“Is there a cap on how many events I can receive in one pull, and how long it waits?”

Tell an agent

Receive up to {maxEvents} events from subscription {eventSubscriptionName} on topic {topicName}.

Pull events from {eventSubscriptionName} on {topicName}, waiting at most {maxWaitTime} seconds.

POST /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:acknowledge Acknowledge received events by lock token · Microsoft Azure Post Topics Topicname Eventsubscriptions… #

Ask an LLM

“How do I tell Event Grid that I've finished processing the events I pulled?”

“Does acknowledging events report which lock tokens failed?”

Tell an agent

Acknowledge lock tokens {lockTokens} on subscription {eventSubscriptionName} of topic {topicName}.

Mark the events I processed as done using tokens {lockTokens} on {eventSubscriptionName} in {topicName}.

POST /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:release Release events back for redelivery · Microsoft Azure Post Topics Topicname Eventsubscriptions… #

Ask an LLM

“Can I hand pulled events back to the subscription so they get redelivered later?”

“Is it possible to delay redelivery when releasing events I couldn't handle?”

Tell an agent

Release lock tokens {lockTokens} on subscription {eventSubscriptionName} of topic {topicName} for redelivery.

Release events {lockTokens} from {eventSubscriptionName} on {topicName} with a {releaseDelayInSeconds} second delay.

POST /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:reject Reject events that cannot be processed · Microsoft Azure Post Topics Topicname Eventsubscriptions… #

Ask an LLM

“What should I do with pulled events that are malformed and can never be processed?”

“Can I reject a batch of events so they are not delivered to my consumer again?”

Tell an agent

Reject lock tokens {lockTokens} on subscription {eventSubscriptionName} of topic {topicName}.

Reject the poison events {lockTokens} received from {eventSubscriptionName} on {topicName}.

POST /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:renewLock Renew locks on events still being processed · Microsoft Azure Post Topics Topicname Eventsubscriptions… #

Ask an LLM

“My event handler is slow — can I extend the lock so the events aren't redelivered mid-processing?”

“How can I renew the lock on events I received from a namespace topic subscription?”

Tell an agent

Renew locks {lockTokens} on subscription {eventSubscriptionName} of topic {topicName}.

Extend the processing lock for tokens {lockTokens} from {eventSubscriptionName} on {topicName}.

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName} Get an Event Grid topic's properties · Microsoft Azure Get A Topic #

Ask an LLM

“What are the current settings of an Event Grid custom topic?”

“Can I check the endpoint and provisioning state of one Event Grid topic?”

Tell an agent

Get Event Grid topic {topicName} in resource group {resourceGroupName} of subscription {subscriptionId}.

Show the properties of Event Grid topic {topicName} in {resourceGroupName}.

PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName} Create an Event Grid topic · Microsoft Azure Create A Topic #

Ask an LLM

“How can I create a new Event Grid custom topic in a resource group?”

“Which region and SKU settings can I choose when creating an Event Grid topic?”

Tell an agent

Create Event Grid topic {topicName} in {location} under resource group {resourceGroupName}, subscription {subscriptionId}.

Provision a new Event Grid topic {topicName} in {resourceGroupName} with SKU {sku}.

DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName} Delete an Event Grid topic · Microsoft Azure Delete A Topic #

Ask an LLM

“How do I remove an Event Grid custom topic I no longer use?”

“Can I delete an Event Grid topic from a resource group?”

Tell an agent destructive · confirm first

Delete Event Grid topic {topicName} from resource group {resourceGroupName} in subscription {subscriptionId}.

Tear down the Event Grid topic {topicName} in {resourceGroupName}.

PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName} Update an existing Event Grid topic · Microsoft Azure Update A Topic #

Ask an LLM

“Can I change the tags or identity on an Event Grid topic that already exists?”

“What properties of an existing Event Grid topic can be patched?”

Tell an agent

Update the tags on Event Grid topic {topicName} in {resourceGroupName}, subscription {subscriptionId}, to {tags}.

Assign managed identity {identity} to existing Event Grid topic {topicName} in {resourceGroupName}.

GET /subscriptions/{subscriptionId}/providers/Microsoft.EventGrid/topics List Event Grid topics in a subscription · Microsoft Azure List Topics Under An Azure Subscription #

Ask an LLM

“Which Event Grid topics exist across my whole Azure subscription?”

“Can I filter or cap the list of Event Grid topics in a subscription?”

Tell an agent

List all Event Grid topics in subscription {subscriptionId}.

Show the first {top} Event Grid topics in subscription {subscriptionId} matching {filter}.

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics List Event Grid topics in a resource group · Microsoft Azure List Topics Under A Resource Group #

Ask an LLM

“What Event Grid topics are in a particular resource group?”

“Can I page through Event Grid topics within one resource group?”

Tell an agent

List Event Grid topics in resource group {resourceGroupName} of subscription {subscriptionId}.

Show Event Grid topics in {resourceGroupName} whose name matches {filter}.

POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}/listKeys Get the access keys for an Event Grid topic · Microsoft Azure List Keys For A Topic #

Ask an LLM

“Where do I find the shared access keys needed to publish to an Event Grid topic?”

“Can I retrieve both publishing keys for a custom topic?”

Tell an agent

Get the two access keys for Event Grid topic {topicName} in {resourceGroupName}, subscription {subscriptionId}.

Show me the publishing keys for topic {topicName} in resource group {resourceGroupName}.

POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}/regenerateKey Regenerate an Event Grid topic access key · Microsoft Azure Regenerate Key For A Topic #

Ask an LLM

“How can I rotate a compromised shared access key on an Event Grid topic?”

“Will regenerating key1 or key2 on a topic break publishers still using the old one?”

Tell an agent destructive · confirm first

Regenerate {keyName} on Event Grid topic {topicName} in {resourceGroupName}, subscription {subscriptionId}.

Rotate access key {keyName} for topic {topicName}.

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{providerNamespace}/{resourceTypeName}/{resourceName}/providers/Microsoft.EventGrid/eventTypes List event types a resource can emit · Microsoft Azure List Topic Event Types #

Ask an LLM

“What event types does a given Azure resource publish to Event Grid?”

“Can I see which events a storage account emits before I subscribe to it?”

Tell an agent

List Event Grid event types for {resourceName} of type {providerNamespace}/{resourceTypeName} in {resourceGroupName}, subscription {subscriptionId}.

Show the events resource {resourceName} can raise.

GET /{scope}/providers/Microsoft.EventGrid/extensionTopics/default Get an extension topic for a scope · Microsoft Azure Get Properties Of An Extension Topic #

Ask an LLM

“What is an Event Grid extension topic and how do I read its properties for a resource?”

“Can I look up the default extension topic attached to a given scope?”

Tell an agent

Get the Event Grid extension topic for scope {scope}.

Show the default extension topic properties at {scope}.

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics List topics in a Service Bus namespace · Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups… #

Ask an LLM

“Which topics are defined in my Service Bus namespace?”

“Can I get every Service Bus topic in one namespace at once?”

Tell an agent

List all topics in Service Bus namespace {namespaceName}.

Show the Service Bus topics in this namespace.

PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics/{topicName} Create a Service Bus topic · Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups… #

Ask an LLM

“How do I add a new topic to a Service Bus namespace?”

“Can I set topic properties when creating it in Service Bus?”

Tell an agent

Create Service Bus topic {topicName} in namespace {namespaceName} with properties {properties}.

Add a new topic named {topicName} to the Service Bus namespace.

DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics/{topicName} Delete a Service Bus topic · Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups… #

Ask an LLM

“Can I remove a topic from a Service Bus namespace?”

“What happens when I delete a Service Bus topic from a resource group?”

Tell an agent destructive · confirm first

Delete Service Bus topic {topicName} from namespace {namespaceName}.

Remove the Service Bus topic {topicName} and its namespace entry.

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics/{topicName} Get a Service Bus topic · Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups… #

Ask an LLM

“How can I read the description and settings of one Service Bus topic?”

“Can I check a single Service Bus topic's properties in a namespace?”

Tell an agent

Get the description of Service Bus topic {topicName} in namespace {namespaceName}.

Show me the settings of Service Bus topic {topicName}.

Microsoft Azure Topics API

Operations 20

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification