Ready to supercharge your AI agents?

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

Get Started Free →

Telnyx Numbers Services - curl · team-telnyx | DecimalAI

team-telnyx/telnyx-numbers-services-curl

SkillScore100Maintained

Configure voicemail, voice channels, and emergency (E911) services for your phone numbers. This skill provides REST API (curl) examples.

industryby 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-services-curl/SKILL.md

decimalai skills pull team-telnyx-telnyx-numbers-services-curl --out .claude/skills/

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

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

Raw file: /s/team-telnyx-telnyx-numbers-services-curl/SKILL.md ↗ · machine-readable summary at /s/team-telnyx-telnyx-numbers-services-curl.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

23 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 — +43% lift · at higher cost+262% tokens0% turns100% of whole cases pass with skill (23/23)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	437%	0%
case-02	✗→✓	▲ Improved	298%	0%
case-04	✗→✓	▲ Improved	485%	0%
case-11	✗→✓	▲ Improved	481%	0%
case-12	✗→✓	▲ Improved	244%	0%

Showing 5 of 23 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/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-services-curl/SKILL.md

View on GitHub ↗

License MITImported 8/10/2026Version v1

Skill contents

SKILL.md

Telnyx Numbers Services - curl

Installation

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

Setup

bash
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:

bash
# 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

Pagination: List endpoints return paginated results. Use page[number] and page[size] query parameters to navigate pages. Check meta.total_pages in the response.

List your voice channels for non-US zones

Returns the non-US voice channels for your account. voice channels allow you to use Channel Billing for calls to your Telnyx phone numbers. Please check the Telnyx Support Articles section for full information and examples of how to utilize Channel Billing.

GET /channel_zones

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

Returns: channels (int64), countries (arraystring]), created_at (string), id (string), name (string), record_type (enum: channel_zone), updated_at (string)

Update voice channels for non-US Zones

Update the number of Voice Channels for the Non-US Zones. This allows your account to handle multiple simultaneous inbound calls to Non-US numbers. Use this endpoint to increase or decrease your capacity based on expected call volume.

PUT /channel_zones/{channel_zone_id} — Required: channels

bash
curl \
  -X PUT \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "channels": 0
}' \
  "https://api.telnyx.com/v2/channel_zones/{channel_zone_id}"

Returns: channels (int64), countries (arraystring]), created_at (string), id (string), name (string), record_type (enum: channel_zone), updated_at (string)

List dynamic emergency addresses

Returns the dynamic emergency addresses according to filters

GET /dynamic_emergency_addresses

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

Returns: administrative_area (string), country_code (enum: US, CA, PR), created_at (string), extended_address (string), house_number (string), house_suffix (string), id (string), locality (string), postal_code (string), record_type (string), sip_geolocation_id (string), status (enum: pending, activated, rejected), street_name (string), street_post_directional (string), street_pre_directional (string), street_suffix (string), updated_at (string)

Create a dynamic emergency address.

Creates a dynamic emergency address.

POST /dynamic_emergency_addresses — Required: house_number, street_name, locality, administrative_area, postal_code, country_code

Optional: created_at (string), extended_address (string), house_suffix (string), id (string), record_type (string), sip_geolocation_id (string), status (enum: pending, activated, rejected), street_post_directional (string), street_pre_directional (string), street_suffix (string), updated_at (string)

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "house_number": "600",
  "street_name": "Congress",
  "locality": "Austin",
  "administrative_area": "TX",
  "postal_code": "78701",
  "country_code": "US"
}' \
  "https://api.telnyx.com/v2/dynamic_emergency_addresses"

Returns: administrative_area (string), country_code (enum: US, CA, PR), created_at (string), extended_address (string), house_number (string), house_suffix (string), id (string), locality (string), postal_code (string), record_type (string), sip_geolocation_id (string), status (enum: pending, activated, rejected), street_name (string), street_post_directional (string), street_pre_directional (string), street_suffix (string), updated_at (string)

Get a dynamic emergency address

Returns the dynamic emergency address based on the ID provided

GET /dynamic_emergency_addresses/{id}

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

Returns: administrative_area (string), country_code (enum: US, CA, PR), created_at (string), extended_address (string), house_number (string), house_suffix (string), id (string), locality (string), postal_code (string), record_type (string), sip_geolocation_id (string), status (enum: pending, activated, rejected), street_name (string), street_post_directional (string), street_pre_directional (string), street_suffix (string), updated_at (string)

Delete a dynamic emergency address

Deletes the dynamic emergency address based on the ID provided

DELETE /dynamic_emergency_addresses/{id}

bash
curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/dynamic_emergency_addresses/550e8400-e29b-41d4-a716-446655440000"

Returns: administrative_area (string), country_code (enum: US, CA, PR), created_at (string), extended_address (string), house_number (string), house_suffix (string), id (string), locality (string), postal_code (string), record_type (string), sip_geolocation_id (string), status (enum: pending, activated, rejected), street_name (string), street_post_directional (string), street_pre_directional (string), street_suffix (string), updated_at (string)

List dynamic emergency endpoints

Returns the dynamic emergency endpoints according to filters

GET /dynamic_emergency_endpoints

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

Returns: callback_number (string), caller_name (string), created_at (string), dynamic_emergency_address_id (string), id (string), record_type (string), sip_from_id (string), status (enum: pending, activated, rejected), updated_at (string)

Create a dynamic emergency endpoint.

Creates a dynamic emergency endpoints.

POST /dynamic_emergency_endpoints — Required: dynamic_emergency_address_id, callback_number, caller_name

Optional: created_at (string), id (string), record_type (string), sip_from_id (string), status (enum: pending, activated, rejected), updated_at (string)

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dynamic_emergency_address_id": "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
  "callback_number": "+13125550000",
  "caller_name": "Jane Doe Desk Phone"
}' \
  "https://api.telnyx.com/v2/dynamic_emergency_endpoints"

Returns: callback_number (string), caller_name (string), created_at (string), dynamic_emergency_address_id (string), id (string), record_type (string), sip_from_id (string), status (enum: pending, activated, rejected), updated_at (string)

Get a dynamic emergency endpoint

Returns the dynamic emergency endpoint based on the ID provided

GET /dynamic_emergency_endpoints/{id}

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

Returns: callback_number (string), caller_name (string), created_at (string), dynamic_emergency_address_id (string), id (string), record_type (string), sip_from_id (string), status (enum: pending, activated, rejected), updated_at (string)

Delete a dynamic emergency endpoint

Deletes the dynamic emergency endpoint based on the ID provided

DELETE /dynamic_emergency_endpoints/{id}

bash
curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/dynamic_emergency_endpoints/550e8400-e29b-41d4-a716-446655440000"

Returns: callback_number (string), caller_name (string), created_at (string), dynamic_emergency_address_id (string), id (string), record_type (string), sip_from_id (string), status (enum: pending, activated, rejected), updated_at (string)

List your voice channels for US Zone

Returns the US Zone voice channels for your account. voice channels allows you to use Channel Billing for calls to your Telnyx phone numbers. Please check the Telnyx Support Articles section for full information and examples of how to utilize Channel Billing.

GET /inbound_channels

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

Returns: channels (integer), record_type (string)

Update voice channels for US Zone

Update the number of Voice Channels for the US Zone. This allows your account to handle multiple simultaneous inbound calls to US numbers. Use this endpoint to increase or decrease your capacity based on expected call volume.

PATCH /inbound_channels — Required: channels

bash
curl \
  -X PATCH \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "channels": 7
}' \
  "https://api.telnyx.com/v2/inbound_channels"

Returns: channels (integer), record_type (string)

List All Numbers using Channel Billing

Retrieve a list of all phone numbers using Channel Billing, grouped by Zone.

GET /list

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

Returns: number_of_channels (integer), numbers (arrayobject]), zone_id (string), zone_name (string)

List Numbers using Channel Billing for a specific Zone

Retrieve a list of phone numbers using Channel Billing for a specific Zone.

GET /list/{channel_zone_id}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/list/{channel_zone_id}"

Returns: number_of_channels (integer), numbers (arrayobject]), zone_id (string), zone_name (string)

Get voicemail

Returns the voicemail settings for a phone number

GET /phone_numbers/{phone_number_id}/voicemail

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/phone_numbers/{phone_number_id}/voicemail"

Returns: enabled (boolean), pin (string)

Create voicemail

Create voicemail settings for a phone number

POST /phone_numbers/{phone_number_id}/voicemail

Optional: enabled (boolean), pin (string)

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/phone_numbers/{phone_number_id}/voicemail"

Returns: enabled (boolean), pin (string)

Update voicemail

Update voicemail settings for a phone number

PATCH /phone_numbers/{phone_number_id}/voicemail

Optional: enabled (boolean), pin (string)

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

Returns: enabled (boolean), pin (string)

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

Latest benchmark · publisher runVerified

8/22/2026, 09:50 UTC · 23 cases

Lift

+43%

100% vs 57%

Agent turns

0%

1.0 vs 1.0

Tokens

+262%

4,464.74 vs 1,233.57

fail → pass · 10pass → pass · 13

Per-case results (23)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 Can you write a curl command to update our account's US zone inbound voice channel capacity to 15 concurrent calls? Please output the executable cURL snippet using standard bearer authorization with TELNYX_API_KEY.	fail→pass	4,396	4,359	-1%	1	1	0%	807	4,334	+437%	0	0	—
case-02 Show me how to update the voicemail configuration for phone number ID ph_123456789 using cURL, setting the PIN to 4321 and making sure voicemail is enabled. Provide the complete HTTP API request command using the Telnyx bearer token variable.	fail→pass	5,591	3,322	-41%	1	1	0%	1,138	4,532	+298%	0	0	—
case-03 I need a command line curl request to retrieve all configured non-US voice channel zones for my Telnyx account. What endpoint and method should I query?	pass→pass	6,339	2,456	-61%	1	1	0%	1,164	4,185	+260%	0	0	—
case-04 We need to scale our international voice capacity for non-US channel zone zone_789 to 25 channels. Write a cURL command using bearer authentication with $TELNYX_API_KEY to update this zone.	fail→pass	3,945	2,922	-26%	1	1	0%	741	4,337	+485%	0	0	—
case-05 Write a cURL request to fetch the existing list of dynamic emergency addresses associated with our Telnyx account using standard HTTP Authorization bearer headers.	pass→pass	2,985	1,915	-36%	1	1	0%	557	4,101	+636%	0	0	—
case-06 Please construct a cURL command to provision a new dynamic emergency address in Austin, Texas (US) at 600 Congress Ave, postal code 78701. Output the complete HTTP POST request.	pass→pass	10,426	4,952	-53%	1	1	0%	2,063	4,757	+131%	0	0	—
case-07 Provide a cURL invocation to lookup details for a specific dynamic emergency address having ID 550e8400-e29b-41d4-a716-446655440000.	pass→pass	7,246	2,244	-69%	1	1	0%	1,348	4,284	+218%	0	0	—
case-08 Show the HTTP cURL snippet to delete a dynamic emergency address with ID 550e8400-e29b-41d4-a716-446655440000 from our account.	pass→pass	4,548	2,367	-48%	1	1	0%	875	4,268	+388%	0	0	—
case-09 How can I construct a cURL call to list all registered dynamic emergency endpoints on Telnyx?	pass→pass	7,682	3,938	-49%	1	1	0%	1,460	4,584	+214%	0	0	—
case-10 I need to register a new dynamic emergency endpoint linked to dynamic emergency address 0ccc7b54-4df3-4bca-a65a-3da1ecc777f0, with callback number +13125550000 and caller name 'Reception Desk'. Write the complete cURL POST command.	pass→pass	6,289	2,490	-60%	1	1	0%	1,258	4,378	+248%	0	0	—
case-11 Provide the cURL request required to fetch dynamic emergency endpoint 550e8400-e29b-41d4-a716-446655440000.	fail→pass	4,416	1,837	-58%	1	1	0%	723	4,200	+481%	0	0	—
case-12 Write a cURL command to remove the dynamic emergency endpoint with identifier 550e8400-e29b-41d4-a716-446655440000.	fail→pass	7,188	2,176	-70%	1	1	0%	1,243	4,277	+244%	0	0	—
case-13 What cURL command retrieves the current inbound voice channel count for US Zone channel billing on Telnyx?	fail→pass	8,199	1,982	-76%	1	1	0%	1,447	4,166	+188%	0	0	—
case-14 Show me a cURL call to fetch a list of all Telnyx phone numbers currently using channel billing across all zones.	fail→pass	5,911	2,543	-57%	1	1	0%	1,079	4,291	+298%	0	0	—
case-15 Provide the cURL command to list phone numbers utilizing channel billing specifically inside zone zone_eu_north.	fail→pass	7,451	2,155	-71%	1	1	0%	1,290	4,153	+222%	0	0	—
case-16 Write a cURL command to check the current voicemail settings for phone number ID num_abc123.	fail→pass	4,384	1,983	-55%	1	1	0%	715	4,166	+483%	0	0	—
case-17 Construct a cURL request to create new voicemail settings for phone number ID num_abc123.	pass→pass	6,857	2,894	-58%	1	1	0%	1,222	4,347	+256%	0	0	—
case-18 Write a bash shell cURL wrapper pattern for calling Telnyx endpoints that checks HTTP status codes and handles rate limits.	pass→pass	16,061	9,875	-39%	1	1	0%	2,928	6,040	+106%	0	0	—
case-19 Explain how to paginate through list endpoints in Telnyx API using query parameters and check total page count.	pass→pass	11,287	5,446	-52%	1	1	0%	2,116	4,867	+130%	0	0	—
case-20 What HTTP method and endpoint path are required to update non-US voice channel limits versus US voice channel limits on Telnyx?	fail→pass	10,265	2,149	-79%	1	1	0%	1,772	4,190	+136%	0	0	—
case-21 Write a cURL command to send an outbound SMS text message 'Hello World' from +13125550002 to +13125550001 using Telnyx Messages API.	pass→pass	3,808	3,108	-18%	1	1	0%	775	4,494	+480%	0	0	—
case-22 Write a cURL request to purchase or order a new phone number +13125550199 on Telnyx via API.	pass→pass	4,922	6,116	+24%	1	1	0%	975	5,124	+426%	0	0	—
case-23 Write a cURL command to answer an incoming call with call_control_id 'v3:call_123' using Telnyx Call Control API.	pass→pass	3,784	4,317	+14%	1	1	0%	676	4,614	+583%	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. 23 cases were attempted. The headline lift of +43 percentage points is the difference between those two pass rates over the 23 comparable cases.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 56.5%
Pass rate with the skill: 100%
Cases attempted: 23
Cases counted toward lift: 23
Cases that regressed: 0
Skill version measured: v1
Run completed: 8/22/2026, 09:50 UTC

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

Prompt

Can you write a curl command to update our account's US zone inbound voice channel capacity to 15 concurrent calls? Please output the executable cURL snippet using standard bearer authorization with TELNYX_API_KEY.

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 run100

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+245% 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.