Ready to supercharge your AI agents?

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

Get Started Free →

Telnyx Account Management - Java · team-telnyx | DecimalAI

team-telnyx/telnyx-account-management-java

SkillScore100Maintained

Manage sub-accounts for reseller and enterprise scenarios. This skill provides Java 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-account-management-java/SKILL.md

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

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

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

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

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

Yes — +86% lift · at higher cost+105% tokens0% turns100% of whole cases pass with skill (22/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-03	✗→✓	▲ Improved	129%	0%
case-01	✗→✓	▲ Improved	86%	0%
case-02	✗→✓	▲ Improved	84%	0%
case-07	✗→✓	▲ Improved	245%	0%
case-08	✗→✓	▲ Improved	286%	0%

Showing 5 of 22 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v5 — 8/27/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-java/SKILL.md

View on GitHub ↗

License MITImported 8/27/2026Version v3

Skill contents

SKILL.md

Telnyx Account Management - Java

Installation

text
<!-- Maven -->
<dependency>
    <groupId>com.telnyx.sdk</groupId>
    <artifactId>telnyx</artifactId>
    <version>6.89.0</version>
</dependency>

// Gradle
implementation("com.telnyx.sdk:telnyx:6.89.0")

Setup

java
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;

TelnyxClient client = TelnyxOkHttpClient.fromEnv();

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:

java
import com.telnyx.sdk.errors.TelnyxServiceException;

try {
    var result = client.messages().send(params);
} catch (TelnyxServiceException e) {
    System.err.println("API error " + e.statusCode() + ": " + e.getMessage());
    if (e.statusCode() == 422) {
        System.err.println("Validation error — check required fields and formats");
    } else if (e.statusCode() == 429) {
        // Rate limited — wait and retry with exponential backoff
        Thread.sleep(1000);
    }
}

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 methods return a page. Use .autoPager() for automatic iteration: for (var item : page.autoPager()) { ... }. For manual control, use .hasNextPage() and .nextPage().

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

java
import com.telnyx.sdk.models.managedaccounts.ManagedAccountListPage;
import com.telnyx.sdk.models.managedaccounts.ManagedAccountListParams;

ManagedAccountListPage page = client.managedAccounts().list();

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)

java
import com.telnyx.sdk.models.managedaccounts.ManagedAccountCreateParams;
import com.telnyx.sdk.models.managedaccounts.ManagedAccountCreateResponse;

ManagedAccountCreateParams params = ManagedAccountCreateParams.builder()
    .businessName("Larry's Cat Food Inc")
    .build();
ManagedAccountCreateResponse managedAccount = client.managedAccounts().create(params);

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

java
import com.telnyx.sdk.models.managedaccounts.ManagedAccountGetAllocatableGlobalOutboundChannelsParams;
import com.telnyx.sdk.models.managedaccounts.ManagedAccountGetAllocatableGlobalOutboundChannelsResponse;

ManagedAccountGetAllocatableGlobalOutboundChannelsResponse response = client.managedAccounts().getAllocatableGlobalOutboundChannels();

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}

java
import com.telnyx.sdk.models.managedaccounts.ManagedAccountRetrieveParams;
import com.telnyx.sdk.models.managedaccounts.ManagedAccountRetrieveResponse;

ManagedAccountRetrieveResponse managedAccount = client.managedAccounts().retrieve("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)

java
import com.telnyx.sdk.models.managedaccounts.ManagedAccountUpdateParams;
import com.telnyx.sdk.models.managedaccounts.ManagedAccountUpdateResponse;

ManagedAccountUpdateResponse managedAccount = client.managedAccounts().update("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

java
import com.telnyx.sdk.models.managedaccounts.actions.ActionDisableParams;
import com.telnyx.sdk.models.managedaccounts.actions.ActionDisableResponse;

ActionDisableResponse response = client.managedAccounts().actions().disable("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)

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)

java
import com.telnyx.sdk.models.managedaccounts.actions.ActionEnableParams;
import com.telnyx.sdk.models.managedaccounts.actions.ActionEnableResponse;

ActionEnableResponse response = client.managedAccounts().actions().enable("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 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)

java
import com.telnyx.sdk.models.managedaccounts.ManagedAccountUpdateGlobalChannelLimitParams;
import com.telnyx.sdk.models.managedaccounts.ManagedAccountUpdateGlobalChannelLimitResponse;

ManagedAccountUpdateGlobalChannelLimitResponse response = client.managedAccounts().updateGlobalChannelLimit("550e8400-e29b-41d4-a716-446655440000");

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

java
import com.telnyx.sdk.models.organizations.users.UserListPage;
import com.telnyx.sdk.models.organizations.users.UserListParams;

UserListPage page = client.organizations().users().list();

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

java
import com.telnyx.sdk.models.organizations.users.UserGetGroupsReportParams;
import com.telnyx.sdk.models.organizations.users.UserGetGroupsReportResponse;

UserGetGroupsReportResponse response = client.organizations().users().getGroupsReport();

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}

java
import com.telnyx.sdk.models.organizations.users.UserRetrieveParams;
import com.telnyx.sdk.models.organizations.users.UserRetrieveResponse;

UserRetrieveResponse user = client.organizations().users().retrieve("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

java
import com.telnyx.sdk.models.organizations.users.actions.ActionRemoveParams;
import com.telnyx.sdk.models.organizations.users.actions.ActionRemoveResponse;

ActionRemoveResponse action = client.organizations().users().actions().remove("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)

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

Latest benchmark · publisher runVerified

8/27/2026, 06:58 UTC · 22 cases

Lift

+86%

100% vs 14%

Agent turns

0%

1.0 vs 1.0

Tokens

+105%

4,319.55 vs 2,102.77

fail → pass · 19pass → pass · 3

Per-case results (22)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-03 I need to audit user access across our enterprise account. Can you show me a Java sample using the Telnyx client library to request the organization users group report and inspect the returned user profile information?	fail→pass	11,235	8,464	-25%	1	1	0%	2,209	5,064	+129%	0	0	—
case-01 I am building an administrative backend in Java to onboard sub-clients to Telnyx. Could you write a Java code snippet using the Telnyx SDK that initializes the client from environment variables and creates a new managed account for business name 'Apex Freight LLC', including appropriate exception handling for API failure scenarios?	fail→pass	12,419	8,146	-34%	1	1	0%	2,692	5,012	+86%	0	0	—
case-02 Our security team needs to immediately restrict access for a sub-account that was flagged for suspicious activity. Please provide Java code demonstrating how to invoke the endpoint that disables a managed account by its UUID using the Telnyx Java SDK.	fail→pass	11,281	4,384	-61%	1	1	0%	2,278	4,202	+84%	0	0	—
case-04 We need to send a transactional SMS notification to a customer using the Telnyx Java SDK. What SDK method and params builder should be used to send a text message from '+18005550199' to '+18005550100'?	pass→pass	9,646	5,618	-42%	1	1	0%	2,018	4,410	+119%	0	0	—
case-05 Our application needs to search for available US phone numbers in area code 312 using the Telnyx Java SDK. How do we query available phone numbers?	pass→pass	10,675	6,414	-40%	1	1	0%	2,200	4,458	+103%	0	0	—
case-06 We want to initiate an outbound phone call using Telnyx Call Control in Java. Which client method and payload structure is used to place a call?	pass→pass	13,219	11,518	-13%	1	1	0%	2,733	5,568	+104%	0	0	—
case-07 We are configuring a Maven build file (`pom.xml`) for a new Java project that uses Telnyx account management APIs. What are the exact Maven dependency coordinates (`groupId`, `artifactId`, `version`) to include in `pom.xml`?	fail→pass	5,192	1,886	-64%	1	1	0%	1,028	3,545	+245%	0	0	—
case-08 We are setting up a Gradle `build.gradle.kts` file for a service that manages Telnyx sub-accounts. What is the dependency string to add to `build.gradle.kts`?	fail→pass	4,620	1,977	-57%	1	1	0%	911	3,513	+286%	0	0	—
case-09 Write a Java snippet that lists all managed accounts for the current manager user and iterates through the paginated results using automatic pagination.	fail→pass	10,006	5,121	-49%	1	1	0%	1,990	4,410	+122%	0	0	—
case-10 Write a Java snippet using the Telnyx SDK to check how many global outbound channels are available for allocation across managed accounts.	fail→pass	13,632	5,207	-62%	1	1	0%	2,693	4,296	+60%	0	0	—
case-11 Write a Java method that takes a managed account ID string '550e8400-e29b-41d4-a716-446655440000' and retrieves its detailed account information.	fail→pass	13,498	6,355	-53%	1	1	0%	2,889	4,678	+62%	0	0	—
case-12 Write Java code to update a managed account with ID '550e8400-e29b-41d4-a716-446655440000' using the Telnyx Java SDK client.	fail→pass	9,957	8,758	-12%	1	1	0%	2,086	5,005	+140%	0	0	—
case-13 Write Java code using the Telnyx SDK to re-enable a previously disabled managed account with ID '550e8400-e29b-41d4-a716-446655440000'.	fail→pass	10,732	7,140	-33%	1	1	0%	2,365	4,880	+106%	0	0	—
case-14 Provide a Java code snippet that updates the global outbound channel allocation limit for a managed account with UUID '550e8400-e29b-41d4-a716-446655440000'.	fail→pass	12,420	13,239	+7%	1	1	0%	2,584	5,249	+103%	0	0	—
case-15 Write Java code to list the users belonging to the authenticated organization using the Telnyx Java SDK.	fail→pass	14,226	4,696	-67%	1	1	0%	2,198	4,196	+91%	0	0	—
case-16 Provide a Java code snippet using the Telnyx SDK to retrieve details for an organization user with ID '550e8400-e29b-41d4-a716-446655440000'.	fail→pass	9,630	3,385	-65%	1	1	0%	2,119	3,952	+87%	0	0	—
case-17 Write Java code using the Telnyx SDK to remove/delete an organization user with ID '550e8400-e29b-41d4-a716-446655440000'.	fail→pass	13,480	4,937	-63%	1	1	0%	2,081	4,391	+111%	0	0	—
case-18 In our Java error handler for Telnyx SDK calls, we want to detect rate limiting (429) vs validation errors (422). How do we retrieve the HTTP status code from the Telnyx exception object?	fail→pass	12,744	3,775	-70%	1	1	0%	2,441	3,994	+64%	0	0	—
case-19 What are the exact package import statements needed in Java to instantiate `TelnyxClient` using environment variables with the OkHttp engine?	fail→pass	8,290	1,950	-76%	1	1	0%	1,606	3,526	+120%	0	0	—
case-20 When creating a managed account in Java using the Telnyx SDK, which class and builder pattern construct the payload required for setting the business name?	fail→pass	5,548	2,544	-54%	1	1	0%	927	3,660	+295%	0	0	—
case-21 What is the full Java import path for the response class returned when removing an organization user?	fail→pass	14,275	2,040	-86%	1	1	0%	2,528	3,531	+40%	0	0	—
case-22 If auto-pagination is not used on a Telnyx Java SDK page object, what two methods check for additional pages and retrieve the next page?	fail→pass	9,271	1,861	-80%	1	1	0%	1,685	3,490	+107%	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. 22 cases were attempted. The headline lift of +86 percentage points is the difference between those two pass rates over the 22 comparable cases.

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

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

Prompt

I need to audit user access across our enterprise account. Can you show me a Java sample using the Telnyx client library to request the organization users group report and inspect the returned user profile information?

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+191% 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 2 days ago

Model	Method	Date	Lift
gemini-3.6-flash	verified	8/22/2026	+82%

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