Microsoft Azure Content_Recording API

The Content_Recording API from Microsoft Azure — 4 operation(s) for content_recording.

Documentation GitHub OpenAPI

Operations 5

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

POST /calling/recordings Start recording a call · Microsoft Azure Start Recording The Call #

Ask an LLM

“How do I start recording an ongoing call with Azure Communication Services?”

“Can I choose the recording format and channel type when a call recording starts?”

Tell an agent

Start recording the call at locator {callLocator}.

Record call {callLocator} as {format} with {channel} channels, notifying {callbackUri}.

GET /calling/recordings/{recordingId} Get call recording properties · Microsoft Azure Get Call Recording Properties #

Ask an LLM

“How can I check whether a call recording is active or paused?”

“What properties can I read for a call recording by its ID?”

Tell an agent

Get the properties of recording {recordingId}.

Check the current state of call recording {recordingId}.

DELETE /calling/recordings/{recordingId} Stop recording a call · Microsoft Azure Stop Recording The Call #

Ask an LLM

“Can I stop a call recording for good?”

“What ends an in-progress call recording?”

Tell an agent destructive · confirm first

Stop recording {recordingId}.

End call recording {recordingId} permanently.

POST /calling/recordings/{recordingId}:pause Pause a call recording · Microsoft Azure Pause Recording The Call #

Ask an LLM

“Can I temporarily pause a call recording without ending it?”

“How do I pause recording while sensitive details are discussed on a call?”

Tell an agent

Pause recording {recordingId}.

Temporarily pause call recording {recordingId}.

POST /calling/recordings/{recordingId}:resume Resume a paused call recording · Microsoft Azure Resume Recording The Call #

Ask an LLM

“Can I resume a call recording that I paused?”

“What picks a paused call recording back up?”

Tell an agent

Resume recording {recordingId}.

Continue the paused call recording {recordingId}.

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:microsoft-azure-content-recording-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: 2022-04-07-preview
  title: Microsoft Azure Azure Communication Service Call Automation…
  description: Azure Communication Service Call Automation APIs
tags:
- name: Content_Recording
paths:
  /calling/recordings:
    post:
      tags:
      - Content_Recording
      summary: Microsoft Azure Start Recording The Call
      operationId: microsoftAzureContentRecording
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - name: Repeatability-Request-ID
        in: header
        description: If specified, the client directs that the request is repeatable; that is, that the client can make the request multiple times with the same Repeatability-Request-Id and get back an appropriate response without the server executing the request multiple times. The value of the Repeatability-Request-Id is an opaque string representing a client-generated unique identifier for the request. It is a version 4 (random) UUID.
        schema:
          type: string
          format: uuid
      - name: Repeatability-First-Sent
        in: header
        description: 'If Repeatability-Request-ID header is specified, then Repeatability-First-Sent header must also be specified. The value should be the date and time at which the request was first created, expressed using the IMF-fixdate form of HTTP-date. Example: Sun, 06 Nov 1994 08:49:37 GMT.'
        schema:
          type: string
      responses:
        '200':
          description: Returns the start call recording response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordingStateResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
      x-ms-examples:
        Start recording the call.:
          $ref: ./examples/Content_Recording.json
      description: Needs a more full description created.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartCallRecordingRequest'
        description: The request body of start call recording request.
        required: true
  /calling/recordings/{recordingId}:
    get:
      tags:
      - Content_Recording
      summary: Microsoft Azure Get Call Recording Properties
      operationId: microsoftAzureServercallsGetrecordingproperties
      parameters:
      - name: recordingId
        in: path
        description: The recording id.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: Returns the recording properties.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordingStateResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
      x-ms-examples:
        Get call recording properties.:
          $ref: ./examples/ServerCalls_GetRecordingProperties.json
      description: Needs a more full description created.
    delete:
      tags:
      - Content_Recording
      summary: Microsoft Azure Stop Recording The Call
      operationId: microsoftAzureServercallsStoprecording
      parameters:
      - name: recordingId
        in: path
        description: The recording id.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '204':
          description: Returns the stop call recording response.
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
      x-ms-examples:
        Stop recording the call.:
          $ref: ./examples/ServerCalls_StopRecording.json
      description: Needs a more full description created.
  /calling/recordings/{recordingId}:pause:
    post:
      tags:
      - Content_Recording
      summary: Microsoft Azure Pause Recording The Call
      operationId: microsoftAzureServercallsPauserecording
      parameters:
      - name: recordingId
        in: path
        description: The recording id.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '202':
          description: Returns the pause call recording response.
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
      x-ms-examples:
        Pause recording the call.:
          $ref: ./examples/ServerCalls_PauseRecording.json
      description: Needs a more full description created.
  /calling/recordings/{recordingId}:resume:
    post:
      tags:
      - Content_Recording
      summary: Microsoft Azure Resume Recording The Call
      operationId: microsoftAzureServercallsResumerecording
      parameters:
      - name: recordingId
        in: path
        description: The recording id.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '202':
          description: Returns the resume call recording response.
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
      x-ms-examples:
        Resume recording the call.:
          $ref: ./examples/ServerCalls_ResumeRecording.json
      description: Needs a more full description created.
components:
  parameters:
    ApiVersionParameter:
      name: api-version
      in: query
      description: Version of API to invoke.
      required: true
      x-ms-parameter-location: method
      schema:
        type: string
  schemas:
    RecordingFormatType:
      description: The format type of call recording.
      enum:
      - wav
      - mp3
      - mp4
      type: string
      x-ms-enum:
        name: RecordingFormatType
        modelAsString: true
    CallLocatorKind:
      description: The call locator kind.
      enum:
      - groupCallLocator
      - serverCallLocator
      type: string
      x-ms-enum:
        name: CallLocatorKind
        modelAsString: true
    StartCallRecordingRequest:
      description: The request payload start for call recording operation with call locator.
      required:
      - callLocator
      type: object
      properties:
        callLocator:
          $ref: '#/components/schemas/CallLocator'
          description: The call locator.
        recordingStateCallbackUri:
          description: The uri to send notifications to.
          type: string
        recordingContentType:
          $ref: '#/components/schemas/RecordingContentType'
        recordingChannelType:
          $ref: '#/components/schemas/RecordingChannelType'
        recordingFormatType:
          $ref: '#/components/schemas/RecordingFormatType'
        audioChannelParticipantOrdering:
          description: 'The sequential order in which audio channels are assigned to participants in the unmixed recording.

            When ''recordingChannelType'' is set to ''unmixed'' and `audioChannelParticipantOrdering is not specified,

            the audio channel to participant mapping will be automatically assigned based on the order in which participant

            first audio was detected.  Channel to participant mapping details can be found in the metadata of the recording.'
          type: array
          items:
            $ref: '#/components/schemas/CommunicationIdentifierModel'
    PhoneNumberIdentifierModel:
      required:
      - value
      type: object
      properties:
        value:
          type: string
    CommunicationError:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
        target:
          type: string
        details:
          type: array
          items:
            $ref: '#/components/schemas/CommunicationError'
        innererror:
          $ref: '#/components/schemas/CommunicationError'
    RecordingContentType:
      description: The content type of call recording.
      enum:
      - audio
      - audioVideo
      type: string
      x-ms-enum:
        name: RecordingContentType
        modelAsString: true
    RecordingChannelType:
      description: The channel type of call recording.
      enum:
      - mixed
      - unmixed
      type: string
      x-ms-enum:
        name: RecordingChannelType
        modelAsString: true
    CommunicationIdentifierModel:
      type: object
      properties:
        rawId:
          description: Full ID of the identifier.
          type: string
        kind:
          $ref: '#/components/schemas/CommunicationIdentifierModelKind'
        communicationUser:
          $ref: '#/components/schemas/CommunicationUserIdentifierModel'
          description: The communication user.
        phoneNumber:
          $ref: '#/components/schemas/PhoneNumberIdentifierModel'
          description: The phone number.
        microsoftTeamsUser:
          $ref: '#/components/schemas/MicrosoftTeamsUserIdentifierModel'
          description: The Microsoft Teams user.
    MicrosoftTeamsUserIdentifierModel:
      required:
      - userId
      type: object
      properties:
        userId:
          type: string
        isAnonymous:
          type: boolean
        cloud:
          $ref: '#/components/schemas/CommunicationCloudEnvironmentModel'
    RecordingState:
      enum:
      - active
      - inactive
      type: string
      x-ms-enum:
        name: RecordingState
        modelAsString: true
    CallLocator:
      description: The locator used for joining or taking action on a call.
      type: object
      properties:
        groupCallId:
          description: The group call id
          type: string
        serverCallId:
          description: The server call id.
          type: string
        kind:
          $ref: '#/components/schemas/CallLocatorKind'
    CommunicationUserIdentifierModel:
      required:
      - id
      type: object
      properties:
        id:
          type: string
    RecordingStateResponse:
      type: object
      properties:
        recordingId:
          type: string
        recordingState:
          $ref: '#/components/schemas/RecordingState'
    CommunicationErrorResponse:
      description: The Communication Services error response
      required:
      - error
      type: object
      properties:
        error:
          $ref: '#/components/schemas/CommunicationError'
    CommunicationCloudEnvironmentModel:
      enum:
      - public
      - dod
      - gcch
      type: string
      x-ms-enum:
        name: CommunicationCloudEnvironmentModel
        modelAsString: true
    CommunicationIdentifierModelKind:
      description: Type of CommunicationIdentifierModel.
      enum:
      - unknown
      - communicationUser
      - phoneNumber
      - microsoftTeamsUser
      type: string
      x-ms-enum:
        name: CommunicationIdentifierModelKind
        modelAsString: true
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - name: endpoint
    description: The endpoint of the Azure Communication resource.
    required: true
    type: string
    format: url
    in: path
    x-ms-skip-url-encoding: true
    x-ms-parameter-location: client

Microsoft Azure Content_Recording API

Operations 5

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification