Ready to supercharge your AI agents?

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

Get Started Free →

Telnyx Account Management - curl · team-telnyx | DecimalAI

team-telnyx/telnyx-account-management-curl

SkillScore100Maintained

Manage sub-accounts for reseller and enterprise scenarios. 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-account-management-curl/SKILL.md

decimalai skills pull team-telnyx-telnyx-account-management-curl --out .claude/skills/

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

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

Raw file: /s/team-telnyx-telnyx-account-management-curl/SKILL.md ↗ · machine-readable summary at /s/team-telnyx-telnyx-account-management-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 — +70% lift · at higher cost+134% tokens0% turns100% of whole cases pass with skill (23/23)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	108%	0%
case-02	✗→✓	▲ Improved	54%	0%
case-03	✗→✓	▲ Improved	370%	0%
case-05	✗→✓	▲ Improved	77%	0%
case-06	✗→✓	▲ Improved	245%	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-account-management-curl/SKILL.md

View on GitHub ↗

License MITImported 8/10/2026Version v1

Skill contents

SKILL.md

Telnyx Account Management - 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.

Lists accounts managed by the current user.

Lists the accounts managed by the current user. Users need to be explictly approved by Telnyx in order to become manager accounts.

GET /managed_accounts

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/managed_accounts?filter={'email': {'contains': 'john'}, 'organization_name': {'eq': 'Example Company LLC'}}&sort=email&include_cancelled_accounts=True"

Returns: api_user (string), created_at (string), email (email), id (uuid), managed_account_allow_custom_pricing (boolean), manager_account_id (string), organization_name (string), record_type (enum: managed_account), rollup_billing (boolean), updated_at (string)

Create a new managed account.

Create a new managed account owned by the authenticated user. You need to be explictly approved by Telnyx in order to become a manager account.

POST /managed_accounts — Required: business_name

Optional: email (string), managed_account_allow_custom_pricing (boolean), password (string), rollup_billing (boolean)

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "business_name": "Larry's Cat Food Inc"
}' \
  "https://api.telnyx.com/v2/managed_accounts"

Returns: api_key (string), api_token (string), api_user (string), balance (object), created_at (string), email (email), id (uuid), managed_account_allow_custom_pricing (boolean), manager_account_id (string), organization_name (string), record_type (enum: managed_account), rollup_billing (boolean), updated_at (string)

Display information about allocatable global outbound channels for the current user.

Display information about allocatable global outbound channels for the current user. Only usable by account managers.

GET /managed_accounts/allocatable_global_outbound_channels

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

Returns: allocatable_global_outbound_channels (integer), managed_account_allow_custom_pricing (boolean), record_type (string), total_global_channels_allocated (integer)

Retrieve a managed account

Retrieves the details of a single managed account.

GET /managed_accounts/{id}

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

Returns: api_key (string), api_token (string), api_user (string), balance (object), created_at (string), email (email), id (uuid), managed_account_allow_custom_pricing (boolean), manager_account_id (string), organization_name (string), record_type (enum: managed_account), rollup_billing (boolean), updated_at (string)

Update a managed account

Update a single managed account.

PATCH /managed_accounts/{id}

Optional: managed_account_allow_custom_pricing (boolean)

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

Returns: api_key (string), api_token (string), api_user (string), balance (object), created_at (string), email (email), id (uuid), managed_account_allow_custom_pricing (boolean), manager_account_id (string), organization_name (string), record_type (enum: managed_account), rollup_billing (boolean), updated_at (string)

Disables a managed account

Disables a managed account, forbidding it to use Telnyx services, including sending or receiving phone calls and SMS messages. Ongoing phone calls will not be affected. The managed account and its sub-users will no longer be able to log in via the mission control portal.

POST /managed_accounts/{id}/actions/disable

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

Returns: api_key (string), api_token (string), api_user (string), balance (object), created_at (string), email (email), id (uuid), managed_account_allow_custom_pricing (boolean), manager_account_id (string), organization_name (string), record_type (enum: managed_account), rollup_billing (boolean), updated_at (string)

Enables a managed account

Enables a managed account and its sub-users to use Telnyx services.

POST /managed_accounts/{id}/actions/enable

Optional: reenable_all_connections (boolean)

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

Returns: api_key (string), api_token (string), api_user (string), balance (object), created_at (string), email (email), id (uuid), managed_account_allow_custom_pricing (boolean), manager_account_id (string), organization_name (string), record_type (enum: managed_account), rollup_billing (boolean), updated_at (string)

Update the amount of allocatable global outbound channels allocated to a specific managed account.

PATCH /managed_accounts/{id}/update_global_channel_limit

Optional: channel_limit (integer)

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

Returns: channel_limit (integer), email (string), id (string), manager_account_id (string), record_type (string)

List organization users

Returns a list of the users in your organization.

GET /organizations/users

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

Returns: created_at (string), email (email), groups (arrayobject]), id (string), last_sign_in_at (string | null), organization_user_bypasses_sso (boolean), record_type (string), user_status (enum: enabled, disabled, blocked)

Get organization users groups report

Returns a report of all users in your organization with their group memberships. This endpoint returns all users without pagination and always includes group information. The report can be retrieved in JSON or CSV format by sending specific content-type headers.

GET /organizations/users/users_groups_report

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

Returns: created_at (string), email (email), groups (arrayobject]), id (string), last_sign_in_at (string | null), organization_user_bypasses_sso (boolean), record_type (string), user_status (enum: enabled, disabled, blocked)

Get organization user

Returns a user in your organization.

GET /organizations/users/{id}

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

Returns: created_at (string), email (email), groups (arrayobject]), id (string), last_sign_in_at (string | null), organization_user_bypasses_sso (boolean), record_type (string), user_status (enum: enabled, disabled, blocked)

Delete organization user

Deletes a user in your organization.

POST /organizations/users/{id}/actions/remove

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/organizations/users/550e8400-e29b-41d4-a716-446655440000/actions/remove"

Returns: created_at (string), email (email), groups (arrayobject]), id (string), last_sign_in_at (string | null), organization_user_bypasses_sso (boolean), record_type (string), user_status (enum: enabled, disabled, blocked)

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

Latest benchmark · publisher runVerified

8/22/2026, 08:25 UTC · 23 cases

Lift

+70%

100% vs 30%

Agent turns

0%

1.0 vs 1.0

Tokens

+134%

3,708 vs 1,583.48

fail → pass · 16pass → pass · 7

Per-case results (23)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 Could you give me the curl command to suspend a managed child account with ID 9b23cd45-5678-4111-b000-987654321xyz? It needs to block them from using services or logging into the portal, formatted for direct execution in a bash shell.	fail→pass	9,428	2,860	-70%	1	1	0%	1,807	3,754	+108%	0	0	—
case-02 Can you write a curl script to pull the organization user group report from Telnyx? I want to see every user in our org and the groups they belong to without hitches like pagination limits.	fail→pass	14,202	5,157	-64%	1	1	0%	2,721	4,184	+54%	0	0	—
case-03 I want to create a new managed account for a customer named 'Acme Corp' using curl. Should I pass 'name' or 'account_name' in the JSON body?	fail→pass	4,798	3,389	-29%	1	1	0%	799	3,754	+370%	0	0	—
case-04 Write a curl request to search managed accounts for emails containing 'john' and organization name exactly equal to 'Example Company LLC', sorted by email.	pass→pass	8,855	2,733	-69%	1	1	0%	1,625	3,662	+125%	0	0	—
case-05 How can I check the total allocatable global outbound channels for my manager account via curl?	fail→pass	12,323	2,824	-77%	1	1	0%	2,071	3,668	+77%	0	0	—
case-06 Provide a curl command to fetch details of a managed account with ID 550e8400-e29b-41d4-a716-446655440000.	fail→pass	5,686	2,181	-62%	1	1	0%	1,015	3,506	+245%	0	0	—
case-07 I need to update a managed account (ID 550e8400-e29b-41d4-a716-446655440000) using curl to adjust custom pricing permissions. What HTTP method and endpoint should be used?	fail→pass	9,743	3,437	-65%	1	1	0%	1,725	3,827	+122%	0	0	—
case-08 Write a curl command to re-enable a disabled managed account with ID 550e8400-e29b-41d4-a716-446655440000.	fail→pass	6,257	3,027	-52%	1	1	0%	1,193	3,761	+215%	0	0	—
case-09 Give me the curl command to set the global channel limit for a managed sub-account (ID 550e8400-e29b-41d4-a716-446655440000).	fail→pass	6,534	3,237	-50%	1	1	0%	1,304	3,745	+187%	0	0	—
case-10 I want to list all users in my organization. What curl command targets the endpoint for listing organization users?	fail→pass	7,493	1,802	-76%	1	1	0%	1,528	3,416	+124%	0	0	—
case-11 Show the curl command to fetch information for a specific organization user with ID 550e8400-e29b-41d4-a716-446655440000.	fail→pass	5,850	1,864	-68%	1	1	0%	1,083	3,472	+221%	0	0	—
case-12 How do I remove or delete an organization user with ID 550e8400-e29b-41d4-a716-446655440000 via Telnyx REST API? Is it a DELETE request to /organizations/users/{id}?	fail→pass	12,037	3,566	-70%	1	1	0%	2,158	3,960	+84%	0	0	—
case-13 When writing a bash script around curl calls to Telnyx, how should I capture both the HTTP status code and response body for error handling?	pass→pass	14,531	4,502	-69%	1	1	0%	2,579	4,039	+57%	0	0	—
case-14 What header format does Telnyx expect for authorization in curl requests?	pass→pass	3,829	1,560	-59%	1	1	0%	622	3,378	+443%	0	0	—
case-15 When listing managed accounts with curl, how do I ensure cancelled accounts are included in the results?	fail→pass	11,008	2,134	-81%	1	1	0%	1,853	3,453	+86%	0	0	—
case-16 Which query parameters control pagination when retrieving paginated lists from Telnyx REST endpoints?	pass→pass	4,250	1,565	-63%	1	1	0%	658	3,338	+407%	0	0	—
case-17 When creating a managed account, what option enables automatic rollup billing under the manager account?	fail→pass	5,770	1,896	-67%	1	1	0%	868	3,443	+297%	0	0	—
case-18 What optional parameter can be passed in POST body when enabling a managed account to re-enable all of its connections at the same time?	fail→pass	20,049	1,964	-90%	1	1	0%	3,343	3,435	+3%	0	0	—
case-19 When modifying global outbound channel allocation for a child account, what body parameter sets the channel count?	fail→pass	14,936	2,189	-85%	1	1	0%	2,468	3,494	+42%	0	0	—
case-20 Does the organization user group report endpoint support CSV output format, and how would you request CSV vs JSON in curl?	pass→pass	9,432	3,659	-61%	1	1	0%	1,736	3,731	+115%	0	0	—
case-21 Can you provide the curl command to send an outbound SMS message to +13125550001 from +13125550002 with text 'Hello'?	fail→pass	4,126	2,734	-34%	1	1	0%	727	3,696	+408%	0	0	—
case-22 Write a curl request to order or purchase phone number +13125550199 on Telnyx.	pass→pass	5,518	5,793	+5%	1	1	0%	1,029	4,232	+311%	0	0	—
case-23 How do I initiate an outbound voice call to +13125550100 using curl on Telnyx?	pass→pass	7,974	6,742	-15%	1	1	0%	1,508	4,336	+188%	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 +70 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: 30.4%
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, 08:25 UTC

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

Prompt

Could you give me the curl command to suspend a managed child account with ID 9b23cd45-5678-4111-b000-987654321xyz? It needs to block them from using services or logging into the portal, formatted for direct execution in a bash shell.

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