Microsoft Azure Microsoft.Support — Communications

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Microsoft.Support — Communications
  description: 'Microsoft Azure Microsoft.Support — Communications. 8 operations. Lead operation: Microsoft Azure Post Providers
    Microsoft Support Supporttickets Supportticketname Checknameavailability. Self-contained Naftiko capability covering one
    Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Communications
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: microsoftsupport-communications
    baseUri: https://management.azure.com
    description: Microsoft Azure Microsoft.Support — Communications business capability. Self-contained, no shared references.
    resources:
    - name: providers-Microsoft.Support-supportTickets-supportTicketName-checkNameAvailabili
      path: /providers/Microsoft.Support/supportTickets/{supportTicketName}/checkNameAvailability
      operations:
      - name: microsoftazurecommunicationsnosubscriptionchecknameavailability
        method: POST
        description: Microsoft Azure Post Providers Microsoft Support Supporttickets Supportticketname Checknameavailability
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: supportTicketName
          in: path
          type: string
          description: Support ticket name.
          required: true
        - name: checkNameAvailabilityInput
          in: body
          type: string
          description: Input to check.
          required: true
    - name: providers-Microsoft.Support-supportTickets-supportTicketName-communications
      path: /providers/Microsoft.Support/supportTickets/{supportTicketName}/communications
      operations:
      - name: microsoftazuresupportticketcommunicationsnosubscriptionlist
        method: GET
        description: Microsoft Azure Get Providers Microsoft Support Supporttickets Supportticketname Communications
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: supportTicketName
          in: path
          type: string
          description: Support ticket name
          required: true
        - name: $top
          in: query
          type: integer
          description: The number of values to return in the collection. Default is 10 and max is 10.
        - name: $filter
          in: query
          type: string
          description: The filter to apply on the operation. You can filter by communicationType and createdDate properties.
            CommunicationType supports Equals ('eq') operator and crea
    - name: providers-Microsoft.Support-supportTickets-supportTicketName-communications-comm
      path: /providers/Microsoft.Support/supportTickets/{supportTicketName}/communications/{communicationName}
      operations:
      - name: microsoftazurecommunicationsnosubscriptionget
        method: GET
        description: Microsoft Azure Get Providers Microsoft Support Supporttickets Supportticketname Communications Communicationname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: supportTicketName
          in: path
          type: string
          description: Support ticket name.
          required: true
        - name: communicationName
          in: path
          type: string
          description: Communication name.
          required: true
      - name: microsoftazurecommunicationsnosubscriptioncreate
        method: PUT
        description: Microsoft Azure Put Providers Microsoft Support Supporttickets Supportticketname Communications Communicationname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: supportTicketName
          in: path
          type: string
          description: Support ticket name.
          required: true
        - name: communicationName
          in: path
          type: string
          description: Communication name.
          required: true
        - name: createCommunicationParameters
          in: body
          type: string
          description: Communication object.
          required: true
    - name: subscriptions-subscriptionId-providers-Microsoft.Support-supportTickets-supportT
      path: /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/checkNameAvailability
      operations:
      - name: microsoftazurecommunicationschecknameavailability
        method: POST
        description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Support Supporttickets Supportticketname
          Checknameavailability
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: supportTicketName
          in: path
          type: string
          description: Support ticket name.
          required: true
        - name: checkNameAvailabilityInput
          in: body
          type: string
          description: Input to check.
          required: true
    - name: subscriptions-subscriptionId-providers-Microsoft.Support-supportTickets-supportT
      path: /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/communications
      operations:
      - name: microsoftazurecommunicationslist
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Support Supporttickets Supportticketname
          Communications
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: supportTicketName
          in: path
          type: string
          description: Support ticket name.
          required: true
        - name: $top
          in: query
          type: integer
          description: The number of values to return in the collection. Default is 10 and max is 10.
        - name: $filter
          in: query
          type: string
          description: The filter to apply on the operation. You can filter by communicationType and createdDate properties.
            CommunicationType supports Equals ('eq') operator and crea
    - name: subscriptions-subscriptionId-providers-Microsoft.Support-supportTickets-supportT
      path: /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/communications/{communicationName}
      operations:
      - name: microsoftazurecommunicationsget
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Support Supporttickets Supportticketname
          Communications Communicationname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: supportTicketName
          in: path
          type: string
          description: Support ticket name.
          required: true
        - name: communicationName
          in: path
          type: string
          description: Communication name.
          required: true
      - name: microsoftazurecommunicationscreate
        method: PUT
        description: Microsoft Azure Put Subscriptions Subscriptionid Providers Microsoft Support Supporttickets Supportticketname
          Communications Communicationname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: supportTicketName
          in: path
          type: string
          description: Support ticket name.
          required: true
        - name: communicationName
          in: path
          type: string
          description: Communication name.
          required: true
        - name: createCommunicationParameters
          in: body
          type: string
          description: Communication object.
          required: true
  exposes:
  - type: rest
    namespace: microsoftsupport-communications-rest
    port: 8080
    description: REST adapter for Microsoft Azure Microsoft.Support — Communications. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/providers/microsoft-support/supporttickets/{supportticketname}/checknameavailability
      name: providers-microsoft-support-supporttickets-supportticketname-checknameavailabili
      description: REST surface for providers-Microsoft.Support-supportTickets-supportTicketName-checkNameAvailabili.
      operations:
      - method: POST
        name: microsoftazurecommunicationsnosubscriptionchecknameavailability
        description: Microsoft Azure Post Providers Microsoft Support Supporttickets Supportticketname Checknameavailability
        call: microsoftsupport-communications.microsoftazurecommunicationsnosubscriptionchecknameavailability
        with:
          supportTicketName: rest.supportTicketName
          checkNameAvailabilityInput: rest.checkNameAvailabilityInput
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/providers/microsoft-support/supporttickets/{supportticketname}/communications
      name: providers-microsoft-support-supporttickets-supportticketname-communications
      description: REST surface for providers-Microsoft.Support-supportTickets-supportTicketName-communications.
      operations:
      - method: GET
        name: microsoftazuresupportticketcommunicationsnosubscriptionlist
        description: Microsoft Azure Get Providers Microsoft Support Supporttickets Supportticketname Communications
        call: microsoftsupport-communications.microsoftazuresupportticketcommunicationsnosubscriptionlist
        with:
          supportTicketName: rest.supportTicketName
          $top: rest.$top
          $filter: rest.$filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/providers/microsoft-support/supporttickets/{supportticketname}/communications/{communicationname}
      name: providers-microsoft-support-supporttickets-supportticketname-communications-comm
      description: REST surface for providers-Microsoft.Support-supportTickets-supportTicketName-communications-comm.
      operations:
      - method: GET
        name: microsoftazurecommunicationsnosubscriptionget
        description: Microsoft Azure Get Providers Microsoft Support Supporttickets Supportticketname Communications Communicationname
        call: microsoftsupport-communications.microsoftazurecommunicationsnosubscriptionget
        with:
          supportTicketName: rest.supportTicketName
          communicationName: rest.communicationName
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: microsoftazurecommunicationsnosubscriptioncreate
        description: Microsoft Azure Put Providers Microsoft Support Supporttickets Supportticketname Communications Communicationname
        call: microsoftsupport-communications.microsoftazurecommunicationsnosubscriptioncreate
        with:
          supportTicketName: rest.supportTicketName
          communicationName: rest.communicationName
          createCommunicationParameters: rest.createCommunicationParameters
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-support/supporttickets/{supportticketname}/checknameavailability
      name: subscriptions-subscriptionid-providers-microsoft-support-supporttickets-supportt
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.Support-supportTickets-supportT.
      operations:
      - method: POST
        name: microsoftazurecommunicationschecknameavailability
        description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Support Supporttickets Supportticketname
          Checknameavailability
        call: microsoftsupport-communications.microsoftazurecommunicationschecknameavailability
        with:
          supportTicketName: rest.supportTicketName
          checkNameAvailabilityInput: rest.checkNameAvailabilityInput
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-support/supporttickets/{supportticketname}/communications
      name: subscriptions-subscriptionid-providers-microsoft-support-supporttickets-supportt
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.Support-supportTickets-supportT.
      operations:
      - method: GET
        name: microsoftazurecommunicationslist
        description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Support Supporttickets Supportticketname
          Communications
        call: microsoftsupport-communications.microsoftazurecommunicationslist
        with:
          supportTicketName: rest.supportTicketName
          $top: rest.$top
          $filter: rest.$filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-support/supporttickets/{supportticketname}/communications/{communicationname}
      name: subscriptions-subscriptionid-providers-microsoft-support-supporttickets-supportt
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.Support-supportTickets-supportT.
      operations:
      - method: GET
        name: microsoftazurecommunicationsget
        description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Support Supporttickets Supportticketname
          Communications Communicationname
        call: microsoftsupport-communications.microsoftazurecommunicationsget
        with:
          supportTicketName: rest.supportTicketName
          communicationName: rest.communicationName
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: microsoftazurecommunicationscreate
        description: Microsoft Azure Put Subscriptions Subscriptionid Providers Microsoft Support Supporttickets Supportticketname
          Communications Communicationname
        call: microsoftsupport-communications.microsoftazurecommunicationscreate
        with:
          supportTicketName: rest.supportTicketName
          communicationName: rest.communicationName
          createCommunicationParameters: rest.createCommunicationParameters
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: microsoftsupport-communications-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Microsoft.Support — Communications. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-post-providers-microsoft
      description: Microsoft Azure Post Providers Microsoft Support Supporttickets Supportticketname Checknameavailability
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoftsupport-communications.microsoftazurecommunicationsnosubscriptionchecknameavailability
      with:
        supportTicketName: tools.supportTicketName
        checkNameAvailabilityInput: tools.checkNameAvailabilityInput
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-providers-microsoft
      description: Microsoft Azure Get Providers Microsoft Support Supporttickets Supportticketname Communications
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoftsupport-communications.microsoftazuresupportticketcommunicationsnosubscriptionlist
      with:
        supportTicketName: tools.supportTicketName
        $top: tools.$top
        $filter: tools.$filter
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-providers-microsoft-2
      description: Microsoft Azure Get Providers Microsoft Support Supporttickets Supportticketname Communications Communicationname
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoftsupport-communications.microsoftazurecommunicationsnosubscriptionget
      with:
        supportTicketName: tools.supportTicketName
        communicationName: tools.communicationName
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-put-providers-microsoft
      description: Microsoft Azure Put Providers Microsoft Support Supporttickets Supportticketname Communications Communicationname
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: microsoftsupport-communications.microsoftazurecommunicationsnosubscriptioncreate
      with:
        supportTicketName: tools.supportTicketName
        communicationName: tools.communicationName
        createCommunicationParameters: tools.createCommunicationParameters
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-post-subscriptions-subscriptionid
      description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Support Supporttickets Supportticketname
        Checknameavailability
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoftsupport-communications.microsoftazurecommunicationschecknameavailability
      with:
        supportTicketName: tools.supportTicketName
        checkNameAvailabilityInput: tools.checkNameAvailabilityInput
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid
      description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Support Supporttickets Supportticketname
        Communications
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoftsupport-communications.microsoftazurecommunicationslist
      with:
        supportTicketName: tools.supportTicketName
        $top: tools.$top
        $filter: tools.$filter
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid-2
      description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Support Supporttickets Supportticketname
        Communications Communicationname
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoftsupport-communications.microsoftazurecommunicationsget
      with:
        supportTicketName: tools.supportTicketName
        communicationName: tools.communicationName
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-put-subscriptions-subscriptionid
      description: Microsoft Azure Put Subscriptions Subscriptionid Providers Microsoft Support Supporttickets Supportticketname
        Communications Communicationname
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: microsoftsupport-communications.microsoftazurecommunicationscreate
      with:
        supportTicketName: tools.supportTicketName
        communicationName: tools.communicationName
        createCommunicationParameters: tools.createCommunicationParameters
      outputParameters:
      - type: object
        mapping: $.