Ai telnyx-numbers-config-curl

install
source · Clone the upstream repo
git clone https://github.com/team-telnyx/ai
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/team-telnyx/ai "$T" && mkdir -p ~/.claude/skills && cp -r "$T/providers/cursor/plugin/skills/telnyx-numbers-config-curl" ~/.claude/skills/team-telnyx-ai-telnyx-numbers-config-curl-f1074d && rm -rf "$T"
manifest: providers/cursor/plugin/skills/telnyx-numbers-config-curl/SKILL.md
source content
<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->

Telnyx Numbers Config - curl

Installation

# curl is pre-installed on macOS, Linux, and Windows 10+

Setup

export TELNYX_API_KEY="YOUR_API_KEY_HERE"

All examples below use

$TELNYX_API_KEY
for authentication.

Error Handling

All API calls can fail with network errors, rate limits (429), validation errors (422), or authentication errors (401). Always handle errors in production code:

# Check HTTP status code in response
response=$(curl -s -w "\n%{http_code}" \
  -X POST "https://api.telnyx.com/v2/messages" \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "+13125550001", "from": "+13125550002", "text": "Hello"}')

http_code=$(echo "$response" | tail -1)
body=$(echo "$response" | sed '$d')

case $http_code in
  2*) echo "Success: $body" ;;
  422) echo "Validation error — check required fields and formats" ;;
  429) echo "Rate limited — retry after delay"; sleep 1 ;;
  401) echo "Authentication failed — check TELNYX_API_KEY" ;;
  *)   echo "Error $http_code: $body" ;;
esac

Common error codes:

401
invalid API key,
403
insufficient permissions,
404
resource not found,
422
validation error (check field formats),
429
rate limited (retry with exponential backoff).

Important Notes

  • Phone numbers must be in E.164 format (e.g.,
    +13125550001
    ). Include the
    +
    prefix and country code. No spaces, dashes, or parentheses.
  • Pagination: List endpoints return paginated results. Use
    page[number]
    and
    page[size]
    query parameters to navigate pages. Check
    meta.total_pages
    in the response.

Bulk update phone number profiles

POST /messaging_numbers_bulk_updates
— Required:
messaging_profile_id
,
numbers

Optional:

assign_only
(boolean)

curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "messaging_profile_id": "550e8400-e29b-41d4-a716-446655440000",
  "numbers": [
    "+13125550001"
  ]
}' \
  "https://api.telnyx.com/v2/messaging_numbers_bulk_updates"

Returns:

failed
(array[string]),
order_id
(uuid),
pending
(array[string]),
record_type
(enum: messaging_numbers_bulk_update),
success
(array[string])

Retrieve bulk update status

GET /messaging_numbers_bulk_updates/{order_id}

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/messaging_numbers_bulk_updates/{order_id}"

Returns:

failed
(array[string]),
order_id
(uuid),
pending
(array[string]),
record_type
(enum: messaging_numbers_bulk_update),
success
(array[string])

List mobile phone numbers with messaging settings

GET /mobile_phone_numbers/messaging

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/mobile_phone_numbers/messaging"

Returns:

country_code
(string),
created_at
(date-time),
features
(object),
id
(string),
messaging_product
(string),
messaging_profile_id
(string | null),
organization_id
(string),
phone_number
(string),
record_type
(enum: messaging_phone_number, messaging_settings),
tags
(array[string]),
traffic_type
(string),
type
(enum: longcode),
updated_at
(date-time)

Retrieve a mobile phone number with messaging settings

GET /mobile_phone_numbers/{id}/messaging

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/mobile_phone_numbers/550e8400-e29b-41d4-a716-446655440000/messaging"

Returns:

country_code
(string),
created_at
(date-time),
features
(object),
id
(string),
messaging_product
(string),
messaging_profile_id
(string | null),
organization_id
(string),
phone_number
(string),
record_type
(enum: messaging_phone_number, messaging_settings),
tags
(array[string]),
traffic_type
(string),
type
(enum: longcode),
updated_at
(date-time)

List phone numbers

GET /phone_numbers

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/phone_numbers?sort=connection_name&handle_messaging_profile_error=false"

Returns:

billing_group_id
(string | null),
call_forwarding_enabled
(boolean),
call_recording_enabled
(boolean),
caller_id_name_enabled
(boolean),
cnam_listing_enabled
(boolean),
connection_id
(string | null),
connection_name
(string | null),
country_iso_alpha2
(string),
created_at
(date-time),
customer_reference
(string | null),
deletion_lock_enabled
(boolean),
emergency_address_id
(string | null),
emergency_enabled
(boolean),
emergency_status
(enum: active, deprovisioning, disabled, provisioning, provisioning-failed),
external_pin
(string | null),
hd_voice_enabled
(boolean),
id
(string),
inbound_call_screening
(enum: disabled, reject_calls, flag_calls),
messaging_profile_id
(string | null),
messaging_profile_name
(string | null),
phone_number
(string),
phone_number_type
(enum: local, toll_free, mobile, national, shared_cost, landline, tollfree, shortcode, longcode),
purchased_at
(string),
record_type
(string),
source_type
(object),
status
(enum: purchase-pending, purchase-failed, port-pending, port-failed, active, deleted, emergency-only, ported-out, port-out-pending, requirement-info-pending, requirement-info-under-review, requirement-info-exception, provision-pending),
t38_fax_gateway_enabled
(boolean),
tags
(array[string]),
updated_at
(string)

Verify ownership of phone numbers

Verifies ownership of the provided phone numbers and returns a mapping of numbers to their IDs, plus a list of numbers not found in the account.

POST /phone_numbers/actions/verify_ownership
— Required:
phone_numbers

curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "phone_numbers": [
    "+15551234567"
  ]
}' \
  "https://api.telnyx.com/v2/phone_numbers/actions/verify_ownership"

Returns:

found
(array[object]),
not_found
(array[string]),
record_type
(string)

Lists the phone numbers jobs

GET /phone_numbers/jobs

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/phone_numbers/jobs?sort=created_at"

Returns:

created_at
(string),
etc
(date-time),
failed_operations
(array[object]),
id
(uuid),
pending_operations
(array[object]),
phone_numbers
(array[object]),
record_type
(string),
status
(enum: pending, in_progress, completed, failed, expired),
successful_operations
(array[object]),
type
(enum: update_emergency_settings, delete_phone_numbers, update_phone_numbers),
updated_at
(string)

Delete a batch of numbers

Creates a new background job to delete a batch of numbers. At most one thousand numbers can be updated per API call.

POST /phone_numbers/jobs/delete_phone_numbers
— Required:
phone_numbers

curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "phone_numbers": [
    "+13125550001"
  ]
}' \
  "https://api.telnyx.com/v2/phone_numbers/jobs/delete_phone_numbers"

Returns:

created_at
(string),
etc
(date-time),
failed_operations
(array[object]),
id
(uuid),
pending_operations
(array[object]),
phone_numbers
(array[object]),
record_type
(string),
status
(enum: pending, in_progress, completed, failed, expired),
successful_operations
(array[object]),
type
(enum: update_emergency_settings, delete_phone_numbers, update_phone_numbers),
updated_at
(string)

Update the emergency settings from a batch of numbers

Creates a background job to update the emergency settings of a collection of phone numbers. At most one thousand numbers can be updated per API call.

POST /phone_numbers/jobs/update_emergency_settings
— Required:
emergency_enabled
,
phone_numbers

Optional:

emergency_address_id
(string | null)

curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "phone_numbers": [
    "+13125550001"
  ],
  "emergency_enabled": true
}' \
  "https://api.telnyx.com/v2/phone_numbers/jobs/update_emergency_settings"

Returns:

created_at
(string),
etc
(date-time),
failed_operations
(array[object]),
id
(uuid),
pending_operations
(array[object]),
phone_numbers
(array[object]),
record_type
(string),
status
(enum: pending, in_progress, completed, failed, expired),
successful_operations
(array[object]),
type
(enum: update_emergency_settings, delete_phone_numbers, update_phone_numbers),
updated_at
(string)

Update a batch of numbers

Creates a new background job to update a batch of numbers. At most one thousand numbers can be updated per API call. At least one of the updateable fields must be submitted.

POST /phone_numbers/jobs/update_phone_numbers
— Required:
phone_numbers

Optional:

billing_group_id
(string),
connection_id
(string),
customer_reference
(string),
deletion_lock_enabled
(boolean),
external_pin
(string),
hd_voice_enabled
(boolean),
tags
(array[string]),
voice
(object)

curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "phone_numbers": [
    "+13125550001"
  ]
}' \
  "https://api.telnyx.com/v2/phone_numbers/jobs/update_phone_numbers"

Returns:

created_at
(string),
etc
(date-time),
failed_operations
(array[object]),
id
(uuid),
pending_operations
(array[object]),
phone_numbers
(array[object]),
record_type
(string),
status
(enum: pending, in_progress, completed, failed, expired),
successful_operations
(array[object]),
type
(enum: update_emergency_settings, delete_phone_numbers, update_phone_numbers),
updated_at
(string)

Retrieve a phone numbers job

GET /phone_numbers/jobs/{id}

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/phone_numbers/jobs/550e8400-e29b-41d4-a716-446655440000"

Returns:

created_at
(string),
etc
(date-time),
failed_operations
(array[object]),
id
(uuid),
pending_operations
(array[object]),
phone_numbers
(array[object]),
record_type
(string),
status
(enum: pending, in_progress, completed, failed, expired),
successful_operations
(array[object]),
type
(enum: update_emergency_settings, delete_phone_numbers, update_phone_numbers),
updated_at
(string)

List phone numbers with messaging settings

GET /phone_numbers/messaging

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/phone_numbers/messaging"

Returns:

country_code
(string),
created_at
(date-time),
eligible_messaging_products
(array[string]),
features
(object),
health
(object),
id
(string),
messaging_product
(string),
messaging_profile_id
(string | null),
organization_id
(string),
phone_number
(string),
record_type
(enum: messaging_phone_number, messaging_settings),
tags
(array[string]),
traffic_type
(string),
type
(enum: long-code, toll-free, short-code, longcode, tollfree, shortcode),
updated_at
(date-time)

Slim List phone numbers

List phone numbers, This endpoint is a lighter version of the /phone_numbers endpoint having higher performance and rate limit.

GET /phone_numbers/slim

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/phone_numbers/slim?sort=connection_name"

Returns:

billing_group_id
(string),
call_forwarding_enabled
(boolean),
call_recording_enabled
(boolean),
caller_id_name_enabled
(boolean),
cnam_listing_enabled
(boolean),
connection_id
(string),
country_iso_alpha2
(string),
created_at
(string),
customer_reference
(string),
emergency_address_id
(string),
emergency_enabled
(boolean),
emergency_status
(enum: active, deprovisioning, disabled, provisioning, provisioning-failed),
external_pin
(string),
hd_voice_enabled
(boolean),
id
(string),
inbound_call_screening
(enum: disabled, reject_calls, flag_calls),
phone_number
(string),
phone_number_type
(enum: local, toll_free, mobile, national, shared_cost, landline, tollfree, shortcode, longcode),
purchased_at
(string),
record_type
(string),
status
(enum: purchase-pending, purchase-failed, port-pending, port-failed, active, deleted, emergency-only, ported-out, port-out-pending, requirement-info-pending, requirement-info-under-review, requirement-info-exception, provision-pending),
t38_fax_gateway_enabled
(boolean),
updated_at
(string)

List phone numbers with voice settings

GET /phone_numbers/voice

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/phone_numbers/voice?sort=connection_name"

Returns:

call_forwarding
(object),
call_recording
(object),
cnam_listing
(object),
connection_id
(string),
customer_reference
(string),
emergency
(object),
id
(string),
inbound_call_screening
(enum: disabled, reject_calls, flag_calls),
media_features
(object),
phone_number
(string),
record_type
(string),
tech_prefix_enabled
(boolean),
translated_number
(string),
usage_payment_method
(enum: pay-per-minute, channel)

Retrieve a phone number

GET /phone_numbers/{id}

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/phone_numbers/1293384261075731499"

Returns:

billing_group_id
(string | null),
call_forwarding_enabled
(boolean),
call_recording_enabled
(boolean),
caller_id_name_enabled
(boolean),
cnam_listing_enabled
(boolean),
connection_id
(string | null),
connection_name
(string | null),
country_iso_alpha2
(string),
created_at
(date-time),
customer_reference
(string | null),
deletion_lock_enabled
(boolean),
emergency_address_id
(string | null),
emergency_enabled
(boolean),
emergency_status
(enum: active, deprovisioning, disabled, provisioning, provisioning-failed),
external_pin
(string | null),
hd_voice_enabled
(boolean),
id
(string),
inbound_call_screening
(enum: disabled, reject_calls, flag_calls),
messaging_profile_id
(string | null),
messaging_profile_name
(string | null),
phone_number
(string),
phone_number_type
(enum: local, toll_free, mobile, national, shared_cost, landline, tollfree, shortcode, longcode),
purchased_at
(string),
record_type
(string),
source_type
(object),
status
(enum: purchase-pending, purchase-failed, port-pending, port-failed, active, deleted, emergency-only, ported-out, port-out-pending, requirement-info-pending, requirement-info-under-review, requirement-info-exception, provision-pending),
t38_fax_gateway_enabled
(boolean),
tags
(array[string]),
updated_at
(string)

Update a phone number

PATCH /phone_numbers/{id}

Optional:

address_id
(string),
billing_group_id
(string),
connection_id
(string),
customer_reference
(string),
external_pin
(string),
hd_voice_enabled
(boolean),
id
(string),
tags
(array[string])

curl \
  -X PATCH \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/phone_numbers/1293384261075731499"

Returns:

billing_group_id
(string | null),
call_forwarding_enabled
(boolean),
call_recording_enabled
(boolean),
caller_id_name_enabled
(boolean),
cnam_listing_enabled
(boolean),
connection_id
(string | null),
connection_name
(string | null),
country_iso_alpha2
(string),
created_at
(date-time),
customer_reference
(string | null),
deletion_lock_enabled
(boolean),
emergency_address_id
(string | null),
emergency_enabled
(boolean),
emergency_status
(enum: active, deprovisioning, disabled, provisioning, provisioning-failed),
external_pin
(string | null),
hd_voice_enabled
(boolean),
id
(string),
inbound_call_screening
(enum: disabled, reject_calls, flag_calls),
messaging_profile_id
(string | null),
messaging_profile_name
(string | null),
phone_number
(string),
phone_number_type
(enum: local, toll_free, mobile, national, shared_cost, landline, tollfree, shortcode, longcode),
purchased_at
(string),
record_type
(string),
source_type
(object),
status
(enum: purchase-pending, purchase-failed, port-pending, port-failed, active, deleted, emergency-only, ported-out, port-out-pending, requirement-info-pending, requirement-info-under-review, requirement-info-exception, provision-pending),
t38_fax_gateway_enabled
(boolean),
tags
(array[string]),
updated_at
(string)

Delete a phone number

DELETE /phone_numbers/{id}

curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/phone_numbers/1293384261075731499"

Returns:

billing_group_id
(string),
call_forwarding_enabled
(boolean),
call_recording_enabled
(boolean),
caller_id_name_enabled
(boolean),
cnam_listing_enabled
(boolean),
connection_id
(string),
connection_name
(string),
created_at
(string),
customer_reference
(string),
deletion_lock_enabled
(boolean),
emergency_address_id
(string),
emergency_enabled
(boolean),
external_pin
(string),
hd_voice_enabled
(boolean),
id
(string),
messaging_profile_id
(string),
messaging_profile_name
(string),
phone_number
(string),
phone_number_type
(enum: local, toll_free, mobile, national, shared_cost, landline),
purchased_at
(string),
record_type
(string),
status
(enum: purchase-pending, purchase-failed, port-pending, port-failed, active, deleted, emergency-only, ported-out, port-out-pending),
t38_fax_gateway_enabled
(boolean),
tags
(array[string]),
updated_at
(string)

Change the bundle status for a phone number (set to being in a bundle or remove from a bundle)

PATCH /phone_numbers/{id}/actions/bundle_status_change
— Required:
bundle_id

curl \
  -X PATCH \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "bundle_id": "550e8400-e29b-41d4-a716-446655440000"
}' \
  "https://api.telnyx.com/v2/phone_numbers/1293384261075731499/actions/bundle_status_change"

Returns:

call_forwarding
(object),
call_recording
(object),
cnam_listing
(object),
connection_id
(string),
customer_reference
(string),
emergency
(object),
id
(string),
inbound_call_screening
(enum: disabled, reject_calls, flag_calls),
media_features
(object),
phone_number
(string),
record_type
(string),
tech_prefix_enabled
(boolean),
translated_number
(string),
usage_payment_method
(enum: pay-per-minute, channel)

Enable emergency for a phone number

POST /phone_numbers/{id}/actions/enable_emergency
— Required:
emergency_enabled
,
emergency_address_id

curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "emergency_enabled": true,
  "emergency_address_id": "550e8400-e29b-41d4-a716-446655440000"
}' \
  "https://api.telnyx.com/v2/phone_numbers/1293384261075731499/actions/enable_emergency"

Returns:

call_forwarding
(object),
call_recording
(object),
cnam_listing
(object),
connection_id
(string),
customer_reference
(string),
emergency
(object),
id
(string),
inbound_call_screening
(enum: disabled, reject_calls, flag_calls),
media_features
(object),
phone_number
(string),
record_type
(string),
tech_prefix_enabled
(boolean),
translated_number
(string),
usage_payment_method
(enum: pay-per-minute, channel)

Retrieve a phone number with messaging settings

GET /phone_numbers/{id}/messaging

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/phone_numbers/550e8400-e29b-41d4-a716-446655440000/messaging"

Returns:

country_code
(string),
created_at
(date-time),
eligible_messaging_products
(array[string]),
features
(object),
health
(object),
id
(string),
messaging_product
(string),
messaging_profile_id
(string | null),
organization_id
(string),
phone_number
(string),
record_type
(enum: messaging_phone_number, messaging_settings),
tags
(array[string]),
traffic_type
(string),
type
(enum: long-code, toll-free, short-code, longcode, tollfree, shortcode),
updated_at
(date-time)

Update the messaging profile and/or messaging product of a phone number

PATCH /phone_numbers/{id}/messaging

Optional:

messaging_product
(string),
messaging_profile_id
(string),
tags
(array[string])

curl \
  -X PATCH \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/phone_numbers/550e8400-e29b-41d4-a716-446655440000/messaging"

Returns:

country_code
(string),
created_at
(date-time),
eligible_messaging_products
(array[string]),
features
(object),
health
(object),
id
(string),
messaging_product
(string),
messaging_profile_id
(string | null),
organization_id
(string),
phone_number
(string),
record_type
(enum: messaging_phone_number, messaging_settings),
tags
(array[string]),
traffic_type
(string),
type
(enum: long-code, toll-free, short-code, longcode, tollfree, shortcode),
updated_at
(date-time)

Retrieve a phone number with voice settings

GET /phone_numbers/{id}/voice

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/phone_numbers/1293384261075731499/voice"

Returns:

call_forwarding
(object),
call_recording
(object),
cnam_listing
(object),
connection_id
(string),
customer_reference
(string),
emergency
(object),
id
(string),
inbound_call_screening
(enum: disabled, reject_calls, flag_calls),
media_features
(object),
phone_number
(string),
record_type
(string),
tech_prefix_enabled
(boolean),
translated_number
(string),
usage_payment_method
(enum: pay-per-minute, channel)

Update a phone number with voice settings

PATCH /phone_numbers/{id}/voice

Optional:

call_forwarding
(object),
call_recording
(object),
caller_id_name_enabled
(boolean),
cnam_listing
(object),
inbound_call_screening
(enum: disabled, reject_calls, flag_calls),
media_features
(object),
tech_prefix_enabled
(boolean),
translated_number
(string),
usage_payment_method
(enum: pay-per-minute, channel)

curl \
  -X PATCH \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/phone_numbers/1293384261075731499/voice"

Returns:

call_forwarding
(object),
call_recording
(object),
cnam_listing
(object),
connection_id
(string),
customer_reference
(string),
emergency
(object),
id
(string),
inbound_call_screening
(enum: disabled, reject_calls, flag_calls),
media_features
(object),
phone_number
(string),
record_type
(string),
tech_prefix_enabled
(boolean),
translated_number
(string),
usage_payment_method
(enum: pay-per-minute, channel)

List Mobile Phone Numbers

GET /v2/mobile_phone_numbers

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/v2/mobile_phone_numbers"

Returns:

call_forwarding
(object),
call_recording
(object),
caller_id_name_enabled
(boolean),
cnam_listing
(object),
connection_id
(string | null),
connection_name
(string | null),
connection_type
(string | null),
country_iso_alpha2
(string),
created_at
(date-time),
customer_reference
(string | null),
id
(string),
inbound
(object),
inbound_call_screening
(enum: disabled, reject_calls, flag_calls),
mobile_voice_enabled
(boolean),
noise_suppression
(enum: inbound, outbound, both, disabled),
outbound
(object),
phone_number
(string),
record_type
(string),
sim_card_id
(uuid),
status
(string),
tags
(array[string]),
updated_at
(date-time)

Retrieve a Mobile Phone Number

GET /v2/mobile_phone_numbers/{id}

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/v2/mobile_phone_numbers/550e8400-e29b-41d4-a716-446655440000"

Returns:

call_forwarding
(object),
call_recording
(object),
caller_id_name_enabled
(boolean),
cnam_listing
(object),
connection_id
(string | null),
connection_name
(string | null),
connection_type
(string | null),
country_iso_alpha2
(string),
created_at
(date-time),
customer_reference
(string | null),
id
(string),
inbound
(object),
inbound_call_screening
(enum: disabled, reject_calls, flag_calls),
mobile_voice_enabled
(boolean),
noise_suppression
(enum: inbound, outbound, both, disabled),
outbound
(object),
phone_number
(string),
record_type
(string),
sim_card_id
(uuid),
status
(string),
tags
(array[string]),
updated_at
(date-time)

Update a Mobile Phone Number

PATCH /v2/mobile_phone_numbers/{id}

Optional:

call_forwarding
(object),
call_recording
(object),
caller_id_name_enabled
(boolean),
cnam_listing
(object),
connection_id
(string | null),
customer_reference
(string | null),
inbound
(object),
inbound_call_screening
(enum: disabled, reject_calls, flag_calls),
noise_suppression
(boolean),
outbound
(object),
tags
(array[string])

curl \
  -X PATCH \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/v2/mobile_phone_numbers/550e8400-e29b-41d4-a716-446655440000"

Returns:

call_forwarding
(object),
call_recording
(object),
caller_id_name_enabled
(boolean),
cnam_listing
(object),
connection_id
(string | null),
connection_name
(string | null),
connection_type
(string | null),
country_iso_alpha2
(string),
created_at
(date-time),
customer_reference
(string | null),
id
(string),
inbound
(object),
inbound_call_screening
(enum: disabled, reject_calls, flag_calls),
mobile_voice_enabled
(boolean),
noise_suppression
(enum: inbound, outbound, both, disabled),
outbound
(object),
phone_number
(string),
record_type
(string),
sim_card_id
(uuid),
status
(string),
tags
(array[string]),
updated_at
(date-time)