Update stored Dialogflow Connection

PUT 
/dialogflow_connections/:connection_id

Updates a stored Dialogflow Connection.

Path Parameters

connection_id stringrequired

Uniquely identifies a Telnyx application (Call Control).

application/json

Body

required

The params expected to create/update a Dialogflow Connection for given connection_id.

service_account objectrequired

The JSON map to connect your Dialoglow account.

dialogflow_api string

Possible values: [cx, es]

Default value: es

Determin which Dialogflow will be used.

conversation_profile_id string

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

location string

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

environment string

Which Dialogflow environment will be used.

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

application/json

• Schema
• Example (from schema)

Schema

data

object

required

record_type string

connection_id string

Uniquely identifies a Telnyx application (Call Control).

conversation_profile_id string

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

environment string

Which Dialogflow environment will be used.

service_account string

The JSON map to connect your Dialoglow account.

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

default: Unexpected error.

application/json

• Schema
• Example (from schema)

Schema

errors

Error[]

Array [

code integerrequired

title stringrequired

detail string

source

object

pointer json-pointer

JSON pointer (RFC6901) to the offending entity.

parameter string

Indicates which query parameter caused the error.

meta object

]

{
  "errors": [
    {
      "code": "string",
      "title": "string",
      "detail": "string",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {}
    }
  ]
}

Request samples

• cURL

---

curl -L -X PUT 'https://api.telnyx.com/v2/dialogflow_connections/:connection_id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "service_Account": "{\"type\":\"service_account\",\"project_id\":\"your-project-id\",\"private_key_id\":\"your-private-key\",\"private_key\":\"-----BEGIN PRIVATE KEY-----n-----END PRIVATE\",\"client_email\":\"example@example.com\",\"client_id\":\"your-client-id\",\"auth_uri\":\"http://example.com\",\"token_uri\":\"http://example.com\",\"auth_provider_x509_cert_url\":\"http://example.com\",\"client_x509_cert_url\":\"http://example.com\"}",
  "dialogflow_api": "cx",
  "conversation_profile_id": "a-VMHLWzTmKjiJw5S6O0-w",
  "location": "global",
  "environment": "development"
}'

Response samples

• 200
• default

---

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

{
  "errors": [
    {
      "code": "string",
      "title": "string",
      "detail": "string",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {}
    }
  ]
}