Install any skill in seconds. Free to start, no credit card required.
Get Started Free →Create and manage video rooms for real-time video communication and conferencing. This skill provides Java SDK examples.
.claude/skills/team-telnyx-telnyx-video-java/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-03 | ✗→✓ | ▲ Improved | 162% | 0% |
| case-04 | ✗→✓ | ▲ Improved | 224% | 0% |
| case-05 | ✗→✓ | ▲ Improved | 193% | 0% |
| case-02 | ✗→✓ | ▲ Improved | 157% | 0% |
| case-06 | ✗→✓ | ▲ Improved | 112% | 0% |
<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->
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")
javaimport 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.
All API calls can fail with network errors, rate limits (429), validation errors (422), or authentication errors (401). Always handle errors in production code:
javaimport 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).
GET /room_compositions
javaimport com.telnyx.sdk.models.roomcompositions.RoomCompositionListPage; import com.telnyx.sdk.models.roomcompositions.RoomCompositionListParams; RoomCompositionListPage page = client.roomCompositions().list();
Returns: completed_at (date-time), created_at (date-time), download_url (string), duration_secs (integer), ended_at (date-time), format (enum: mp4), id (uuid), record_type (string), resolution (string), room_id (uuid), session_id (uuid), size_mb (float), started_at (date-time), status (enum: completed, enqueued, processing), updated_at (date-time), user_id (uuid), video_layout (object), webhook_event_failover_url (uri), webhook_event_url (uri), webhook_timeout_secs (integer)
Asynchronously create a room composition.
POST /room_compositions
Optional: format (string), resolution (string), session_id (uuid), video_layout (object), webhook_event_failover_url (uri), webhook_event_url (uri), webhook_timeout_secs (integer)
javaimport com.telnyx.sdk.models.roomcompositions.RoomCompositionCreateParams; import com.telnyx.sdk.models.roomcompositions.RoomCompositionCreateResponse; RoomCompositionCreateResponse roomComposition = client.roomCompositions().create();
Returns: completed_at (date-time), created_at (date-time), download_url (string), duration_secs (integer), ended_at (date-time), format (enum: mp4), id (uuid), record_type (string), resolution (string), room_id (uuid), session_id (uuid), size_mb (float), started_at (date-time), status (enum: completed, enqueued, processing), updated_at (date-time), user_id (uuid), video_layout (object), webhook_event_failover_url (uri), webhook_event_url (uri), webhook_timeout_secs (integer)
GET /room_compositions/{room_composition_id}
javaimport com.telnyx.sdk.models.roomcompositions.RoomCompositionRetrieveParams; import com.telnyx.sdk.models.roomcompositions.RoomCompositionRetrieveResponse; RoomCompositionRetrieveResponse roomComposition = client.roomCompositions().retrieve("5219b3af-87c6-4c08-9b58-5a533d893e21");
Returns: completed_at (date-time), created_at (date-time), download_url (string), duration_secs (integer), ended_at (date-time), format (enum: mp4), id (uuid), record_type (string), resolution (string), room_id (uuid), session_id (uuid), size_mb (float), started_at (date-time), status (enum: completed, enqueued, processing), updated_at (date-time), user_id (uuid), video_layout (object), webhook_event_failover_url (uri), webhook_event_url (uri), webhook_timeout_secs (integer)
Synchronously delete a room composition.
DELETE /room_compositions/{room_composition_id}
javaimport com.telnyx.sdk.models.roomcompositions.RoomCompositionDeleteParams; client.roomCompositions().delete("5219b3af-87c6-4c08-9b58-5a533d893e21");
GET /room_participants
javaimport com.telnyx.sdk.models.roomparticipants.RoomParticipantListPage; import com.telnyx.sdk.models.roomparticipants.RoomParticipantListParams; RoomParticipantListPage page = client.roomParticipants().list();
Returns: context (string), id (uuid), joined_at (date-time), left_at (date-time), record_type (string), session_id (uuid), updated_at (date-time)
GET /room_participants/{room_participant_id}
javaimport com.telnyx.sdk.models.roomparticipants.RoomParticipantRetrieveParams; import com.telnyx.sdk.models.roomparticipants.RoomParticipantRetrieveResponse; RoomParticipantRetrieveResponse roomParticipant = client.roomParticipants().retrieve("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0");
Returns: context (string), id (uuid), joined_at (date-time), left_at (date-time), record_type (string), session_id (uuid), updated_at (date-time)
GET /room_recordings
javaimport com.telnyx.sdk.models.roomrecordings.RoomRecordingListPage; import com.telnyx.sdk.models.roomrecordings.RoomRecordingListParams; RoomRecordingListPage page = client.roomRecordings().list();
Returns: codec (string), completed_at (date-time), created_at (date-time), download_url (string), duration_secs (integer), ended_at (date-time), id (uuid), participant_id (uuid), record_type (string), room_id (uuid), session_id (uuid), size_mb (float), started_at (date-time), status (enum: completed, processing), type (enum: audio, video), updated_at (date-time)
DELETE /room_recordings
javaimport com.telnyx.sdk.models.roomrecordings.RoomRecordingDeleteBulkParams; import com.telnyx.sdk.models.roomrecordings.RoomRecordingDeleteBulkResponse; RoomRecordingDeleteBulkResponse response = client.roomRecordings().deleteBulk();
Returns: room_recordings (integer)
GET /room_recordings/{room_recording_id}
javaimport com.telnyx.sdk.models.roomrecordings.RoomRecordingRetrieveParams; import com.telnyx.sdk.models.roomrecordings.RoomRecordingRetrieveResponse; RoomRecordingRetrieveResponse roomRecording = client.roomRecordings().retrieve("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0");
Returns: codec (string), completed_at (date-time), created_at (date-time), download_url (string), duration_secs (integer), ended_at (date-time), id (uuid), participant_id (uuid), record_type (string), room_id (uuid), session_id (uuid), size_mb (float), started_at (date-time), status (enum: completed, processing), type (enum: audio, video), updated_at (date-time)
Synchronously delete a Room Recording.
DELETE /room_recordings/{room_recording_id}
javaimport com.telnyx.sdk.models.roomrecordings.RoomRecordingDeleteParams; client.roomRecordings().delete("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0");
GET /room_sessions
javaimport com.telnyx.sdk.models.rooms.sessions.SessionList0Page; import com.telnyx.sdk.models.rooms.sessions.SessionList0Params; SessionList0Page page = client.rooms().sessions().list0();
Returns: active (boolean), created_at (date-time), ended_at (date-time), id (uuid), participants (arrayobject]), record_type (string), room_id (uuid), updated_at (date-time)
GET /room_sessions/{room_session_id}
javaimport com.telnyx.sdk.models.rooms.sessions.SessionRetrieveParams; import com.telnyx.sdk.models.rooms.sessions.SessionRetrieveResponse; SessionRetrieveResponse session = client.rooms().sessions().retrieve("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0");
Returns: active (boolean), created_at (date-time), ended_at (date-time), id (uuid), participants (arrayobject]), record_type (string), room_id (uuid), updated_at (date-time)
Note: this will also kick all participants currently present in the room
POST /room_sessions/{room_session_id}/actions/end
javaimport com.telnyx.sdk.models.rooms.sessions.actions.ActionEndParams; import com.telnyx.sdk.models.rooms.sessions.actions.ActionEndResponse; ActionEndResponse response = client.rooms().sessions().actions().end("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0");
Returns: result (string)
POST /room_sessions/{room_session_id}/actions/kick
Optional: exclude (arraystring]), participants (object)
javaimport com.telnyx.sdk.models.rooms.sessions.actions.ActionKickParams; import com.telnyx.sdk.models.rooms.sessions.actions.ActionKickResponse; import com.telnyx.sdk.models.rooms.sessions.actions.ActionsParticipantsRequest; ActionKickParams params = ActionKickParams.builder() .roomSessionId("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0") .actionsParticipantsRequest(ActionsParticipantsRequest.builder().build()) .build(); ActionKickResponse response = client.rooms().sessions().actions().kick(params);
Returns: result (string)
POST /room_sessions/{room_session_id}/actions/mute
Optional: exclude (arraystring]), participants (object)
javaimport com.telnyx.sdk.models.rooms.sessions.actions.ActionMuteParams; import com.telnyx.sdk.models.rooms.sessions.actions.ActionMuteResponse; import com.telnyx.sdk.models.rooms.sessions.actions.ActionsParticipantsRequest; ActionMuteParams params = ActionMuteParams.builder() .roomSessionId("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0") .actionsParticipantsRequest(ActionsParticipantsRequest.builder().build()) .build(); ActionMuteResponse response = client.rooms().sessions().actions().mute(params);
Returns: result (string)
POST /room_sessions/{room_session_id}/actions/unmute
Optional: exclude (arraystring]), participants (object)
javaimport com.telnyx.sdk.models.rooms.sessions.actions.ActionUnmuteParams; import com.telnyx.sdk.models.rooms.sessions.actions.ActionUnmuteResponse; import com.telnyx.sdk.models.rooms.sessions.actions.ActionsParticipantsRequest; ActionUnmuteParams params = ActionUnmuteParams.builder() .roomSessionId("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0") .actionsParticipantsRequest(ActionsParticipantsRequest.builder().build()) .build(); ActionUnmuteResponse response = client.rooms().sessions().actions().unmute(params);
Returns: result (string)
GET /room_sessions/{room_session_id}/participants
javaimport com.telnyx.sdk.models.rooms.sessions.SessionRetrieveParticipantsPage; import com.telnyx.sdk.models.rooms.sessions.SessionRetrieveParticipantsParams; SessionRetrieveParticipantsPage page = client.rooms().sessions().retrieveParticipants("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0");
Returns: context (string), id (uuid), joined_at (date-time), left_at (date-time), record_type (string), session_id (uuid), updated_at (date-time)
GET /rooms
javaimport com.telnyx.sdk.models.rooms.RoomListPage; import com.telnyx.sdk.models.rooms.RoomListParams; RoomListPage page = client.rooms().list();
Returns: active_session_id (uuid), created_at (date-time), enable_recording (boolean), id (uuid), max_participants (integer), record_type (string), sessions (arrayobject]), unique_name (string), updated_at (date-time), webhook_event_failover_url (uri), webhook_event_url (uri), webhook_timeout_secs (integer)
Synchronously create a Room.
POST /rooms
Optional: enable_recording (boolean), max_participants (integer), unique_name (string), webhook_event_failover_url (uri), webhook_event_url (uri), webhook_timeout_secs (integer)
javaimport com.telnyx.sdk.models.rooms.RoomCreateParams; import com.telnyx.sdk.models.rooms.RoomCreateResponse; RoomCreateParams params = RoomCreateParams.builder() .uniqueName("my-meeting-room") .maxParticipants(10) .build(); RoomCreateResponse room = client.rooms().create(params);
Returns: active_session_id (uuid), created_at (date-time), enable_recording (boolean), id (uuid), max_participants (integer), record_type (string), sessions (arrayobject]), unique_name (string), updated_at (date-time), webhook_event_failover_url (uri), webhook_event_url (uri), webhook_timeout_secs (integer)
GET /rooms/{room_id}
javaimport com.telnyx.sdk.models.rooms.RoomRetrieveParams; import com.telnyx.sdk.models.rooms.RoomRetrieveResponse; RoomRetrieveResponse room = client.rooms().retrieve("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0");
Returns: active_session_id (uuid), created_at (date-time), enable_recording (boolean), id (uuid), max_participants (integer), record_type (string), sessions (arrayobject]), unique_name (string), updated_at (date-time), webhook_event_failover_url (uri), webhook_event_url (uri), webhook_timeout_secs (integer)
Synchronously update a Room.
PATCH /rooms/{room_id}
Optional: enable_recording (boolean), max_participants (integer), unique_name (string), webhook_event_failover_url (uri), webhook_event_url (uri), webhook_timeout_secs (integer)
javaimport com.telnyx.sdk.models.rooms.RoomUpdateParams; import com.telnyx.sdk.models.rooms.RoomUpdateResponse; RoomUpdateResponse room = client.rooms().update("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0");
Returns: active_session_id (uuid), created_at (date-time), enable_recording (boolean), id (uuid), max_participants (integer), record_type (string), sessions (arrayobject]), unique_name (string), updated_at (date-time), webhook_event_failover_url (uri), webhook_event_url (uri), webhook_timeout_secs (integer)
Synchronously delete a Room. Participants from that room will be kicked out, they won't be able to join that room anymore, and you won't be charged anymore for that room.
DELETE /rooms/{room_id}
javaimport com.telnyx.sdk.models.rooms.RoomDeleteParams; client.rooms().delete("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0");
Synchronously create an Client Token to join a Room. Client Token is necessary to join a Telnyx Room. Client Token will expire after token_ttl_secs, a Refresh Token is also provided to refresh a Client Token, the Refresh Token expires after refresh_token_ttl_secs.
POST /rooms/{room_id}/actions/generate_join_client_token
Optional: refresh_token_ttl_secs (integer), token_ttl_secs (integer)
javaimport com.telnyx.sdk.models.rooms.actions.ActionGenerateJoinClientTokenParams; import com.telnyx.sdk.models.rooms.actions.ActionGenerateJoinClientTokenResponse; ActionGenerateJoinClientTokenResponse response = client.rooms().actions().generateJoinClientToken("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0");
Returns: refresh_token (string), refresh_token_expires_at (date-time), token (string), token_expires_at (date-time)
Synchronously refresh an Client Token to join a Room. Client Token is necessary to join a Telnyx Room. Client Token will expire after token_ttl_secs.
POST /rooms/{room_id}/actions/refresh_client_token — Required: refresh_token
Optional: token_ttl_secs (integer)
javaimport com.telnyx.sdk.models.rooms.actions.ActionRefreshClientTokenParams; import com.telnyx.sdk.models.rooms.actions.ActionRefreshClientTokenResponse; ActionRefreshClientTokenParams params = ActionRefreshClientTokenParams.builder() .roomId("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0") .refreshToken("eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJ0ZWxueXhfdGVsZXBob255IiwiZXhwIjoxNTkwMDEwMTQzLCJpYXQiOjE1ODc1OTA5NDMsImlzcyI6InRlbG55eF90ZWxlcGhvbnkiLCJqdGkiOiJiOGM3NDgzNy1kODllLTRhNjUtOWNmMi0zNGM3YTZmYTYwYzgiLCJuYmYiOjE1ODc1OTA5NDIsInN1YiI6IjVjN2FjN2QwLWRiNjUtNGYxMS05OGUxLWVlYzBkMWQ1YzZhZSIsInRlbF90b2tlbiI6InJqX1pra1pVT1pNeFpPZk9tTHBFVUIzc2lVN3U2UmpaRmVNOXMtZ2JfeENSNTZXRktGQUppTXlGMlQ2Q0JSbWxoX1N5MGlfbGZ5VDlBSThzRWlmOE1USUlzenl6U2xfYURuRzQ4YU81MHlhSEd1UlNZYlViU1ltOVdJaVEwZz09IiwidHlwIjoiYWNjZXNzIn0.gNEwzTow5MLLPLQENytca7pUN79PmPj6FyqZWW06ZeEmesxYpwKh0xRtA0TzLh6CDYIRHrI8seofOO0YFGDhpQ") .build(); ActionRefreshClientTokenResponse response = client.rooms().actions().refreshClientToken(params);
Returns: token (string), token_expires_at (date-time)
GET /rooms/{room_id}/sessions
javaimport com.telnyx.sdk.models.rooms.sessions.SessionList1Page; import com.telnyx.sdk.models.rooms.sessions.SessionList1Params; SessionList1Page page = client.rooms().sessions().list1("0ccc7b54-4df3-4bca-a65a-3da1ecc777f0");
Returns: active (boolean), created_at (date-time), ended_at (date-time), id (uuid), participants (arrayobject]), record_type (string), room_id (uuid), updated_at (date-time)
| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-03 | fail→pass | 16,857 | 13,193 | -22% | 1 | 1 | 0% | 3,106 | 8,135 | +162% | 0 | 0 | — |
case-04 | fail→pass | 13,562 | 5,885 | -57% | 1 | 1 | 0% | 2,059 | 6,680 | +224% | 0 | 0 | — |
case-05 | fail→pass | 16,697 | 8,038 | -52% | 1 | 1 | 0% | 2,547 | 7,462 | +193% | 0 | 0 | — |
case-01 | fail→fail | 17,545 | 10,164 | -42% | 1 | 1 | 0% | 3,585 | 7,907 | +121% | 0 | 0 | — |
case-02 | fail→pass | 16,203 | 8,922 | -45% | 1 | 1 | 0% | 3,023 | 7,767 | +157% | 0 | 0 | — |
case-06 | fail→pass | 21,326 | 7,492 | -65% | 1 | 1 | 0% | 3,511 | 7,449 | +112% | 0 | 0 | — |
case-07 | fail→pass | 10,964 | 3,627 | -67% | 1 | 1 | 0% | 1,546 | 6,497 | +320% | 0 | 0 | — |
case-08 | fail→pass | 15,067 | 6,015 | -60% | 1 | 1 | 0% | 2,542 | 7,127 | +180% | 0 | 0 | — |
case-09 | fail→pass | 11,172 | 7,255 | -35% | 1 | 1 | 0% | 2,007 | 7,299 | +264% | 0 | 0 | — |
case-10 | fail→pass | 14,032 | 3,688 | -74% | 1 | 1 | 0% | 2,195 | 6,583 | +200% | 0 | 0 | — |
case-11 | fail→pass | 11,736 | 3,690 | -69% | 1 | 1 | 0% | 1,716 | 6,480 | +278% | 0 | 0 | — |
case-12 | fail→pass | 25,393 | 4,150 | -84% | 1 | 1 | 0% | 4,218 | 6,409 | +52% | 0 | 0 | — |
case-13 | pass→pass | 8,972 | 2,879 | -68% | 1 | 1 | 0% | 1,236 | 6,353 | +414% | 0 | 0 | — |
case-14 | fail→pass | 13,018 | 2,801 | -78% | 1 | 1 | 0% | 1,881 | 6,363 | +238% | 0 | 0 | — |
case-20 | pass→pass | 20,834 | 8,417 | -60% | 1 | 1 | 0% | 3,388 | 7,274 | +115% | 0 | 0 | — |
case-15 | fail→pass | 6,865 | 2,771 | -60% | 1 | 1 | 0% | 1,048 | 6,288 | +500% | 0 | 0 | — |
case-16 | pass→pass | 9,891 | 3,011 | -70% | 1 | 1 | 0% | 1,781 | 6,358 | +257% | 0 | 0 | — |
case-17 | fail→pass | 17,662 | 10,575 | -40% | 1 | 1 | 0% | 2,872 | 7,916 | +176% | 0 | 0 | — |
case-18 | fail→pass | 12,002 | 3,682 | -69% | 1 | 1 | 0% | 2,173 | 6,527 | +200% | 0 | 0 | — |
case-19 | fail→pass | 28,779 | 3,414 | -88% | 1 | 1 | 0% | 4,054 | 6,417 | +58% | 0 | 0 | — |
case-21 | pass→pass | 14,188 | 6,065 | -57% | 1 | 1 | 0% | 2,030 | 6,865 | +238% | 0 | 0 | — |
case-22 | pass→pass | 9,363 | 8,098 | -14% | 1 | 1 | 0% | 1,761 | 7,279 | +313% | 0 | 0 | — |
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 +73 percentage points is the difference between those two pass rates over the 22 comparable cases.
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.
| Model | Method | Date | Lift |
|---|---|---|---|
| gemini-3.6-flash | verified | 8/22/2026 | +83% |
Other measured skills in the registry, with their headline benchmark lift.