---
title: "Updates an existing outbound voice profile."
method: PATCH
path: "/outbound_voice_profiles/{id}"
tags: ["Outbound Voice Profiles"]
---

# Updates an existing outbound voice profile.

`PATCH /outbound_voice_profiles/{id}`

Updates an existing outbound voice profile.

## Path parameters

- `id` string, required

## Request body

- UpdateOutboundVoiceProfileRequest
  - `name` string, required — A user-supplied name to help with organization.
  - `traffic_type` 'conversational' — Specifies the type of traffic allowed in this profile.
  - `service_plan` 'global' — Indicates the coverage of the termination regions.
  - `concurrent_call_limit` integer, nullable — Must be no more than your global concurrent call limit. Null means no limit.
  - `enabled` boolean — Specifies whether the outbound voice profile can be used. Disabled profiles will result in outbound calls being blocked for the associated Connections.
  - `tags` string[]
  - `usage_payment_method` 'rate-deck' — Setting for how costs for outbound profile are calculated.
  - `whitelisted_destinations` string[] — The list of destinations you want to be able to call using this outbound voice profile formatted in alpha2.
  - `max_destination_rate` number — Maximum rate (price per minute) for a Destination to be allowed when making outbound calls.
  - `daily_spend_limit` string — The maximum amount of usage charges, in USD, you want Telnyx to allow on this outbound voice profile in a day before disallowing new calls.
  - `daily_spend_limit_enabled` boolean — Specifies whether to enforce the daily_spend_limit on this outbound voice profile.
  - `call_recording` OutboundCallRecording
    - `call_recording_type` 'all' | 'none' | 'by_caller_phone_number' — Specifies which calls are recorded.
    - `call_recording_caller_phone_numbers` string[] — When call_recording_type is 'by_caller_phone_number', only outbound calls using one of these numbers will be recorded. Numbers must be specified in E164 format.
    - `call_recording_channels` 'single' | 'dual' — When using 'dual' channels, the final audio file will be a stereo recording with the first leg on channel A, and the rest on channel B.
    - `call_recording_format` 'wav' | 'mp3' — The audio file format for calls being recorded.
  - `billing_group_id` string, uuid, nullable — The ID of the billing group associated with the outbound proflile. Defaults to null (for no group assigned).
  - `calling_window` object — (BETA) Specifies the time window and call limits for calls made using this outbound voice profile.
    - `start_time` string, time — (BETA) The UTC time of day (in HH:MM format, 24-hour clock) when calls are allowed to start.
    - `end_time` string, time — (BETA) The UTC time of day (in HH:MM format, 24-hour clock) when calls are no longer allowed to start.
    - `calls_per_cld` integer — (BETA) The maximum number of calls that can be initiated to a single called party (CLD) within the calling window. A null value means no limit.

## Response `200`

Successful response

- object
  - `data` OutboundVoiceProfile
    - `id` string — Identifies the resource.
    - `record_type` string — Identifies the type of the resource.
    - `name` string, required — A user-supplied name to help with organization.
    - `connections_count` integer — Amount of connections associated with this outbound voice profile.
    - `traffic_type` 'conversational' — Specifies the type of traffic allowed in this profile.
    - `service_plan` 'global' — Indicates the coverage of the termination regions.
    - `concurrent_call_limit` integer, nullable — Must be no more than your global concurrent call limit. Null means no limit.
    - `enabled` boolean — Specifies whether the outbound voice profile can be used. Disabled profiles will result in outbound calls being blocked for the associated Connections.
    - `tags` string[]
    - `usage_payment_method` 'rate-deck' — Setting for how costs for outbound profile are calculated.
    - `whitelisted_destinations` string[] — The list of destinations you want to be able to call using this outbound voice profile formatted in alpha2.
    - `max_destination_rate` number — Maximum rate (price per minute) for a Destination to be allowed when making outbound calls.
    - `daily_spend_limit` string — The maximum amount of usage charges, in USD, you want Telnyx to allow on this outbound voice profile in a day before disallowing new calls.
    - `daily_spend_limit_enabled` boolean — Specifies whether to enforce the daily_spend_limit on this outbound voice profile.
    - `call_recording` OutboundCallRecording
      - `call_recording_type` 'all' | 'none' | 'by_caller_phone_number' — Specifies which calls are recorded.
      - `call_recording_caller_phone_numbers` string[] — When call_recording_type is 'by_caller_phone_number', only outbound calls using one of these numbers will be recorded. Numbers must be specified in E164 format.
      - `call_recording_channels` 'single' | 'dual' — When using 'dual' channels, the final audio file will be a stereo recording with the first leg on channel A, and the rest on channel B.
      - `call_recording_format` 'wav' | 'mp3' — The audio file format for calls being recorded.
    - `billing_group_id` string, uuid, nullable — The ID of the billing group associated with the outbound proflile. Defaults to null (for no group assigned).
    - `calling_window` object — (BETA) Specifies the time window and call limits for calls made using this outbound voice profile. Note that all times are UTC in 24-hour clock time.
      - `start_time` string — (BETA) The UTC time of day (in HH:MM format, 24-hour clock) when calls are allowed to start.
      - `end_time` string — (BETA) The UTC time of day (in HH:MM format, 24-hour clock) when calls are no longer allowed to start.
      - `calls_per_cld` integer — (BETA) The maximum number of calls that can be initiated to a single called party (CLD) within the calling window. A null value means no limit.
    - `created_at` string — ISO 8601 formatted date-time indicating when the resource was created.
    - `updated_at` string — ISO 8601 formatted date-time indicating when the resource was updated.

## Other responses

- `401` — Unauthorized
- `404` — Resource not found
- `422` — Bad request

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)