v56

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-0710368288.1 KB

Legs

List a leg's audio streams

Returns every negotiated m=audio section on the leg, in m-line order. A single-stream call has exactly one entry, the primary.

get/legs/{id}/streams

Audio streams in m-line order

idstring required

Stream identifier, stable for the life of the dialog. The primary stream is always "0".

midstring

The stream's SDP a=mid token (RFC 5888), used to correlate it across offer/answer.

indexinteger required

Position of the stream's m= line in the SDP. Fixed for the life of the dialog (RFC 3264 §8).

primaryboolean required

True for the call's main bidirectional audio stream, which cannot be removed or attached to a room independently.

state'pending' | 'active' | 'removed' required

Negotiation state.

direction'sendrecv' | 'sendonly' | 'recvonly' | 'inactive' required

Negotiated media direction from this server's point of view.

desired_direction'sendrecv' | 'sendonly' | 'recvonly' | 'inactive'

Direction requested by the application. Survives hold/unhold, unlike the negotiated direction.

codecstring

Codec negotiated for this stream. Streams on one leg may use different codecs.

sample_rateinteger

Native sample rate of the stream's codec, in Hz.

local_portinteger

Local RTP port. Each stream binds its own port; a shared transport is undefined without BUNDLE (RFC 9143).

remote_addrstring

Remote RTP address media is currently sent to.

labelstring

The stream's a=label value (RFC 4574), for correlating it with external metadata.

contentstring

The stream's a=content value (RFC 4796), e.g. "main" for original audio and "alt" for a translated feed.

langstring

The stream's a=lang value (RFC 8866): a BCP 47 language tag such as "en" or "es-ES".

room_idstring

Room this stream's audio is mixed into. A secondary stream may sit in a different room than its leg.

rolestring

Routing role of this stream within its room. Streams carry their own role, independent of their leg's.