Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Telnyx Numbers Config - Python · team-telnyx | DecimalAI

team-telnyx/telnyx-numbers-config-python

SkillScore96Maintained

Configure phone number settings including caller ID, call forwarding, messaging enablement, and connection assignments. This skill provides Python SDK examples.

codingby team-telnyx

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Coding pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/team-telnyx-telnyx-numbers-config-python/SKILL.md

decimalai skills pull team-telnyx-telnyx-numbers-config-python --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/team-telnyx-telnyx-numbers-config-python/SKILL.md https://app.decimal.ai/s/team-telnyx-telnyx-numbers-config-python/SKILL.md

Raw file: /s/team-telnyx-telnyx-numbers-config-python/SKILL.md ↗ · machine-readable summary at /s/team-telnyx-telnyx-numbers-config-python.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

25 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 7d ago

Yes — +76% lift · at higher cost+357% tokens0% turns96% of whole cases pass with skill (24/25)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	547%	0%
case-02	✗→✓	▲ Improved	316%	0%
case-03	✗→✓	▲ Improved	218%	0%
case-04	✗→✓	▲ Improved	551%	0%
case-05	✗→✓	▲ Improved	318%	0%

Showing 5 of 25 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/10/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

team-telnyx / ai

skills/telnyx-numbers-config-python/SKILL.md

View on GitHub ↗

License MITImported 8/10/2026Version v2

Skill contents

SKILL.md

Telnyx Numbers Config - Python

Installation

bash
pip install telnyx

Setup

python
import os
from telnyx import Telnyx

client = Telnyx(
    api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
)

All examples below assume client is already initialized as shown above.

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:

python
import telnyx

try:
    result = client.messages.send(to="+13125550001", from_="+13125550002", text="Hello")
except telnyx.APIConnectionError:
    print("Network error — check connectivity and retry")
except telnyx.RateLimitError:
    # 429: rate limited — wait and retry with exponential backoff
    import time
    time.sleep(1)  # Check Retry-After header for actual delay
except telnyx.APIStatusError as e:
    print(f"API error {e.status_code}: {e.message}")
    if e.status_code == 422:
        print("Validation error — check required fields and formats")

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 methods return an auto-paginating iterator. Use for item in page_result: to iterate through all pages automatically.

Bulk update phone number profiles

POST /messaging_numbers_bulk_updates — Required: messaging_profile_id, numbers

Optional: assign_only (boolean)

python
messaging_numbers_bulk_update = client.messaging_numbers_bulk_updates.create(
    messaging_profile_id="00000000-0000-0000-0000-000000000000",
    numbers=["+18880000000", "+18880000001", "+18880000002"],
)
print(messaging_numbers_bulk_update.data)

Returns: failed (arraystring]), order_id (uuid), pending (arraystring]), record_type (enum: messaging_numbers_bulk_update), success (arraystring])

Retrieve bulk update status

GET /messaging_numbers_bulk_updates/{order_id}

python
messaging_numbers_bulk_update = client.messaging_numbers_bulk_updates.retrieve(
    "order_id",
)
print(messaging_numbers_bulk_update.data)

Returns: failed (arraystring]), order_id (uuid), pending (arraystring]), record_type (enum: messaging_numbers_bulk_update), success (arraystring])

List mobile phone numbers with messaging settings

GET /mobile_phone_numbers/messaging

python
page = client.mobile_phone_numbers.messaging.list()
page = page.data[0]
print(page.id)

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 (arraystring]), traffic_type (string), type (enum: longcode), updated_at (date-time)

Retrieve a mobile phone number with messaging settings

GET /mobile_phone_numbers/{id}/messaging

python
messaging = client.mobile_phone_numbers.messaging.retrieve(
    "id",
)
print(messaging.data)

List phone numbers

GET /phone_numbers

python
page = client.phone_numbers.list()
page = page.data[0]
print(page.id)

Returns: activated_at (object), 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 (arraystring]), 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

python
response = client.phone_numbers.actions.verify_ownership(
    phone_numbers=["+15551234567"],
)
print(response.data)

Returns: found (arrayobject]), not_found (arraystring]), record_type (string)

Lists the phone numbers jobs

GET /phone_numbers/jobs

python
page = client.phone_numbers.jobs.list()
page = page.data[0]
print(page.id)

Returns: created_at (string), etc (date-time), failed_operations (arrayobject]), id (uuid), pending_operations (arrayobject]), phone_numbers (arrayobject]), record_type (string), status (enum: pending, in_progress, completed, failed, expired), successful_operations (arrayobject]), 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

python
response = client.phone_numbers.jobs.delete_batch(
    phone_numbers=["+19705555098", "+19715555098", "32873127836"],
)
print(response.data)

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)

python
response = client.phone_numbers.jobs.update_emergency_settings_batch(
    emergency_enabled=True,
    phone_numbers=["+19705555098", "+19715555098", "32873127836"],
)
print(response.data)

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 (arraystring]), voice (object)

python
response = client.phone_numbers.jobs.update_batch(
    phone_numbers=["1583466971586889004", "+13127367254"],
)
print(response.data)

Retrieve a phone numbers job

GET /phone_numbers/jobs/{id}

python
job = client.phone_numbers.jobs.retrieve(
    "id",
)
print(job.data)

List phone numbers with messaging settings

GET /phone_numbers/messaging

python
page = client.phone_numbers.messaging.list()
page = page.data[0]
print(page.id)

Returns: country_code (string), created_at (date-time), eligible_messaging_products (arraystring]), 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 (arraystring]), 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

python
page = client.phone_numbers.slim_list()
page = page.data[0]
print(page.id)

Returns: activated_at (object), 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

python
page = client.phone_numbers.voice.list()
page = page.data[0]
print(page.id)

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}

python
phone_number = client.phone_numbers.retrieve(
    "1293384261075731499",
)
print(phone_number.data)

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 (arraystring])

python
phone_number = client.phone_numbers.update(
    phone_number_id="1293384261075731499",
)
print(phone_number.data)

Delete a phone number

DELETE /phone_numbers/{id}

python
phone_number = client.phone_numbers.delete(
    "1293384261075731499",
)
print(phone_number.data)

Returns: activated_at (object), 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 (arraystring]), 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

python
response = client.phone_numbers.actions.change_bundle_status(
    id="1293384261075731499",
    bundle_id="5194d8fc-87e6-4188-baa9-1c434bbe861b",
)
print(response.data)

Enable emergency for a phone number

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

python
response = client.phone_numbers.actions.enable_emergency(
    id="1293384261075731499",
    emergency_address_id="53829456729313",
    emergency_enabled=True,
)
print(response.data)

Retrieve a phone number with messaging settings

GET /phone_numbers/{id}/messaging

python
messaging = client.phone_numbers.messaging.retrieve(
    "id",
)
print(messaging.data)

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 (arraystring])

python
messaging = client.phone_numbers.messaging.update(
    id="550e8400-e29b-41d4-a716-446655440000",
)
print(messaging.data)

Retrieve a phone number with voice settings

GET /phone_numbers/{id}/voice

python
voice = client.phone_numbers.voice.retrieve(
    "1293384261075731499",
)
print(voice.data)

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)

python
voice = client.phone_numbers.voice.update(
    id="1293384261075731499",
)
print(voice.data)

List Mobile Phone Numbers

GET /v2/mobile_phone_numbers

python
page = client.mobile_phone_numbers.list()
page = page.data[0]
print(page.id)

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 (arraystring]), updated_at (date-time)

Retrieve a Mobile Phone Number

GET /v2/mobile_phone_numbers/{id}

python
mobile_phone_number = client.mobile_phone_numbers.retrieve(
    "id",
)
print(mobile_phone_number.data)

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 (arraystring])

python
mobile_phone_number = client.mobile_phone_numbers.update(
    id="550e8400-e29b-41d4-a716-446655440000",
)
print(mobile_phone_number.data)

Want to see if team-telnyx/telnyx-numbers-config-python would activate on your phrasing? Try it before you install — no LLM call, no signup.

Latest benchmark · publisher runVerified

8/23/2026, 13:00 UTC · 25 cases

Lift

+76%

96% vs 20%

Agent turns

1.0 vs 1.0

Tokens

+357%

8,529.04 vs 1,865.2

fail → pass · 20pass → pass · 4pass → fail · 1

Per-case results (25)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 I need a Python script using the Telnyx client to activate emergency calling features for a large list of my phone numbers. Please provide code that submits this batch job and outputs the unique identifier for the job so I can monitor its progress.	fail→pass	8,220	10,117	+23%	1	1	0%	1,388	8,977	+547%	0	0	—
case-02 Write a Python function using the Telnyx SDK that checks whether my account actually owns a provided list of phone numbers. The function should execute the verification request and return a dictionary containing both the successfully matched numbers and the ones that were missing.	fail→pass	12,210	9,009	-26%	1	1	0%	2,280	9,485	+316%	0	0	—
case-03 Provide a Python script that retrieves my entire inventory of mobile phone numbers. The code must automatically iterate through all available pages of results. Additionally, wrap the API call in appropriate error handling to catch rate limiting issues and pause execution before retrying.	fail→pass	16,995	9,112	-46%	1	1	0%	3,008	9,563	+218%	0	0	—
case-04 Write a Python script to initialize the Telnyx client. I want to pass my API key explicitly from an environment variable named 'MY_SECRET_KEY' instead of relying on default environment variables.	fail→pass	7,024	2,738	-61%	1	1	0%	1,256	8,177	+551%	0	0	—
case-05 I'm writing a Python script to send a message via Telnyx. I want to catch validation errors (like bad formats) and print a specific message. How do I catch these 422 errors specifically?	fail→pass	10,786	4,043	-63%	1	1	0%	2,024	8,463	+318%	0	0	—
case-06 I need to pass a phone number to a Telnyx Python API function. The user inputs '(312) 555-0001'. How should I format this string before passing it to the API?	pass→pass	10,473	4,340	-59%	1	1	0%	1,989	8,454	+325%	0	0	—
case-07 I have a list of 50 phone numbers and I need to assign them to a specific messaging profile using the Telnyx Python SDK. What's the best way to do this in one API call?	fail→pass	10,846	4,075	-62%	1	1	0%	2,017	8,497	+321%	0	0	—
case-08 I started a bulk update for messaging numbers using the Telnyx Python SDK and got an order ID. How do I check the status of this specific order?	fail→pass	9,763	2,946	-70%	1	1	0%	1,583	8,275	+423%	0	0	—
case-09 I need to get a list of all my mobile phone numbers along with their messaging settings using the Telnyx Python SDK.	fail→pass	17,381	3,934	-77%	1	1	0%	3,082	8,409	+173%	0	0	—
case-10 I have the ID of a mobile phone number and I need to fetch its messaging settings using the Telnyx Python SDK.	fail→pass	6,832	2,763	-60%	1	1	0%	1,314	8,175	+522%	0	0	—
case-23 I need to purchase a new phone number using the Telnyx Python SDK. I want to search for available numbers in Chicago and buy one.	pass→pass	10,646	7,289	-32%	1	1	0%	1,958	8,989	+359%	0	0	—
case-11 I need to delete a batch of 500 phone numbers from my Telnyx account using the Python SDK. How do I create a background job for this?	fail→pass	16,753	4,395	-74%	1	1	0%	2,791	8,561	+207%	0	0	—
case-12 I want to update the billing group for a batch of 200 phone numbers using the Telnyx Python SDK. How do I submit this job?	fail→pass	15,394	4,696	-69%	1	1	0%	2,640	8,604	+226%	0	0	—
case-13 I submitted a job to update phone numbers via the Telnyx Python SDK and have the job ID. How do I retrieve the job details?	fail→pass	7,084	2,361	-67%	1	1	0%	1,199	8,154	+580%	0	0	—
case-14 I want to list all my phone numbers and their messaging settings using the Telnyx Python SDK.	fail→pass	11,686	4,354	-63%	1	1	0%	2,041	8,479	+315%	0	0	—
case-15 I need to list my phone numbers using the Telnyx Python SDK, but I want to use the lighter version of the endpoint for better performance and rate limits.	fail→pass	9,385	3,234	-66%	1	1	0%	1,615	8,222	+409%	0	0	—
case-16 I need to retrieve a list of all my phone numbers along with their voice settings using the Telnyx Python SDK.	fail→pass	9,823	3,397	-65%	1	1	0%	1,671	8,285	+396%	0	0	—
case-17 I need to update the customer reference for a specific phone number using its ID with the Telnyx Python SDK.	fail→pass	6,736	4,364	-35%	1	1	0%	1,297	8,430	+550%	0	0	—
case-18 I need to delete a single phone number from my Telnyx account using its ID via the Python SDK.	pass→pass	6,673	3,045	-54%	1	1	0%	1,160	8,204	+607%	0	0	—
case-19 I want to add a specific phone number to a bundle using the Telnyx Python SDK. I have the phone number ID and the bundle ID.	fail→pass	12,694	3,781	-70%	1	1	0%	2,101	8,343	+297%	0	0	—
case-20 I need to enable emergency services for a specific phone number using the Telnyx Python SDK. I have the phone number ID and the emergency address ID.	fail→pass	9,225	4,148	-55%	1	1	0%	1,713	8,452	+393%	0	0	—
case-21 I want to update the messaging profile ID for a specific phone number using the Telnyx Python SDK. I have the phone number ID.	fail→pass	9,360	3,863	-59%	1	1	0%	1,686	8,430	+400%	0	0	—
case-22 I need to update the translated number for a specific phone number's voice settings using the Telnyx Python SDK.	fail→pass	13,332	4,291	-68%	1	1	0%	2,267	8,444	+272%	0	0	—
case-24 I want to send an SMS message using the Telnyx Python SDK. I have the from number, to number, and the text body.	pass→fail	6,717	3,948	-41%	1	1	0%	1,186	8,401	+608%	0	0	—
case-25 I need to create a new messaging profile using the Telnyx Python SDK. How do I do this?	pass→pass	8,058	6,074	-25%	1	1	0%	1,364	8,753	+542%	0	0	—

These cases were also screened by the skill’s intent / safety pass.See the Trust review ↗Reproduce this benchmark in Colab ↗

How this skill was measured

DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 25 cases were attempted. The headline lift of +76 percentage points is the difference between those two pass rates over the 25 comparable cases. 1 case got worse with the skill loaded, and it is included in that figure.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 20%
Pass rate with the skill: 96%
Cases attempted: 25
Cases counted toward lift: 25
Cases that regressed: 1
Skill version measured: v2
Run completed: 8/23/2026, 13:00 UTC

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-01

Prompt

I need a Python script using the Telnyx client to activate emergency calling features for a large list of my phone numbers. Please provide code that submits this batch job and outputs the unique identifier for the job so I can monitor its progress.

Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.

Show both answers

SkillScore blends 4 signals1 of 4 complete

BenchmarkPass rate WITH skill on a verified run96

Live evalNeeds ≥20 evaluated traces in 30 days

AI ratingNeeds ≥10 rated traces

AdoptionNeeds ≥10 serves across ≥2 orgs in 30 days

Efficiency · separate axis (at equal correctness)+0% turns+432% tokens

Shown for transparency; not credited unless a verified run shows no correctness regression.

Backed by 1 of 4 signals — each added signal makes the score more robust.

Verified on gemini-3.6-flash · re-tested 7 days ago

Other measured skills in the registry, with their headline benchmark lift.