Microsoft Azure

Microsoft Azure SipConfiguration API

The SipConfiguration API from Microsoft Azure — 1 operation(s) for sipconfiguration.

Documentation GitHub OpenAPI

Operations 2

GET /sip Microsoft Azure Gets Sip Configuration For Resource #

PATCH /sip Microsoft Azure Updates Sip Configuration For Resource #

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/microsoft-azure-sipconfiguration-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

openapi: 3.2.0
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector Sip Configuration API
tags:
- name: SipConfiguration
paths:
  /sip:
    get:
      tags:
      - SipConfiguration
      summary: Microsoft Azure Gets Sip Configuration For Resource
      operationId: microsoftAzureSiproutingGet
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/ExpandSipConfiguration'
      responses:
        '200':
          description: Ok.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SipConfiguration'
        default:
          description: Failure
          headers:
            x-ms-error-code:
              description: Error code
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: ../../../Common/stable/2022-07-13/common.json#/definitions/CommunicationErrorResponse
      x-ms-examples:
        Get SIP configuration for resource with Trunk Health expand:
          $ref: ./examples/GetSipConfigurationWithExpand.json
      description: Needs a more full description created.
    patch:
      tags:
      - SipConfiguration
      summary: Microsoft Azure Updates Sip Configuration For Resource
      operationId: microsoftAzureSiproutingUpdate
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: Updated configuration is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SipConfiguration'
        default:
          description: Failure
          headers:
            x-ms-error-code:
              description: Error code
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: ../../../Common/stable/2022-07-13/common.json#/definitions/CommunicationErrorResponse
      x-ms-examples:
        Update SIP configuration for resource:
          $ref: ./examples/UpdateSipConfiguration.json
      description: Needs a more full description created.
      requestBody:
        content:
          application/merge-patch+json:
            schema:
              $ref: '#/components/schemas/SipConfigurationUpdate'
        description: Sip configuration update object.
components:
  schemas:
    SipConfiguration:
      description: 'Represents a SIP configuration.

        When a call is being routed the routes are applied in the same order as in the routes list.

        A route is matched by its number pattern.

        Call is then directed into route''s first available trunk, based on the order in the route''s trunks list. The configuration can be expanded with additional data.'
      type: object
      properties:
        domains:
          description: 'Validated Domains.

            Map key is domain.'
          maxProperties: 250
          type: object
          additionalProperties:
            $ref: '#/components/schemas/Domain'
        trunks:
          description: 'SIP trunks for routing calls.

            Map key is trunk''s FQDN (1-249 characters).'
          maxProperties: 250
          type: object
          additionalProperties:
            $ref: '#/components/schemas/Trunk'
        routes:
          description: Trunk routes for routing calls.
          maxItems: 250
          type: array
          items:
            $ref: '#/components/schemas/TrunkRoute'
    Enabled:
      type: boolean
      description: 'Flag if domain is enabled or not.

        If enabled it''s used in configuration, if not enabled it''s not used.'
    OverallHealth:
      type: object
      description: The overall health status of Trunk.
      required:
      - status
      properties:
        status:
          type: string
          description: The overall health status of Trunk.
          enum:
          - unknown
          - active
          - inactive
          x-ms-enum:
            name: overallHealthStatus
            modelAsString: true
            values:
            - value: unknown
              description: Indicates an unknown health status.
            - value: active
              description: Indicates the Trunk is active.
            - value: inactive
              description: Indicates the Trunk is inactive.
        reason:
          type: string
          description: The reason overall status of Trunk is inactive.
          enum:
          - noRecentCalls
          - noRecentPings
          - noRecentCallsAndPings
          x-ms-enum:
            name: inactiveStatusReason
            modelAsString: true
            values:
            - value: noRecentCalls
              description: Indicates no recent calls.
            - value: noRecentPings
              description: Indicates ping status is expired.
            - value: noRecentCallsAndPings
              description: Indicates no recent calls and ping status is expired.
    Ping:
      type: object
      description: The status of SIP OPTIONS message sent by Trunk.
      required:
      - status
      properties:
        status:
          type: string
          description: The status of SIP OPTIONS message sent by Trunk.
          enum:
          - unknown
          - ok
          - expired
          - error
          x-ms-enum:
            name: pingStatus
            modelAsString: true
            values:
            - value: unknown
              description: Indicates an unknown status.
            - value: ok
              description: Indicates the status is okay.
            - value: expired
              description: Indicates the status is expired.
            - value: error
              description: Indicates the status is at an error level.
    Domain:
      description: 'Represents Domain object as response of validation api.

        Map key is domain.'
      required:
      - enabled
      type: object
      properties:
        enabled:
          description: Enabled flag
          $ref: '#/components/schemas/Enabled'
    Health:
      description: Represents health state of a SIP trunk for routing calls.
      type: object
      required:
      - tls
      - ping
      - overall
      properties:
        tls:
          $ref: '#/components/schemas/Tls'
        ping:
          $ref: '#/components/schemas/Ping'
        overall:
          $ref: '#/components/schemas/OverallHealth'
    Tls:
      type: object
      description: The status of the TLS connections of the Trunk.
      required:
      - status
      properties:
        status:
          type: string
          description: The status of the TLS connections of the Trunk.
          enum:
          - unknown
          - ok
          - certExpiring
          - certExpired
          x-ms-enum:
            modelAsString: true
            name: tlsStatus
            values:
            - value: unknown
              description: Indicates an unknown status.
            - value: ok
              description: Indicates the status is okay.
            - value: certExpiring
              description: Indicates the Trunk certificate is expiring.
            - value: certExpired
              description: Indicates the Trunk certificate is expired.
    TrunkRoute:
      description: Represents a trunk route for routing calls.
      required:
      - name
      - numberPattern
      type: object
      properties:
        description:
          description: Gets or sets description of the route.
          maxLength: 1024
          type: string
        name:
          description: Gets or sets name of the route.
          maxLength: 256
          type: string
        numberPattern:
          description: 'Gets or sets regex number pattern for routing calls. .NET regex format is supported.

            The regex should match only digits with an optional ''+'' prefix without spaces.

            I.e. "^\+[1-9][0-9]{3,23}$".'
          maxLength: 1024
          type: string
        trunks:
          description: Gets or sets list of SIP trunks for routing calls. Trunks are represented as FQDN.
          maxItems: 250
          type: array
          items:
            type: string
    Trunk:
      description: Represents a SIP trunk for routing calls. See RFC 4904. Can be expanded with additional data.
      required:
      - sipSignalingPort
      - enabled
      type: object
      properties:
        sipSignalingPort:
          format: int32
          description: Gets or sets SIP signaling port of the trunk.
          type: integer
        enabled:
          description: Enabled flag
          $ref: '#/components/schemas/Enabled'
        health:
          description: Represents health state of a SIP trunk for routing calls.
          type: object
          readOnly: true
          $ref: '#/components/schemas/Health'
    TrunkUpdate:
      description: Represents a SIP trunk update.
      type: object
      properties:
        sipSignalingPort:
          format: int32
          description: Gets or sets SIP signaling port of the trunk.
          type: integer
        enabled:
          description: Enabled flag
          $ref: '#/components/schemas/Enabled'
    SipConfigurationUpdate:
      description: Represents a SIP configuration update.
      type: object
      properties:
        domains:
          description: 'Domains that will be used.

            Map key is domain.'
          type: object
          additionalProperties:
            $ref: '#/components/schemas/DomainPatch'
        trunks:
          description: 'SIP trunks for routing calls.

            Map key is trunk''s FQDN (1-249 characters).'
          maxProperties: 250
          type: object
          additionalProperties:
            $ref: '#/components/schemas/TrunkUpdate'
        routes:
          description: Trunk routes for routing calls.
          maxItems: 250
          type: array
          items:
            $ref: '#/components/schemas/TrunkRoute'
    DomainPatch:
      description: 'Represents Domain that will be used.

        Map key is domain.'
      type: object
      properties:
        enabled:
          description: Enabled flag
          $ref: '#/components/schemas/Enabled'
  parameters:
    ExpandSipConfiguration:
      name: expand
      in: query
      required: false
      description: Sip configuration expand. Optional.
      x-ms-parameter-location: method
      x-ms-enum:
        name: ExpandEnum
        modelAsString: true
        values:
        - value: trunks/health
          description: Health state of a SIP trunk for routing calls.
      schema:
        type: string
        enum:
        - trunks/health
    ApiVersionParameter:
      in: query
      name: api-version
      description: Version of API to invoke
      required: true
      schema:
        type: string
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/components/parameters/Endpoint'