Update a Domain Application

PUT 
/domain_applications/:id

Updates the specific domain application by setting the values of any parameters passed in. Any parameters not provided will be unchanged.

Permissions

The API token must include the following scopes: Voice.

Request

Path Parameters

id uuidrequired

Unique ID of the domain application

application/json

Body

required

oneOf

Relay Topic

call_handler string

Possible values: [relay_topic]

Specifies that this domain application uses a Relay topic handler

call_relay_topic string

A string representing the Relay topic to forward incoming calls to.

call_relay_topic_status_callback_url string

A string representing a URL to send status change messages to.

Relay Application

call_handler string

Possible values: [relay_application]

Specifies that this domain application uses a Relay application handler

call_relay_application string

A string representing the Relay Application to forward incoming calls to.

LaML Webhooks

call_handler string

Possible values: [laml_webhooks]

Specifies that this domain application uses LaML webhooks

call_request_url string

A string representing the LaML URL to access when a call is received.

call_request_method string

Possible values: [GET, POST]

A string representing the HTTP method to use with call_request_url.

call_fallback_url string

A string representing the LaML URL to access when the call to call_request_url fails.

call_fallback_method string

Possible values: [GET, POST]

A string representing the HTTP method to use with call_fallback_url.

call_status_callback_url string

A string representing a URL to send status change messages to.

call_status_callback_method string

Possible values: [GET, POST]

A string representing the HTTP method to use with call_status_callback_url.

LaML Application

call_handler string

Possible values: [laml_application]

Specifies that this domain application uses a LaML application

call_laml_application_id string

A string representing the ID of the LaML application to forward incoming calls to.

Video Room

call_handler string

Possible values: [video_room]

Specifies that this domain application uses a Video Room

call_video_room_id uuid

A string representing the ID of the Video Room to forward incoming calls to.

Relay Script

call_handler string

Possible values: [relay_script]

Specifies that this domain application uses a Relay script

call_relay_script_url string

A string representing the URL of the Relay script to execute when a call is received.

Dialogflow

call_handler string

Possible values: [dialogflow]

Specifies that this domain application uses a Dialogflow agent

call_dialogflow_agent_id uuid

A string representing the ID of the Dialogflow Agent to forward incoming calls to.

AI Agent

call_handler string

Possible values: [ai_agent]

Specifies that this domain application uses an AI agent

call_ai_agent_id uuid

A string representing the ID of the AI Agent to forward incoming calls to.

Call Flow

call_handler string

Possible values: [call_flow]

Specifies that this domain application uses a Call Flow

call_flow_id uuid

A string representing the ID of the Call Flow to forward incoming calls to.

call_flow_version string

Possible values: [working_copy, current_deployed]

A string representing the version of your Call Flow you'd like to use.

Relay Context (Deprecated)

call_handler string

Possible values: [relay_context]

This handler type is deprecated. Please use call_relay_application or call_relay_topic instead.

call_relay_context stringdeprecated

This handler type is deprecated. Please use call_relay_application or call_relay_topic instead.

call_relay_context_status_callback_url stringdeprecated

This property is deprecated. Please use call_relay_topic_status_callback_url instead.

name string

A string representing the friendly name for this domain application.

identifier string

A string representing the identifier portion of the domain application. Must be unique across your project. Must be letters, numbers, and dash only.

ip_auth_enabled boolean

Whether the domain application will enforce IP authentication for incoming requests.

ip_auth string[]

A list containing whitelisted IP addresses and IP blocks used if ip_auth_enabled is true.

encryption string

A string representing whether connections to this domain application require encryption or if encryption is optional. Encryption will always be used if possible. Valid values are optional and required.

codecs string[]

A list of codecs this domain application will support. Currently supported values are OPUS, G722, PCMU, PCMA, VP8, and H264. At least one value must be supplied.

ciphers string[]

A list of encryption ciphers this domain application will support. Currently supported values are AEAD_AES_256_GCM_8, AES_256_CM_HMAC_SHA1_80, AES_CM_128_HMAC_SHA1_80, AES_256_CM_HMAC_SHA1_32, and AES_CM_128_HMAC_SHA1_32. At least one value must be supplied.

Responses

200

OK

application/json

Schema

Schema

links

object

self string

first string

next string

prev string
data object[]

Example (from schema)

{
  "links": {
    "self": "string",
    "first": "string",
    "next": "string",
    "prev": "string"
  },
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "type": "domain_application",
      "domain": "your-space-test_id",
      "name": "Test App",
      "identifier": "test-id",
      "ip_auth_enabled": true,
      "ip_auth": [
        "8.8.8.8",
        "4.4.4.4"
      ],
      "call_handler": "relay_application",
      "call_request_url": null,
      "call_request_method": "POST",
      "call_fallback_url": null,
      "call_fallback_method": "POST",
      "call_status_callback_url": null,
      "call_status_callback_method": "POST",
      "call_relay_topic": "office",
      "call_relay_topic_status_callback_url": "https://myapplication/handle_relay_callbacks",
      "call_relay_application": null,
      "call_relay_script_url": null,
      "call_laml_application_id": null,
      "call_video_room_id": "fe4093d9-58c2-4931-b4b9-5679f82652c6",
      "call_dialogflow_agent_id": "fe4093d9-58c2-4931-b4b9-5679f82652c6",
      "call_ai_agent_id": "fe4093d9-58c2-4931-b4b9-5679f82652c6",
      "call_flow_id": "fe4093d9-58c2-4931-b4b9-5679f82652c6",
      "call_flow_version": "working_copy",
      "encryption": "required",
      "codecs": [
        "PCMU",
        "PCMA"
      ],
      "ciphers": [
        "AEAD_AES_256_GCM_8"
      ]
    }
  ]
}

Loading...