--- title: Request, cURL & Response Payloads slug: voice-apis/nnbJ-request-curl-and-response-payloads createdAt: 2026-01-20T02:56:44.612Z --- # Endpoint (All Bridge Actions) **POST** :::BlockQuote /v2/accounts/{account\_sid}/bridges/{bridge\_sid}/actions ::: **Full URL** :::BlockQuote https\://cpaas-api.in.exotel.com/v2/accounts/{account\_sid}/bridges/{bridge\_sid}/actions ::: ## Authentication :::BlockQuote Authorization: Basic \ Content-Type: application/json ::: ## Common Response Payload (All Actions) :::BlockQuote \{ "request\_id": "abc123", "http\_code": 202, "response": \{ "data": \{ "bridge\_sid": "BRIDGE\_SID" } } } ::: :::BlockQuote Actions are asynchronous. Confirm success/failure via **external events**. ::: ## \ ### Request Parameters | Attribute | Required | Description | | ------------------- | -------- | ----------------------------------------------------- | | bridgeEventEndpoint | Yes | gRPC endpoint where bridge events should be delivered | ### Request Payload :::BlockQuote \{ "action\_custom\_param": "refer\_bridge", "exoml": "\\\\\" } ::: ### cURL :::BlockQuote curl --location 'https\://cpaas-api.in.exotel.com/v2/accounts/{account\_sid}/bridges/{bridge\_sid}/actions' \\ \--header 'Authorization: Basic \' \\ \--header 'Content-Type: application/json' \\ \--data '\{ "action\_custom\_param": "refer\_bridge", "exoml": "\\\\\" }' ::: ## \ ### Request Parameters | Attribute | Required | Description | | ---------- | -------- | -------------------------------------- | | Body (URL) | Yes | Public or authenticated audio file URL | ### Request Payload :::BlockQuote \{ "action\_custom\_param": "start\_play", "exoml": "\\\https\://example.com/audio.wav\\" } ::: ### cURL :::BlockQuote curl --location 'https\://cpaas-api.in.exotel.com/v2/accounts/{account\_sid}/bridges/{bridge\_sid}/actions' \\ \--header 'Authorization: Basic \' \\ \--header 'Content-Type: application/json' \\ \--data '\{ "action\_custom\_param": "start\_play", "exoml": "\\\https\://example.com/audio.wav\\" }' ::: ## \ ### Request Payload :::BlockQuote \{ "action\_custom\_param": "stop\_play", "exoml": "\\\\\" } ::: ### cURL :::BlockQuote curl --location 'https\://cpaas-api.in.exotel.com/v2/accounts/{account\_sid}/bridges/{bridge\_sid}/actions' \\ \--header 'Authorization: Basic \' \\ \--header 'Content-Type: application/json' \\ \--data '\{ "action\_custom\_param": "stop\_play", "exoml": "\\\\\" }' ::: ## \ (Say) ### Request Payload :::BlockQuote \{ "action\_custom\_param": "start\_say", "exoml": "\\\Hello everyone\\" } ::: ### cURL :::BlockQuote curl --location 'https\://cpaas-api.in.exotel.com/v2/accounts/{account\_sid}/bridges/{bridge\_sid}/actions' \\ \--header 'Authorization: Basic \' \\ \--header 'Content-Type: application/json' \\ \--data '\{ "action\_custom\_param": "start\_say", "exoml": "\\\Hello everyone\\" }' ::: ## \ ### Request Payload :::BlockQuote \{ "action\_custom\_param": "stop\_say", "exoml": "\\\\\" } ::: ### cURL :::BlockQuote curl --location 'https\://cpaas-api.in.exotel.com/v2/accounts/{account\_sid}/bridges/{bridge\_sid}/actions' \\ \--header 'Authorization: Basic \' \\ \--header 'Content-Type: application/json' \\ \--data '\{ "action\_custom\_param": "stop\_say", "exoml": "\\\\\" }' ::: ## \ ### Request Parameters | Attribute | Required | Description | | ----------- | -------- | --------------- | | format | No | wav, mp3 | | storageType | No | https, s3 | | storageURL | No | Upload endpoint | ### Request Payload :::BlockQuote \{ "action\_custom\_param": "start\_recording", "exoml": "\\\\\" } ::: ### cURL :::BlockQuote curl --location 'https\://cpaas-api.in.exotel.com/v2/accounts/{account\_sid}/bridges/{bridge\_sid}/actions' \\ \--header 'Authorization: Basic \' \\ \--header 'Content-Type: application/json' \\ \--data '\{ "action\_custom\_param": "start\_recording", "exoml": "\\\\\" }' ::: ## \ ### Request Payload :::BlockQuote \{ "action\_custom\_param": "stop\_recording", "exoml": "\\\\\" } ::: ### cURL :::BlockQuote curl --location 'https\://cpaas-api.in.exotel.com/v2/accounts/{account\_sid}/bridges/{bridge\_sid}/actions' \\ \--header 'Authorization: Basic \' \\ \--header 'Content-Type: application/json' \\ \--data '\{ "action\_custom\_param": "stop\_recording", "exoml": "\\\\\" }' :::