Microsoft Azure

Microsoft Azure Voice Services Provisioning

Microsoft Azure Voice Services Provisioning is a service that enables developers to easily add voice capabilities to their applications and devices. With this service, developers can create voice-enabled applications that can recognize and understand speech, convert text to speech, and even provide natural language understanding. This allows for a more seamless and user-friendly experience for users interacting with the application through voice commands.

GitHub OpenAPI

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/azure/communications-gateway/provisioning-platform

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/openapi/microsoftvoiceservicesprovisioning-openapi-original.yml

OpenAPI Specification

microsoftvoiceservicesprovisioning-openapi-original.yml Raw ↑ 
swagger: '2.0'
info:
  title: Microsoft Azure Microsoft.VoiceServices.Provisioning
  version: 2024-02-29-preview
  x-typespec-generated:
    - emitter: '@azure-tools/typespec-autorest'
schemes:
  - https
produces:
  - application/json
consumes:
  - application/json
security:
  - OAuth2Auth:
      - https://func-voiceservice-rp-prod-eastuseuap.azurewebsites.net/.default
securityDefinitions:
  OAuth2Auth:
    type: oauth2
    flow: application
    scopes:
      https://func-voiceservice-rp-prod-eastuseuap.azurewebsites.net/.default: ''
    tokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
tags:
  - name: Account
  - name: BatchNumbers
  - name: Number
  - name: Numbers
  - name: TeamsAvailableCapabilities
  - name: TeamsCapabilityPlans
  - name: TeamsCivicAddress
  - name: TeamsCivicAddresses
  - name: TeamsRequestForInformation
paths:
  /accounts:
    get:
      operationId: microsoftAzureAccountsList
      tags:
        - Account
      summary: Microsoft Azure Get List Of Accounts
      description: >-
        Get list of Accounts with details. An Account represents an Enterprise
        or collection of users.
      parameters:
        - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
        - $ref: '#/parameters/Azure.Core.TopQueryParameter'
        - $ref: '#/parameters/Azure.Core.SkipQueryParameter'
        - $ref: '#/parameters/Azure.Core.MaxPageSizeQueryParameter'
        - $ref: '#/parameters/FilterQueryParameter'
        - $ref: '#/parameters/RecordCountQueryParameter'
        - $ref: '#/parameters/Azure.Core.ClientRequestIdHeader'
      responses:
        '200':
          description: The request has succeeded.
          schema:
            $ref: '#/definitions/PagedAccountResource'
          headers:
            x-ms-client-request-id:
              type: string
              format: uuid
              description: >-
                An opaque, globally-unique, client-generated string identifier
                for the request.
            x-ms-record-count:
              type: integer
              format: int32
              description: The total number of records available for this request.
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              description: String error code indicating what went wrong.
      x-ms-examples:
        Get list of Accounts.:
          $ref: ./examples/ListAccounts.json
      x-ms-pageable:
        nextLinkName: nextLink
  /accounts/{accountName}:
    get:
      operationId: microsoftAzureAccountsGet
      tags:
        - Account
      summary: 'Microsoft Azure Get Account'
      description: >-
        Get details of a specific Account using its Name. An Account represents
        an Enterprise or collection of users.
      parameters:
        - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
        - name: accountName
          in: path
          description: Name of the account.
          required: true
          type: string
          minLength: 1
          maxLength: 100
          pattern: ^([A-Za-z0-9_-]+)$
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifMatch'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifNoneMatch'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifUnmodifiedSince'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifModifiedSince'
        - $ref: '#/parameters/Azure.Core.ClientRequestIdHeader'
      responses:
        '200':
          description: The request has succeeded.
          schema:
            $ref: '#/definitions/AccountResource'
          headers:
            ETag:
              type: string
              description: The entity tag for the response.
            x-ms-client-request-id:
              type: string
              format: uuid
              description: >-
                An opaque, globally-unique, client-generated string identifier
                for the request.
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              description: String error code indicating what went wrong.
      x-ms-examples:
        Get Account.:
          $ref: ./examples/GetAccount.json
    put:
      operationId: microsoftAzureAccountsCreateorreplace
      tags:
        - Account
      summary: 'Microsoft Azure Create Or Replace Account'
      description: Create or replace the details of an Account.
      parameters:
        - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
        - name: accountName
          in: path
          description: Name of the account.
          required: true
          type: string
          minLength: 1
          maxLength: 100
          pattern: ^([A-Za-z0-9_-]+)$
        - $ref: >-
            #/parameters/Azure.Core.RepeatabilityRequestHeaders.repeatabilityRequestId
        - $ref: >-
            #/parameters/Azure.Core.RepeatabilityRequestHeaders.repeatabilityFirstSent
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifMatch'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifNoneMatch'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifUnmodifiedSince'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifModifiedSince'
        - $ref: '#/parameters/Azure.Core.ClientRequestIdHeader'
        - name: resource
          in: body
          description: The resource instance.
          required: true
          schema:
            $ref: '#/definitions/AccountResource'
      responses:
        '200':
          description: The request has succeeded.
          schema:
            $ref: '#/definitions/AccountResource'
          headers:
            ETag:
              type: string
              description: The entity tag for the response.
            Repeatability-Result:
              type: string
              description: >-
                Indicates whether the repeatable request was accepted or
                rejected.
              enum:
                - accepted
                - rejected
              x-ms-enum:
                name: RepeatabilityResult
                modelAsString: false
                values:
                  - name: accepted
                    value: accepted
                    description: >-
                      If the request was accepted and the server guarantees that
                      the server state reflects a single execution of the
                      operation.
                  - name: rejected
                    value: rejected
                    description: >-
                      If the request was rejected because the combination of
                      Repeatability-First-Sent and Repeatability-Request-ID were
                      invalid

                      or because the Repeatability-First-Sent value was outside
                      the range of values held by the server.
            x-ms-client-request-id:
              type: string
              format: uuid
              description: >-
                An opaque, globally-unique, client-generated string identifier
                for the request.
        '201':
          description: >-
            The request has succeeded and a new resource has been created as a
            result.
          schema:
            $ref: '#/definitions/AccountResource'
          headers:
            ETag:
              type: string
              description: The entity tag for the response.
            Repeatability-Result:
              type: string
              description: >-
                Indicates whether the repeatable request was accepted or
                rejected.
              enum:
                - accepted
                - rejected
              x-ms-enum:
                name: RepeatabilityResult
                modelAsString: false
                values:
                  - name: accepted
                    value: accepted
                    description: >-
                      If the request was accepted and the server guarantees that
                      the server state reflects a single execution of the
                      operation.
                  - name: rejected
                    value: rejected
                    description: >-
                      If the request was rejected because the combination of
                      Repeatability-First-Sent and Repeatability-Request-ID were
                      invalid

                      or because the Repeatability-First-Sent value was outside
                      the range of values held by the server.
            x-ms-client-request-id:
              type: string
              format: uuid
              description: >-
                An opaque, globally-unique, client-generated string identifier
                for the request.
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              description: String error code indicating what went wrong.
      x-ms-examples:
        Create or replace Account.:
          $ref: ./examples/PutAccount.json
    delete:
      operationId: microsoftAzureAccountsDelete
      tags:
        - Account
      summary: 'Microsoft Azure Delete Account'
      description: >-
        Delete a specific Account using its Name. This will fail if any Numbers
        are provisioned on the Account.
      parameters:
        - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
        - name: accountName
          in: path
          description: Name of the account.
          required: true
          type: string
          minLength: 1
          maxLength: 100
          pattern: ^([A-Za-z0-9_-]+)$
        - $ref: '#/parameters/DeleteNumbersQueryParameter'
        - $ref: >-
            #/parameters/Azure.Core.RepeatabilityRequestHeaders.repeatabilityRequestId
        - $ref: >-
            #/parameters/Azure.Core.RepeatabilityRequestHeaders.repeatabilityFirstSent
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifMatch'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifNoneMatch'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifUnmodifiedSince'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifModifiedSince'
        - $ref: '#/parameters/Azure.Core.ClientRequestIdHeader'
      responses:
        '204':
          description: >-
            There is no content to send for this request, but the headers may be
            useful. 
          headers:
            Repeatability-Result:
              type: string
              description: >-
                Indicates whether the repeatable request was accepted or
                rejected.
              enum:
                - accepted
                - rejected
              x-ms-enum:
                name: RepeatabilityResult
                modelAsString: false
                values:
                  - name: accepted
                    value: accepted
                    description: >-
                      If the request was accepted and the server guarantees that
                      the server state reflects a single execution of the
                      operation.
                  - name: rejected
                    value: rejected
                    description: >-
                      If the request was rejected because the combination of
                      Repeatability-First-Sent and Repeatability-Request-ID were
                      invalid

                      or because the Repeatability-First-Sent value was outside
                      the range of values held by the server.
            x-ms-client-request-id:
              type: string
              format: uuid
              description: >-
                An opaque, globally-unique, client-generated string identifier
                for the request.
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              description: String error code indicating what went wrong.
      x-ms-examples:
        Delete Account.:
          $ref: ./examples/DeleteAccount.json
  /accounts/{accountName}:createOrUpdateNumbers:
    post:
      operationId: microsoftAzureAccountsCreateorupdatenumbers
      tags:
        - BatchNumbers
      summary: 'Microsoft Azure Create Or Update Numbers'
      description: Create or update up to 100 Numbers on the specified account.
      parameters:
        - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
        - name: accountName
          in: path
          description: Name of the account.
          required: true
          type: string
          minLength: 1
          maxLength: 100
          pattern: ^([A-Za-z0-9_-]+)$
        - $ref: >-
            #/parameters/Azure.Core.RepeatabilityRequestHeaders.repeatabilityRequestId
        - $ref: >-
            #/parameters/Azure.Core.RepeatabilityRequestHeaders.repeatabilityFirstSent
        - $ref: '#/parameters/Azure.Core.ClientRequestIdHeader'
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/BatchNumbers'
      responses:
        '200':
          description: The request has succeeded.
          schema:
            $ref: '#/definitions/BatchNumbers'
          headers:
            Repeatability-Result:
              type: string
              description: >-
                Indicates whether the repeatable request was accepted or
                rejected.
              enum:
                - accepted
                - rejected
              x-ms-enum:
                name: RepeatabilityResult
                modelAsString: false
                values:
                  - name: accepted
                    value: accepted
                    description: >-
                      If the request was accepted and the server guarantees that
                      the server state reflects a single execution of the
                      operation.
                  - name: rejected
                    value: rejected
                    description: >-
                      If the request was rejected because the combination of
                      Repeatability-First-Sent and Repeatability-Request-ID were
                      invalid

                      or because the Repeatability-First-Sent value was outside
                      the range of values held by the server.
            x-ms-client-request-id:
              type: string
              format: uuid
              description: >-
                An opaque, globally-unique, client-generated string identifier
                for the request.
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              description: String error code indicating what went wrong.
      x-ms-examples:
        Create or update Numbers.:
          $ref: ./examples/PostAccountNumbersBatch.json
  /accounts/{accountName}:deleteNumbers:
    post:
      operationId: microsoftAzureAccountsDeletenumbers
      tags:
        - BatchNumbers
      summary: 'Microsoft Azure Delete Numbers'
      description: Delete up to 100 Numbers on the specified account.
      parameters:
        - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
        - name: accountName
          in: path
          description: Name of the account.
          required: true
          type: string
          minLength: 1
          maxLength: 100
          pattern: ^([A-Za-z0-9_-]+)$
        - $ref: >-
            #/parameters/Azure.Core.RepeatabilityRequestHeaders.repeatabilityRequestId
        - $ref: >-
            #/parameters/Azure.Core.RepeatabilityRequestHeaders.repeatabilityFirstSent
        - $ref: '#/parameters/Azure.Core.ClientRequestIdHeader'
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/BatchNumbersDelete'
      responses:
        '204':
          description: >-
            There is no content to send for this request, but the headers may be
            useful. 
          headers:
            Repeatability-Result:
              type: string
              description: >-
                Indicates whether the repeatable request was accepted or
                rejected.
              enum:
                - accepted
                - rejected
              x-ms-enum:
                name: RepeatabilityResult
                modelAsString: false
                values:
                  - name: accepted
                    value: accepted
                    description: >-
                      If the request was accepted and the server guarantees that
                      the server state reflects a single execution of the
                      operation.
                  - name: rejected
                    value: rejected
                    description: >-
                      If the request was rejected because the combination of
                      Repeatability-First-Sent and Repeatability-Request-ID were
                      invalid

                      or because the Repeatability-First-Sent value was outside
                      the range of values held by the server.
            x-ms-client-request-id:
              type: string
              format: uuid
              description: >-
                An opaque, globally-unique, client-generated string identifier
                for the request.
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              description: String error code indicating what went wrong.
      x-ms-examples:
        Delete batches of numbers.:
          $ref: ./examples/PostAccountNumbersDelete.json
  /accounts/{accountName}:getTeamsCapabilityPlans:
    post:
      operationId: microsoftAzureAccountsGetteamscapabilityplans
      tags:
        - TeamsCapabilityPlans
      summary: 'Microsoft Azure Get Teams Usages'
      description: Get a list of Teams capability plans on the specified account.
      parameters:
        - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
        - name: accountName
          in: path
          description: Name of the account.
          required: true
          type: string
          minLength: 1
          maxLength: 100
          pattern: ^([A-Za-z0-9_-]+)$
        - $ref: >-
            #/parameters/Azure.Core.RepeatabilityRequestHeaders.repeatabilityRequestId
        - $ref: >-
            #/parameters/Azure.Core.RepeatabilityRequestHeaders.repeatabilityFirstSent
        - $ref: '#/parameters/Azure.Core.ClientRequestIdHeader'
      responses:
        '200':
          description: The request has succeeded.
          schema:
            $ref: '#/definitions/TeamsCapabilityPlans'
          headers:
            Repeatability-Result:
              type: string
              description: >-
                Indicates whether the repeatable request was accepted or
                rejected.
              enum:
                - accepted
                - rejected
              x-ms-enum:
                name: RepeatabilityResult
                modelAsString: false
                values:
                  - name: accepted
                    value: accepted
                    description: >-
                      If the request was accepted and the server guarantees that
                      the server state reflects a single execution of the
                      operation.
                  - name: rejected
                    value: rejected
                    description: >-
                      If the request was rejected because the combination of
                      Repeatability-First-Sent and Repeatability-Request-ID were
                      invalid

                      or because the Repeatability-First-Sent value was outside
                      the range of values held by the server.
            x-ms-client-request-id:
              type: string
              format: uuid
              description: >-
                An opaque, globally-unique, client-generated string identifier
                for the request.
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              description: String error code indicating what went wrong.
      x-ms-examples:
        Get the list of capability plans available to this account.:
          $ref: ./examples/PostGetAccountTeamsCapabilityPlans.json
  /accounts/{accountName}:getTeamsAvailableCapabilities:
    post:
      operationId: microsoftAzureAccountsGetteamsavailablecapabilities
      tags:
        - TeamsAvailableCapabilities
      summary: 'Microsoft Azure Get Teams Available Capabilities'
      description: Get a list of Teams Available Capabilities on the specified account.
      parameters:
        - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
        - name: accountName
          in: path
          description: Name of the account.
          required: true
          type: string
          minLength: 1
          maxLength: 100
          pattern: ^([A-Za-z0-9_-]+)$
        - $ref: >-
            #/parameters/Azure.Core.RepeatabilityRequestHeaders.repeatabilityRequestId
        - $ref: >-
            #/parameters/Azure.Core.RepeatabilityRequestHeaders.repeatabilityFirstSent
        - $ref: '#/parameters/Azure.Core.ClientRequestIdHeader'
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/NumberIdentifiers'
      responses:
        '200':
          description: The request has succeeded.
          schema:
            $ref: '#/definitions/TeamsAvailableCapabilities'
          headers:
            Repeatability-Result:
              type: string
              description: >-
                Indicates whether the repeatable request was accepted or
                rejected.
              enum:
                - accepted
                - rejected
              x-ms-enum:
                name: RepeatabilityResult
                modelAsString: false
                values:
                  - name: accepted
                    value: accepted
                    description: >-
                      If the request was accepted and the server guarantees that
                      the server state reflects a single execution of the
                      operation.
                  - name: rejected
                    value: rejected
                    description: >-
                      If the request was rejected because the combination of
                      Repeatability-First-Sent and Repeatability-Request-ID were
                      invalid

                      or because the Repeatability-First-Sent value was outside
                      the range of values held by the server.
            x-ms-client-request-id:
              type: string
              format: uuid
              description: >-
                An opaque, globally-unique, client-generated string identifier
                for the request.
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              description: String error code indicating what went wrong.
      x-ms-examples:
        Get the teams capabilities available to the numbers provided.:
          $ref: ./examples/PostGetAccountTeamsAvailableCapabilities.json
  /accounts/{accountName}/numbers:
    get:
      operationId: microsoftAzureAccountsListnumbers
      tags:
        - Number
      summary: 'Microsoft Azure Get Numbers'
      description: Get a list of Numbers on the specified account.
      parameters:
        - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
        - name: accountName
          in: path
          description: Name of the account.
          required: true
          type: string
          minLength: 1
          maxLength: 100
          pattern: ^([A-Za-z0-9_-]+)$
        - $ref: '#/parameters/Azure.Core.TopQueryParameter'
        - $ref: '#/parameters/Azure.Core.SkipQueryParameter'
        - $ref: '#/parameters/Azure.Core.MaxPageSizeQueryParameter'
        - $ref: '#/parameters/FilterQueryParameter'
        - $ref: '#/parameters/RecordCountQueryParameter'
        - $ref: '#/parameters/Azure.Core.ClientRequestIdHeader'
      responses:
        '200':
          description: The request has succeeded.
          schema:
            $ref: '#/definitions/PagedNumberResource'
          headers:
            x-ms-client-request-id:
              type: string
              format: uuid
              description: >-
                An opaque, globally-unique, client-generated string identifier
                for the request.
            x-ms-record-count:
              type: integer
              format: int32
              description: The total number of records available for this request.
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              description: String error code indicating what went wrong.
      x-ms-examples:
        Get list of Numbers on an Account.:
          $ref: ./examples/ListAccountNumbers.json
      x-ms-pageable:
        nextLinkName: nextLink
  /accounts/{accountName}/numbers/{telephoneNumber}:
    get:
      operationId: microsoftAzureAccountsGetnumber
      tags:
        - Number
      summary: 'Microsoft Azure Get Number'
      description: Get details of a specific Number using its telephone number.
      parameters:
        - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
        - name: accountName
          in: path
          description: Name of the account.
          required: true
          type: string
          minLength: 1
          maxLength: 100
          pattern: ^([A-Za-z0-9_-]+)$
        - name: telephoneNumber
          in: path
          description: Telephone number in E.164 format.
          required: true
          type: string
          minLength: 1
          maxLength: 16
          pattern: ^\+[1-9]\d+$
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifMatch'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifNoneMatch'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifUnmodifiedSince'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifModifiedSince'
        - $ref: '#/parameters/Azure.Core.ClientRequestIdHeader'
      responses:
        '200':
          description: The request has succeeded.
          schema:
            $ref: '#/definitions/NumberResource'
          headers:
            ETag:
              type: string
              description: The entity tag for the response.
            x-ms-client-request-id:
              type: string
              format: uuid
              description: >-
                An opaque, globally-unique, client-generated string identifier
                for the request.
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
          headers:
            x-ms-error-code:
              type: string
              description: String error code indicating what went wrong.
      x-ms-examples:
        Get a Number from an Account.:
          $ref: ./examples/GetAccountNumber.json
    put:
      operationId: microsoftAzureAccountsCreateorreplacenumber
      tags:
        - Number
      summary: 'Microsoft Azure Create Or Replace Number'
      description: Create or replace the details of a Number.
      parameters:
        - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
        - name: accountName
          in: path
          description: Name of the account.
          required: true
          type: string
          minLength: 1
          maxLength: 100
          pattern: ^([A-Za-z0-9_-]+)$
        - name: telephoneNumber
          in: path
          description: Telephone number in E.164 format.
          required: true
          type: string
          minLength: 1
          maxLength: 16
          pattern: ^\+[1-9]\d+$
        - $ref: >-
            #/parameters/Azure.Core.RepeatabilityRequestHeaders.repeatabilityRequestId
        - $ref: >-
            #/parameters/Azure.Core.RepeatabilityRequestHeaders.repeatabilityFirstSent
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifMatch'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifNoneMatch'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifUnmodifiedSince'
        - $ref: '#/parameters/Azure.Core.ConditionalRequestHeaders.ifModifiedSince'
        - $ref: '#/parameters/Azure.Core.ClientRequestIdHeader'
        - name: resource
          in: body
          description: The resource instance.
          required: true
          schema:
            $ref: '#/definitions/NumberResource'
      responses:
        '200':
          description: The request has succeeded.
          schema:
            $ref: '#/definitions/NumberResource'
          headers:
            ETag:
              type: string
              description: The entity tag for the response.
            Repeatability-Result:
              type: string
              description: >-
                Indicates whether the repeatable request was accepted or
                rejected.
              enum:
                - accepted
                - rejected
              x-ms-enum:
                name: RepeatabilityResult
                modelAsString: false
                values:
                  - name: accepted
                    value: accepted
                    description: >-
                      If the request was accepted and the server guarantees that
                      the server state reflects a single execution of the
                      operation.
                  - name: rejected
                    value: rejected
                    description: >-
                      If the request was rejected because the combination of
                      Repeatability-First-Sent and Repeatability-Request-ID were
                      invalid

                      or because the Repeatability-First-Sent value was outside
                      the range of values held by the server.
            x-ms-client-request-id:
              type: string
              format: uuid
              description: >-
                An opaque, globally-unique, client-generated string identifier
                for the request.
        '201':
          description: >-
            The request has succeeded and a new resource has been created as a
            result.
          schema:
            $ref: '#/definitions/NumberResource'
          headers:
            ETag:
              type: string
              description: The entity tag for the response.
            Repeatability-Result:
              type: string
              description: >-
                Indicates whether the repeatable request was accepted or
                rejected.
              enum:
                - accepted
                - rejected
              x-ms-enum:
                name: RepeatabilityResult
                modelAsString: false
                values:
                  - name: accepted
                    value: accepted
                    description: >

# --- truncated at 32 KB (97 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/openapi/microsoftvoiceservicesprovisioning-openapi-original.yml