Azure Service Bus

Azure Service Bus Queues API

Service Bus queue 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}/queues List the queues in a namespace · Azure Service Bus List Queues #
Ask an LLM
“Which queues are defined in my Service Bus namespace?”
“Can I page through a namespace's queues with skip and top?”
Tell an agent
List the queues in namespace {namespaceName}, resource group {resourceGroupName}, subscription {subscriptionId}.
Show the first {top} queues in namespace {namespaceName} ({resourceGroupName}, subscription {subscriptionId}).
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/queues/{queueName} Get a queue's description · Azure Service Bus Get a Queue #
Ask an LLM
“How do I check the settings of a single Service Bus queue?”
“What properties does my queue currently have configured?”
Tell an agent
Get queue {queueName} in namespace {namespaceName}, resource group {resourceGroupName}, subscription {subscriptionId}.
Describe the {queueName} queue of namespace {namespaceName} in {resourceGroupName} (subscription {subscriptionId}).
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/queues/{queueName} Create or update a queue · Azure Service Bus Create or Update a Queue #
Ask an LLM
“How do I add a new queue to a Service Bus namespace?”
“Can I change the properties of a queue that already exists?”
Tell an agent
Create queue {queueName} in namespace {namespaceName}, resource group {resourceGroupName}, subscription {subscriptionId}.
Update queue {queueName} in {namespaceName} ({resourceGroupName}, subscription {subscriptionId}) with properties {properties}.
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/queues/{queueName} Delete a queue · Azure Service Bus Delete a Queue #
Ask an LLM
“How do I remove a queue from a Service Bus namespace?”
“What happens to messages still sitting in a queue when I delete it?”
Tell an agent destructive · confirm first
Delete queue {queueName} from namespace {namespaceName} in {resourceGroupName}, subscription {subscriptionId}.
Remove the {queueName} queue from {namespaceName} (resource group {resourceGroupName}, subscription {subscriptionId}).

Specifications

⚙
OpenAPI
https://artifacts.apis.io/azure-service-bus/openapi/azure-service-bus-queues-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-queues-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-queues-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Azure Service Bus Management Queues 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: Queues
  description: Service Bus queue operations
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/queues
  : get:
      operationId: Queues_ListByNamespace
      summary: Azure Service Bus List Queues
      description: Gets the queues within a namespace.
      tags:
      - Queues
      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/SBQueueListResult'
              examples:
                QueuesListbynamespace200Example:
                  summary: Default Queues_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}/queues/{queueName}
  : get:
      operationId: Queues_Get
      summary: Azure Service Bus Get a Queue
      description: Returns a description for the specified queue.
      tags:
      - Queues
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ResourceGroupName'
      - $ref: '#/components/parameters/NamespaceName'
      - name: queueName
        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/SBQueue'
              examples:
                QueuesGet200Example:
                  summary: Default Queues_Get 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    name: Example Title
                    type: example_value
                    properties:
                      lockDuration: example_value
                      maxSizeInMegabytes: 10
                      requiresDuplicateDetection: true
                      requiresSession: true
                      defaultMessageTimeToLive: example_value
                      deadLetteringOnMessageExpiration: true
                      duplicateDetectionHistoryTimeWindow: example_value
                      maxDeliveryCount: 10
                      status: Active
                      enableBatchedOperations: true
                      autoDeleteOnIdle: example_value
                      enablePartitioning: true
                      enableExpress: true
                      forwardTo: example_value
                      forwardDeadLetteredMessagesTo: example_value
                      countDetails:
                        activeMessageCount: 10
                        deadLetterMessageCount: 10
                        scheduledMessageCount: 10
                        transferMessageCount: 10
                        transferDeadLetterMessageCount: 10
                      createdAt: '2026-01-15T10:30:00Z'
                      updatedAt: '2026-01-15T10:30:00Z'
                      messageCount: 10
                      sizeInBytes: 10
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: Queues_CreateOrUpdate
      summary: Azure Service Bus Create or Update a Queue
      description: Creates or updates a Service Bus queue.
      tags:
      - Queues
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ResourceGroupName'
      - $ref: '#/components/parameters/NamespaceName'
      - name: queueName
        in: path
        required: true
        schema:
          type: string
        example: example_value
      - $ref: '#/components/parameters/ApiVersion'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SBQueue'
            examples:
              QueuesCreateorupdateRequestExample:
                summary: Default Queues_CreateOrUpdate request
                x-microcks-default: true
                value:
                  id: abc123
                  name: Example Title
                  type: example_value
                  properties:
                    lockDuration: example_value
                    maxSizeInMegabytes: 10
                    requiresDuplicateDetection: true
                    requiresSession: true
                    defaultMessageTimeToLive: example_value
                    deadLetteringOnMessageExpiration: true
                    duplicateDetectionHistoryTimeWindow: example_value
                    maxDeliveryCount: 10
                    status: Active
                    enableBatchedOperations: true
                    autoDeleteOnIdle: example_value
                    enablePartitioning: true
                    enableExpress: true
                    forwardTo: example_value
                    forwardDeadLetteredMessagesTo: example_value
                    countDetails:
                      activeMessageCount: 10
                      deadLetterMessageCount: 10
                      scheduledMessageCount: 10
                      transferMessageCount: 10
                      transferDeadLetterMessageCount: 10
                    createdAt: '2026-01-15T10:30:00Z'
                    updatedAt: '2026-01-15T10:30:00Z'
                    messageCount: 10
                    sizeInBytes: 10
      responses:
        '200':
          description: Queue updated or created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SBQueue'
              examples:
                QueuesCreateorupdate200Example:
                  summary: Default Queues_CreateOrUpdate 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    name: Example Title
                    type: example_value
                    properties:
                      lockDuration: example_value
                      maxSizeInMegabytes: 10
                      requiresDuplicateDetection: true
                      requiresSession: true
                      defaultMessageTimeToLive: example_value
                      deadLetteringOnMessageExpiration: true
                      duplicateDetectionHistoryTimeWindow: example_value
                      maxDeliveryCount: 10
                      status: Active
                      enableBatchedOperations: true
                      autoDeleteOnIdle: example_value
                      enablePartitioning: true
                      enableExpress: true
                      forwardTo: example_value
                      forwardDeadLetteredMessagesTo: example_value
                      countDetails:
                        activeMessageCount: 10
                        deadLetterMessageCount: 10
                        scheduledMessageCount: 10
                        transferMessageCount: 10
                        transferDeadLetterMessageCount: 10
                      createdAt: '2026-01-15T10:30:00Z'
                      updatedAt: '2026-01-15T10:30:00Z'
                      messageCount: 10
                      sizeInBytes: 10
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: Queues_Delete
      summary: Azure Service Bus Delete a Queue
      description: Deletes a queue from the specified namespace.
      tags:
      - Queues
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ResourceGroupName'
      - $ref: '#/components/parameters/NamespaceName'
      - name: queueName
        in: path
        required: true
        schema:
          type: string
        example: example_value
      - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: Queue 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:
    SBQueueListResult:
      type: object
      properties:
        value:
          type: array
          items:
            $ref: '#/components/schemas/SBQueue'
          example: []
        nextLink:
          type: string
          example: example_value
    SBQueue:
      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:
            lockDuration:
              type: string
              description: Lock duration timespan (ISO 8601).
            maxSizeInMegabytes:
              type: integer
            requiresDuplicateDetection:
              type: boolean
            requiresSession:
              type: boolean
            defaultMessageTimeToLive:
              type: string
            deadLetteringOnMessageExpiration:
              type: boolean
            duplicateDetectionHistoryTimeWindow:
              type: string
            maxDeliveryCount:
              type: integer
            status:
              type: string
              enum:
              - Active
              - Disabled
              - Restoring
              - SendDisabled
              - ReceiveDisabled
              - Creating
              - Deleting
              - Renaming
              - Unknown
            enableBatchedOperations:
              type: boolean
            autoDeleteOnIdle:
              type: string
            enablePartitioning:
              type: boolean
            enableExpress:
              type: boolean
            forwardTo:
              type: string
            forwardDeadLetteredMessagesTo:
              type: string
            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
            createdAt:
              type: string
              format: date-time
              readOnly: true
            updatedAt:
              type: string
              format: date-time
              readOnly: true
            messageCount:
              type: integer
              format: int64
              readOnly: true
            sizeInBytes:
              type: integer
              format: int64
              readOnly: true
          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