bashcurl -X POST "https://{workspace_id}.firetell.app/api/v1/calls/make" \-H "Authorization: ApiKey YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"from": { "number": "+14155550100", "name": "VoiceBot Support" },"to": { "number": "+12125550123", "name": "John Doe" },"actions": [{"action": "stream","params": {"ws_url": "wss://bot.example.com/call-stream","track": "both","sample_rate": 8000,"bidirectional": true,"headers": {"Authorization": "Bearer YOUR_BOT_TOKEN"}}}]}'
| Parameter | Type / Default | Behavior |
|---|---|---|
| ws_url | string (required) | Publicly routable wss:// or ws:// URL. RFC 1918 private IPs, loopback, link-local, and cloud metadata addresses are blocked. |
| track | string β’ both | Which legs to stream: both (stereo β caller on left, callee on right), inbound (caller only), or outbound (callee only). |
| sample_rate | number β’ 8000 | PCM 16-bit little-endian sample rate in Hz: 8000 (G.711-compatible) or 16000 (wideband). |
| bidirectional | boolean β’ false | Set true to send mono PCM audio back into the caller channel. Requires an answered (ACTIVE) call. |
| answer_call | boolean β’ true | Answer the call before opening the stream. Only set false if a preceding action already answered the channel. |
| headers | object β’ optional | Custom HTTP headers included on the WebSocket upgrade handshake (e.g. Authorization tokens). Maximum 10 entries. |