v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB

Call Control Applications

Update a call control application

Updates settings of an existing call control application.

patch/call_control_applications/{id}

Path parameters

idstring required

Example:1293384261075731499

Identifies the resource.

Request body

activeboolean

Specifies whether the connection can be used.

<code>Latency</code> directs Telnyx to route media through the site with the lowest round-trip time to the user's connection. Telnyx calculates this time using ICMP ping messages. This can be disabled by specifying a site to handle all media.

application_namestring required

A user-assigned name to help manage the application.

call_cost_in_webhooksboolean

Specifies if call cost webhooks should be sent for this Call Control Application.

dtmf_type'RFC 2833' | 'Inband' | 'SIP INFO'

Sets the type of DTMF digits sent from Telnyx to this Connection. Note that DTMF digits sent to Telnyx will be accepted in all formats.

first_command_timeoutboolean

Specifies whether calls to phone numbers associated with this connection should hangup after timing out.

first_command_timeout_secsinteger

Specifies how many seconds to wait before timing out a dial command.

redact_dtmf_debug_loggingboolean

When enabled, DTMF digits entered by users will be redacted in debug logs to protect PII data entered through IVR interactions.

tagsstring[]

Tags assigned to the Call Control Application.

webhook_api_version'1' | '2'

Determines which webhook format will be used, Telnyx API v1 or v2.

webhook_event_failover_urlstring url nullable

The failover URL where webhooks related to this connection will be sent if sending to the primary URL fails. Must include a scheme, such as 'https'.

webhook_event_urlstring url required

The URL where webhooks related to this connection will be sent. Must include a scheme, such as 'https'.

webhook_timeout_secsinteger nullable

Specifies how many seconds to wait before timing out a webhook.

Example request

{
  "active": false,
  "anchorsite_override": "Latency",
  "application_name": "call-router",
  "call_cost_in_webhooks": true,
  "dtmf_type": "Inband",
  "first_command_timeout": true,
  "first_command_timeout_secs": 10,
  "inbound": {
    "channel_limit": 10,
    "shaken_stir_enabled": true,
    "sip_subdomain": "example",
    "sip_subdomain_receive_settings": "only_my_connections"
  },
  "outbound": {
    "channel_limit": 10,
    "outbound_voice_profile_id": "1293384261075731499"
  },
  "redact_dtmf_debug_logging": true,
  "webhook_api_version": "1",
  "webhook_event_failover_url": "https://failover.example.com",
  "webhook_event_url": "https://example.com",
  "webhook_timeout_secs": 25
}

Response

Successful response with details about a call control application.

Example response

{
  "data": {
    "active": false,
    "anchorsite_override": "Latency",
    "application_name": "call-router",
    "call_cost_in_webhooks": false,
    "created_at": "2018-02-02T22:25:27.521Z",
    "dtmf_type": "Inband",
    "first_command_timeout": true,
    "first_command_timeout_secs": 10,
    "id": "1293384261075731499",
    "inbound": {
      "channel_limit": 10,
      "shaken_stir_enabled": true,
      "sip_subdomain": "example",
      "sip_subdomain_receive_settings": "only_my_connections"
    },
    "outbound": {
      "channel_limit": 10,
      "outbound_voice_profile_id": "1293384261075731499"
    },
    "record_type": "call_control_application",
    "redact_dtmf_debug_logging": true,
    "updated_at": "2018-02-02T22:25:27.521Z",
    "webhook_api_version": "1",
    "webhook_event_failover_url": "https://failover.example.com",
    "webhook_event_url": "https://example.com",
    "webhook_timeout_secs": 25
  }
}