Azure Service Bus

Azure Service Bus Topics API

Service Bus topic operations

GitHub OpenAPI
Business capability
IT Infrastructure Management BC-600.50

Operations 4

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

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics List the topics in a namespace · Azure Service Bus List Topics #
Ask an LLM
“Which topics are defined in my Service Bus namespace?”
“Can I page through a namespace's topics using skip and top?”
Tell an agent
List the topics in namespace {namespaceName}, resource group {resourceGroupName}, subscription {subscriptionId}.
Show the first {top} topics in namespace {namespaceName} ({resourceGroupName}, subscription {subscriptionId}).
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics/{topicName} Get a topic's description · Azure Service Bus Get a Topic #
Ask an LLM
“How do I check how a single Service Bus topic is configured?”
“What properties does my topic currently have?”
Tell an agent
Get topic {topicName} in namespace {namespaceName}, resource group {resourceGroupName}, subscription {subscriptionId}.
Describe the {topicName} topic of namespace {namespaceName} in {resourceGroupName} (subscription {subscriptionId}).
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics/{topicName} Create or update a topic · Azure Service Bus Create or Update a Topic #
Ask an LLM
“How do I add a new publish-subscribe topic to a Service Bus namespace?”
“Can I change the properties of a topic that already exists?”
Tell an agent
Create topic {topicName} in namespace {namespaceName}, resource group {resourceGroupName}, subscription {subscriptionId}.
Update topic {topicName} in {namespaceName} ({resourceGroupName}, subscription {subscriptionId}) with properties {properties}.
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics/{topicName} Delete a topic · Azure Service Bus Delete a Topic #
Ask an LLM
“How do I remove a topic from a Service Bus namespace?”
“What happens to a topic's subscriptions when the topic is deleted?”
Tell an agent destructive · confirm first
Delete topic {topicName} from namespace {namespaceName} in {resourceGroupName}, subscription {subscriptionId}.
Remove the {topicName} topic from {namespaceName} (resource group {resourceGroupName}, subscription {subscriptionId}).

Specifications

⚙
OpenAPI
https://artifacts.apis.io/azure-service-bus/openapi/azure-service-bus-topics-api-openapi.yml
⚙
AsyncAPI
https://artifacts.apis.io/azure-service-bus/asyncapi/azure-service-bus-asyncapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/azure-service-bus/json-schema/azure-service-bus-queue.yml

Other Resources

🔗
JSONLD
https://artifacts.apis.io/azure-service-bus/json-ld/azure-service-bus-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/azure-service-bus:azure-service-bus-topics-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

azure-service-bus-topics-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Azure Service Bus Management Topics API
  description: The Azure Service Bus REST API provides operations for managing Service Bus resources including namespaces, queues, topics, subscriptions, and rules through the Azure Resource Manager.
  version: '2021-11-01'
  contact:
    name: Microsoft Azure
    url: https://azure.microsoft.com/en-us/products/service-bus
servers:
- url: https://management.azure.com
  description: Azure Resource Manager endpoint
security:
- azure_auth:
  - user_impersonation
tags:
- name: Topics
  description: Service Bus topic operations
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics
  : get:
      operationId: Topics_ListByNamespace
      summary: Azure Service Bus List Topics
      description: Gets all the topics in a namespace.
      tags:
      - Topics
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ResourceGroupName'
      - $ref: '#/components/parameters/NamespaceName'
      - $ref: '#/components/parameters/ApiVersion'
      - name: $skip
        in: query
        schema:
          type: integer
        example: 10
      - name: $top
        in: query
        schema:
          type: integer
        example: 10
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SBTopicListResult'
              examples:
                TopicsListbynamespace200Example:
                  summary: Default Topics_ListByNamespace 200 response
                  x-microcks-default: true
                  value:
                    value:
                    - id: abc123
                      name: Example Title
                      type: example_value
                      properties: {}
                    nextLink: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics/{topicName}
  : get:
      operationId: Topics_Get
      summary: Azure Service Bus Get a Topic
      description: Returns a description for the specified topic.
      tags:
      - Topics
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ResourceGroupName'
      - $ref: '#/components/parameters/NamespaceName'
      - name: topicName
        in: path
        required: true
        schema:
          type: string
        example: example_value
      - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SBTopic'
              examples:
                TopicsGet200Example:
                  summary: Default Topics_Get 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    name: Example Title
                    type: example_value
                    properties:
                      defaultMessageTimeToLive: example_value
                      maxSizeInMegabytes: 10
                      maxMessageSizeInKilobytes: 10
                      requiresDuplicateDetection: true
                      duplicateDetectionHistoryTimeWindow: example_value
                      enableBatchedOperations: true
                      status: Active
                      supportOrdering: true
                      autoDeleteOnIdle: example_value
                      enablePartitioning: true
                      enableExpress: true
                      countDetails:
                        activeMessageCount: 10
                        deadLetterMessageCount: 10
                        scheduledMessageCount: 10
                        transferMessageCount: 10
                        transferDeadLetterMessageCount: 10
                      subscriptionCount: 10
                      createdAt: '2026-01-15T10:30:00Z'
                      updatedAt: '2026-01-15T10:30:00Z'
                      sizeInBytes: 10
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: Topics_CreateOrUpdate
      summary: Azure Service Bus Create or Update a Topic
      description: Creates a topic in the specified namespace.
      tags:
      - Topics
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ResourceGroupName'
      - $ref: '#/components/parameters/NamespaceName'
      - name: topicName
        in: path
        required: true
        schema:
          type: string
        example: example_value
      - $ref: '#/components/parameters/ApiVersion'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SBTopic'
            examples:
              TopicsCreateorupdateRequestExample:
                summary: Default Topics_CreateOrUpdate request
                x-microcks-default: true
                value:
                  id: abc123
                  name: Example Title
                  type: example_value
                  properties:
                    defaultMessageTimeToLive: example_value
                    maxSizeInMegabytes: 10
                    maxMessageSizeInKilobytes: 10
                    requiresDuplicateDetection: true
                    duplicateDetectionHistoryTimeWindow: example_value
                    enableBatchedOperations: true
                    status: Active
                    supportOrdering: true
                    autoDeleteOnIdle: example_value
                    enablePartitioning: true
                    enableExpress: true
                    countDetails:
                      activeMessageCount: 10
                      deadLetterMessageCount: 10
                      scheduledMessageCount: 10
                      transferMessageCount: 10
                      transferDeadLetterMessageCount: 10
                    subscriptionCount: 10
                    createdAt: '2026-01-15T10:30:00Z'
                    updatedAt: '2026-01-15T10:30:00Z'
                    sizeInBytes: 10
      responses:
        '200':
          description: Topic updated or created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SBTopic'
              examples:
                TopicsCreateorupdate200Example:
                  summary: Default Topics_CreateOrUpdate 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    name: Example Title
                    type: example_value
                    properties:
                      defaultMessageTimeToLive: example_value
                      maxSizeInMegabytes: 10
                      maxMessageSizeInKilobytes: 10
                      requiresDuplicateDetection: true
                      duplicateDetectionHistoryTimeWindow: example_value
                      enableBatchedOperations: true
                      status: Active
                      supportOrdering: true
                      autoDeleteOnIdle: example_value
                      enablePartitioning: true
                      enableExpress: true
                      countDetails:
                        activeMessageCount: 10
                        deadLetterMessageCount: 10
                        scheduledMessageCount: 10
                        transferMessageCount: 10
                        transferDeadLetterMessageCount: 10
                      subscriptionCount: 10
                      createdAt: '2026-01-15T10:30:00Z'
                      updatedAt: '2026-01-15T10:30:00Z'
                      sizeInBytes: 10
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: Topics_Delete
      summary: Azure Service Bus Delete a Topic
      description: Deletes a topic from the specified namespace.
      tags:
      - Topics
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ResourceGroupName'
      - $ref: '#/components/parameters/NamespaceName'
      - name: topicName
        in: path
        required: true
        schema:
          type: string
        example: example_value
      - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: Topic deleted
        '204':
          description: No content
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  parameters:
    ResourceGroupName:
      name: resourceGroupName
      in: path
      required: true
      description: Name of the resource group.
      schema:
        type: string
    ApiVersion:
      name: api-version
      in: query
      required: true
      description: Client API version.
      schema:
        type: string
        default: '2021-11-01'
    SubscriptionId:
      name: subscriptionId
      in: path
      required: true
      description: The Azure subscription ID.
      schema:
        type: string
    NamespaceName:
      name: namespaceName
      in: path
      required: true
      description: The namespace name.
      schema:
        type: string
  schemas:
    SBTopic:
      type: object
      properties:
        id:
          type: string
          readOnly: true
          example: abc123
        name:
          type: string
          readOnly: true
          example: Example Title
        type:
          type: string
          readOnly: true
          example: example_value
        properties:
          type: object
          properties:
            defaultMessageTimeToLive:
              type: string
            maxSizeInMegabytes:
              type: integer
            maxMessageSizeInKilobytes:
              type: integer
              format: int64
            requiresDuplicateDetection:
              type: boolean
            duplicateDetectionHistoryTimeWindow:
              type: string
            enableBatchedOperations:
              type: boolean
            status:
              type: string
              enum:
              - Active
              - Disabled
              - Restoring
              - SendDisabled
              - ReceiveDisabled
              - Creating
              - Deleting
              - Renaming
              - Unknown
            supportOrdering:
              type: boolean
            autoDeleteOnIdle:
              type: string
            enablePartitioning:
              type: boolean
            enableExpress:
              type: boolean
            countDetails:
              type: object
              readOnly: true
              properties:
                activeMessageCount:
                  type: integer
                  format: int64
                deadLetterMessageCount:
                  type: integer
                  format: int64
                scheduledMessageCount:
                  type: integer
                  format: int64
                transferMessageCount:
                  type: integer
                  format: int64
                transferDeadLetterMessageCount:
                  type: integer
                  format: int64
            subscriptionCount:
              type: integer
              readOnly: true
            createdAt:
              type: string
              format: date-time
              readOnly: true
            updatedAt:
              type: string
              format: date-time
              readOnly: true
            sizeInBytes:
              type: integer
              format: int64
              readOnly: true
          example: example_value
    SBTopicListResult:
      type: object
      properties:
        value:
          type: array
          items:
            $ref: '#/components/schemas/SBTopic'
          example: []
        nextLink:
          type: string
          example: example_value
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
          scopes:
            user_impersonation: Impersonate your user account