Skip to main content

Update call

POST 
/texml/calls/:call_sid/update

Update TeXML call. Please note that the keys present in the payload MUST BE formatted in CamelCase as specified in the example.

Request ​

Path Parameters

    call_sid stringrequired

    The CallSid that identifies the call to update.

Body

required

Update Call request object

    Status string

    The value to set the call status to. Setting the status to completed ends the call.

    Url string

    The URL where TeXML will make a request to retrieve a new set of TeXML instructions to continue the call flow.

    Method string

    Possible values: [GET, POST]

    HTTP request type used for Url.

    FallbackUrl string

    A failover URL for which Telnyx will retrieve the TeXML call instructions if the Url is not responding.

    FallbackMethod string

    Possible values: [GET, POST]

    HTTP request type used for FallbackUrl.

    StatusCallback string

    URL destination for Telnyx to send status callback events to for the call.

    StatusCallbackMethod string

    Possible values: [GET, POST]

    HTTP request type used for StatusCallback.

    Texml string

    TeXML to replace the current one with.

Responses ​

200: Successful response upon updating a TeXML call.

Schema

    data

    object

    sid string
    status string

Request samples

curl -L 'https://api.telnyx.com/v2/texml/calls/:call_sid/update' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "Status": "completed"
}'

Response samples

{
  "data": {
    "sid": "c46e06d7-b78f-4b13-96b6-c576af9640ff",
    "status": "accepted"
  }
}