Skip to main content

Attach connections to an outbound profile

PUT 
/termination/endpoints/:id/actions/attach_connections

Attaches the specified connections to an outbound profile if they are not already attached. Note that this endpoint never removes connections already attached.

Request ​

Path Parameters

    id stringrequired

    ID of outbound profile to update

Body

required

IDs of connections to attach to the outbound profile

    connection_ids string[]required

Responses ​

200: Outbound Profile updated response

Schema

    id stringrequired
    user_id stringrequired
    connections object[]required
    name stringrequired

    A user-supplied name to help with organization

    traffic_type integerrequired

    Possible values: [1, 2]

    Default value: 1

    Conversational = 1, Short Duration = 2

    service_plan integerrequired

    Possible values: [1, 2, 4]

    Default value: 4

    Indicates the coverage of the termination regions. International and Global are the same but International may only be used for high volume/short duration outbound profiles. 3 (EEA originated) has been retired and is now covered by Global. Possible values are: US = 1, International = 2, Global = 4

    cps_limit integerrequired

    Default value: 100

    ports integerrequired

    Must be no more than your concurrent call limit. Null means no limit.

    translation_rule stringrequired
    active booleanrequired

    Default value: true

    Defaults to true

    cps_limit_increase integerrequired
    tag_list string[]required
    usage_payment_method string

    Possible values: [tariff, rate-deck]

    Default value: rate-deck

    custom_rate_deck booleanrequired
    rate_deck_url stringrequired

    url to rate deck

    whitelisted_destination_format string

    Possible values: [alpha2, alpha3, iso_numeric]

    Default value: alpha3

    Format of your whitelisted destinations.

    whitelisted_destinations string[]

    Default value: US,CA

    The list of destinations you want to be able to call using this outbound profile.

    max_destination_rate float

    Maximum rate at which you can make a call using this outbound profile

    connection_id string

    To be deprecated, maintained for backward compatibility

    call_recording_type stringrequired

    Possible values: [all, none, by_call_phone_number]

    Defines how to filter which calls are recorded.

    call_recording_phone_numbers string[]required

    When call_recording_type is set to by_caller_phone_number, only outbound calls using one of these numbers will be recorded. Numbers must be specified in E164 format.

    call_recording_format stringrequired

    Possible values: [wav, mp3]

    Default value: wav

    The audio file format for calls being recorded.

    call_recording_channels stringrequired

    Possible values: [single, dual]

    Default value: single

    When using 'dual' channels, final audio file will be stereo recorded with the first leg on channel A, and the rest on channel B.

    daily_spend_limit stringrequired

    The maximum amount of usage charges, in USD, you want Telnyx to allow on this outbound profile in a day before disallowing new calls. Example: 100.00.

    daily_spend_limit_enabled booleanrequired

    Specifies whether to enforce the daily_spend_limit on this outbound profile.

    billing_group_id stringrequired

    The ID of the billing group to which the outbound profile is assigned. Defaults to null (for no group assigned).

400: Bad request

401: Unauthorized

Request samples

curl -L -X PUT 'https://api.telnyx.com/termination/endpoints/:id/actions/attach_connections' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
  "connection_ids": [
    "string"
  ]
}'

Response samples

{
  "id": "string",
  "user_id": "string",
  "connections": [
    {}
  ],
  "name": "string",
  "traffic_type": 1,
  "service_plan": 4,
  "cps_limit": 100,
  "ports": 0,
  "translation_rule": "string",
  "active": true,
  "cps_limit_increase": 0,
  "tag_list": [
    "string"
  ],
  "usage_payment_method": "rate-deck",
  "custom_rate_deck": false,
  "rate_deck_url": "string",
  "whitelisted_destination_format": "alpha3",
  "whitelisted_destinations": [
    "US",
    "BR",
    "AU"
  ],
  "max_destination_rate": 0,
  "connection_id": "string",
  "call_recording_type": "all",
  "call_recording_phone_numbers": [
    "string"
  ],
  "call_recording_format": "wav",
  "call_recording_channels": "single",
  "daily_spend_limit": "string",
  "daily_spend_limit_enabled": false,
  "billing_group_id": "string"
}