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 Go SDK examples.
.claude/skills/team-telnyx-telnyx-video-go/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-01 | ✗→✓ | ▲ Improved | 147% | 0% |
| case-02 | ✗→✓ | ▲ Improved | 162% | 0% |
| case-03 | ✗→✓ | ▲ Improved | 200% | 0% |
| case-04 | ✗→✓ | ▲ Improved | 203% | 0% |
| case-05 | ✗→✓ | ▲ Improved | 196% | 0% |
<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->
bashgo get github.com/team-telnyx/telnyx-go
goimport ( "context" "fmt" "os" "github.com/team-telnyx/telnyx-go" "github.com/team-telnyx/telnyx-go/option" ) client := telnyx.NewClient( option.WithAPIKey(os.Getenv("TELNYX_API_KEY")), )
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:
goimport "errors" result, err := client.Messages.Send(ctx, params) if err != nil { var apiErr *telnyx.Error if errors.As(err, &apiErr) { switch apiErr.StatusCode { case 422: fmt.Println("Validation error — check required fields and formats") case 429: // Rate limited — wait and retry with exponential backoff fmt.Println("Rate limited, retrying...") default: fmt.Printf("API error %d: %s\n", apiErr.StatusCode, apiErr.Error()) } } else { fmt.Println("Network error — check connectivity and retry") } }
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
gopage, err := client.RoomCompositions.List(context.Background(), telnyx.RoomCompositionListParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", page)
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)
goroomComposition, err := client.RoomCompositions.New(context.Background(), telnyx.RoomCompositionNewParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", roomComposition.Data)
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}
goroomComposition, err := client.RoomCompositions.Get(context.Background(), "5219b3af-87c6-4c08-9b58-5a533d893e21") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", roomComposition.Data)
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}
goerr := client.RoomCompositions.Delete(context.Background(), "5219b3af-87c6-4c08-9b58-5a533d893e21") if err != nil { log.Fatal(err) }
GET /room_participants
gopage, err := client.RoomParticipants.List(context.Background(), telnyx.RoomParticipantListParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", page)
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}
goroomParticipant, err := client.RoomParticipants.Get(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", roomParticipant.Data)
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
gopage, err := client.RoomRecordings.List(context.Background(), telnyx.RoomRecordingListParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", page)
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
goresponse, err := client.RoomRecordings.DeleteBulk(context.Background(), telnyx.RoomRecordingDeleteBulkParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", response.Data)
Returns: room_recordings (integer)
GET /room_recordings/{room_recording_id}
goroomRecording, err := client.RoomRecordings.Get(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", roomRecording.Data)
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}
goerr := client.RoomRecordings.Delete(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0") if err != nil { log.Fatal(err) }
GET /room_sessions
gopage, err := client.Rooms.Sessions.List0(context.Background(), telnyx.RoomSessionList0Params{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", page)
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}
gosession, err := client.Rooms.Sessions.Get( context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0", telnyx.RoomSessionGetParams{}, ) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", session.Data)
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
goresponse, err := client.Rooms.Sessions.Actions.End(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", response.Data)
Returns: result (string)
POST /room_sessions/{room_session_id}/actions/kick
Optional: exclude (arraystring]), participants (object)
goresponse, err := client.Rooms.Sessions.Actions.Kick( context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0", telnyx.RoomSessionActionKickParams{ ActionsParticipantsRequest: telnyx.ActionsParticipantsRequestParam{}, }, ) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", response.Data)
Returns: result (string)
POST /room_sessions/{room_session_id}/actions/mute
Optional: exclude (arraystring]), participants (object)
goresponse, err := client.Rooms.Sessions.Actions.Mute( context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0", telnyx.RoomSessionActionMuteParams{ ActionsParticipantsRequest: telnyx.ActionsParticipantsRequestParam{}, }, ) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", response.Data)
Returns: result (string)
POST /room_sessions/{room_session_id}/actions/unmute
Optional: exclude (arraystring]), participants (object)
goresponse, err := client.Rooms.Sessions.Actions.Unmute( context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0", telnyx.RoomSessionActionUnmuteParams{ ActionsParticipantsRequest: telnyx.ActionsParticipantsRequestParam{}, }, ) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", response.Data)
Returns: result (string)
GET /room_sessions/{room_session_id}/participants
gopage, err := client.Rooms.Sessions.GetParticipants( context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0", telnyx.RoomSessionGetParticipantsParams{}, ) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", page)
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
gopage, err := client.Rooms.List(context.Background(), telnyx.RoomListParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", page)
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)
goroom, err := client.Rooms.New(context.Background(), telnyx.RoomNewParams{ UniqueName: "my-meeting-room", MaxParticipants: 10, }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", room.Data)
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}
goroom, err := client.Rooms.Get( context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0", telnyx.RoomGetParams{}, ) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", room.Data)
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)
goroom, err := client.Rooms.Update( context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0", telnyx.RoomUpdateParams{}, ) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", room.Data)
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}
goerr := client.Rooms.Delete(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0") if err != nil { log.Fatal(err) }
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)
goresponse, err := client.Rooms.Actions.GenerateJoinClientToken( context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0", telnyx.RoomActionGenerateJoinClientTokenParams{}, ) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", response.Data)
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)
goresponse, err := client.Rooms.Actions.RefreshClientToken( context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0", telnyx.RoomActionRefreshClientTokenParams{ RefreshToken: "eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJ0ZWxueXhfdGVsZXBob255IiwiZXhwIjoxNTkwMDEwMTQzLCJpYXQiOjE1ODc1OTA5NDMsImlzcyI6InRlbG55eF90ZWxlcGhvbnkiLCJqdGkiOiJiOGM3NDgzNy1kODllLTRhNjUtOWNmMi0zNGM3YTZmYTYwYzgiLCJuYmYiOjE1ODc1OTA5NDIsInN1YiI6IjVjN2FjN2QwLWRiNjUtNGYxMS05OGUxLWVlYzBkMWQ1YzZhZSIsInRlbF90b2tlbiI6InJqX1pra1pVT1pNeFpPZk9tTHBFVUIzc2lVN3U2UmpaRmVNOXMtZ2JfeENSNTZXRktGQUppTXlGMlQ2Q0JSbWxoX1N5MGlfbGZ5VDlBSThzRWlmOE1USUlzenl6U2xfYURuRzQ4YU81MHlhSEd1UlNZYlViU1ltOVdJaVEwZz09IiwidHlwIjoiYWNjZXNzIn0.gNEwzTow5MLLPLQENytca7pUN79PmPj6FyqZWW06ZeEmesxYpwKh0xRtA0TzLh6CDYIRHrI8seofOO0YFGDhpQ", }, ) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", response.Data)
Returns: token (string), token_expires_at (date-time)
GET /rooms/{room_id}/sessions
gopage, err := client.Rooms.Sessions.List1( context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0", telnyx.RoomSessionList1Params{}, ) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", page)
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-01 | fail→pass | 16,700 | 12,768 | -24% | 1 | 1 | 0% | 3,542 | 8,757 | +147% | 0 | 0 | — |
case-02 | fail→pass | 13,288 | 6,715 | -49% | 1 | 1 | 0% | 2,754 | 7,219 | +162% | 0 | 0 | — |
case-03 | fail→pass | 11,288 | 6,022 | -47% | 1 | 1 | 0% | 2,348 | 7,055 | +200% | 0 | 0 | — |
case-04 | fail→pass | 11,373 | 6,847 | -40% | 1 | 1 | 0% | 2,403 | 7,285 | +203% | 0 | 0 | — |
case-05 | fail→pass | 11,371 | 4,664 | -59% | 1 | 1 | 0% | 2,292 | 6,773 | +196% | 0 | 0 | — |
case-06 | fail→pass | 8,787 | 28,501 | +224% | 1 | 1 | 0% | 1,759 | 6,708 | +281% | 0 | 0 | — |
case-11 | fail→pass | 9,853 | 2,888 | -71% | 1 | 1 | 0% | 2,021 | 6,347 | +214% | 0 | 0 | — |
case-07 | fail→pass | 11,863 | 2,972 | -75% | 1 | 1 | 0% | 2,354 | 6,415 | +173% | 0 | 0 | — |
case-08 | fail→pass | 10,676 | 4,151 | -61% | 1 | 1 | 0% | 2,180 | 6,608 | +203% | 0 | 0 | — |
case-09 | pass→pass | 11,156 | 2,594 | -77% | 1 | 1 | 0% | 2,121 | 6,332 | +199% | 0 | 0 | — |
case-10 | fail→pass | 9,571 | 2,574 | -73% | 1 | 1 | 0% | 2,103 | 6,307 | +200% | 0 | 0 | — |
case-12 | fail→pass | 8,964 | 6,806 | -24% | 1 | 1 | 0% | 1,814 | 6,616 | +265% | 0 | 0 | — |
case-13 | pass→pass | 8,310 | 2,747 | -67% | 1 | 1 | 0% | 1,655 | 6,380 | +285% | 0 | 0 | — |
case-14 | fail→pass | 11,340 | 4,304 | -62% | 1 | 1 | 0% | 2,419 | 6,807 | +181% | 0 | 0 | — |
case-15 | fail→pass | 9,453 | 2,466 | -74% | 1 | 1 | 0% | 1,889 | 6,334 | +235% | 0 | 0 | — |
case-16 | pass→pass | 12,297 | 15,045 | +22% | 1 | 1 | 0% | 2,570 | 6,261 | +144% | 0 | 0 | — |
case-17 | fail→pass | 12,595 | 4,114 | -67% | 1 | 1 | 0% | 2,995 | 6,410 | +114% | 0 | 0 | — |
case-18 | fail→pass | 8,749 | 3,621 | -59% | 1 | 1 | 0% | 1,854 | 6,612 | +257% | 0 | 0 | — |
case-19 | fail→pass | 8,448 | 4,565 | -46% | 1 | 1 | 0% | 1,592 | 6,340 | +298% | 0 | 0 | — |
case-20 | fail→fail | 6,442 | 11,329 | +76% | 1 | 1 | 0% | 1,396 | 7,169 | +414% | 0 | 0 | — |
case-21 | pass→fail | 9,907 | 6,459 | -35% | 1 | 1 | 0% | 2,026 | 7,175 | +254% | 0 | 0 | — |
case-22 | pass→pass | 10,478 | 8,523 | -19% | 1 | 1 | 0% | 2,116 | 7,461 | +253% | 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 +68 percentage points is the difference between those two pass rates over the 22 comparable cases. 1 case got worse with the skill loaded, and it is included in that figure.
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.
Other measured skills in the registry, with their headline benchmark lift.