Call Media - Start Media Streaming

Service:
Communication
API Version:
2026-03-12

Starts media streaming in the call.

POST {endpoint}/calling/callConnections/{callConnectionId}:startMediaStreaming?api-version=2026-03-12

URI Parameters

Name In Required Type Description
callConnectionId
 path True

string

The call connection id.
endpoint
 path True

string (url)

The endpoint of the Azure Communication Service resource.
api-version
 query True

string

Version of the API to invoke.

Request Header

Name Required Type Description
Authorization True

string

An Azure Communication Services user access token.

Request Body

Name Type Description
operationCallbackUri

string

Set a callback URI that overrides the default callback URI set by CreateCall/AnswerCall for this operation. This setup is per-action. If this is not set, the default callback URI set by CreateCall/AnswerCall will be used.
operationContext

string

The value to identify context of the operation.

Responses

Name Type Description
202 Accepted

The service has accepted the start media streaming request and will begin processing it. You will receive either MediaStreamingStarted or MediaStreamingFailed event at your specified callback URI to update you on the status of the request.
Other Status Codes

CommunicationErrorResponse

Error

Security

Authorization

An Azure Communication Services user access token.

Type: apiKey
In: header

Examples

CallMedia_StartMediaStreaming

Sample request

POST https://contoso.communications.azure.com/calling/callConnections/18dea47f-b081-4107-9a5c-4300819d2c6c:startMediaStreaming?api-version=2026-03-12

{}

Sample response

Status code:
202

Definitions

StartMediaStreamingRequest

Object
Name Type Description
operationCallbackUri

string

Set a callback URI that overrides the default callback URI set by CreateCall/AnswerCall for this operation. This setup is per-action. If this is not set, the default callback URI set by CreateCall/AnswerCall will be used.
operationContext

string

The value to identify context of the operation.