Skip to main content

Legs & Bridges API

The Legs API enables creation and management of individual call legs within the Exotel platform, supporting both PSTN and VoIP networks. Bridges connect multiple legs together.

Key Concepts​

  • Leg — A single call connection to one endpoint (phone number or SIP URI)
  • Bridge — Connects two or more active legs together for conversation

Base URL​

https://<base_url>/v2/accounts/<account_sid>/

Authentication​

HTTP Basic Authentication using your API key and token.

Network Types​

TypeDescription
pstnStandard phone network (default)
voipVoIP/SIP connection

Leg Events​

Events are delivered via gRPC to your configured endpoint:

EventDescription
leg_connectingLeg is being established
leg_ringingEndpoint is ringing
leg_answeredCall was answered
leg_terminatedCall ended
leg_failed_to_createLeg creation failed
amd_result_successAnswering machine detection result

Bridge Events​

EventDescription
bridge_createdBridge established
bridge_terminalBridge ended
leg_joined_bridgeA leg joined the bridge
leg_left_bridgeA leg left the bridge