Sign in

v47

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-181,0851,7264.5 MB
Dialogflow Integration

Update stored Dialogflow Connection

Updates a stored Dialogflow Connection.

put/dialogflow_connections/{connection_id}

Path parameters

connection_idstring required

Uniquely identifies a Telnyx application (Call Control).

Request body

service_accountobject required

The JSON map to connect your Dialoglow account.

dialogflow_api'cx' | 'es'

Determine which Dialogflow will be used.

conversation_profile_idstring

The id of a configured conversation profile on your Dialogflow account. (If you use Dialogflow CX, this param is required)

locationstring

The region of your agent is. (If you use Dialogflow CX, this param is required)

environmentstring

Which Dialogflow environment will be used.

Example request

{
  "service_account": {
    "type": "service_account",
    "project_id": "your-project-id",
    "private_key_id": "your-private-key",
    "private_key": "-----BEGIN PRIVATE KEY-----\n-----END PRIVATE KEY-----",
    "client_email": "example@example.com",
    "client_id": "your-client-id",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/example%40example.iam.gserviceaccount.com"
  },
  "dialogflow_api": "cx",
  "conversation_profile_id": "a-VMHLWzTmKjiJw5S6O0-w",
  "location": "global",
  "environment": "development"
}

Response

Return details of the Dialogflow connection associated with the given CallControl connection.

Example response

{
  "data": {
    "record_type": "dialogflow_connections",
    "connection_id": "1234541231",
    "conversation_profile_id": "a-VMHLWzTmKjiJw5S6O0-w",
    "environment": "development",
    "service_account": "****"
  }
}