Skip to main content
POST
/
internal
/
v1
/
agentic-dial
/
bridge-ended
cURL
curl -X POST "https://api.us-1.platform.polyai.app/internal/v1/agentic-dial/bridge-ended" -H "Content-Type: application/json" -d '{"conversation_id":"conv_abc123xyz","bridge_duration_seconds":180,"call_duration_seconds":300}'
{
  "error_message": "<string>"
}

​
Overview

The bridge-ended endpoint receives notifications when a call bridge (transfer) completes. This internal endpoint is triggered automatically by the telephony system after a bridged call ends, allowing configured project functions to process bridge metadata and call duration information.

​
Use cases

  • Log bridge duration for analytics
  • Trigger post-transfer workflows
  • Update CRM systems with transfer outcomes
  • Calculate agent availability based on bridge time

​
Request body

The endpoint accepts the following parameters:
ParameterTypeRequiredDescription
conversation_idstringYesThe unique identifier for the conversation
bridge_duration_secondsnumberYesDuration of the bridge/transfer in seconds
call_duration_secondsnumberYesTotal call duration in seconds

​
Example request

{
  "conversation_id": "conv_abc123xyz",
  "bridge_duration_seconds": 180,
  "call_duration_seconds": 300
}

​
Behavior

When this endpoint receives a bridge-ended notification:
  1. The system extracts the conversation ID and bridge metadata
  2. Configured project functions are triggered with the bridge data
  3. Functions can access bridge duration and call duration for processing
  4. The conversation state is updated to reflect the bridge completion

​
Configuration

This endpoint is automatically configured when you set up call transfer/bridge functionality in your project. Contact your PolyAI representative to enable bridge-ended notifications for your project.

Authorizations

​
X-Api-Key
string
header
required

API key for the External Events webhook. Contact your PolyAI representative to obtain credentials.

Body

application/json
​
conversation_id
string
required

The unique identifier for the conversation

​
bridge_duration_seconds
number
required

Duration of the bridge/transfer in seconds

​
call_duration_seconds
number
required

Total call duration in seconds

Response

Bridge ended notification received and processed successfully.