telnyx 3.9.0__py3-none-any.whl → 3.11.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of telnyx might be problematic. Click here for more details.

Files changed (56) hide show
  1. telnyx/_streaming.py +4 -6
  2. telnyx/_version.py +1 -1
  3. telnyx/resources/__init__.py +1 -2
  4. telnyx/resources/ai/__init__.py +28 -0
  5. telnyx/resources/ai/ai.py +64 -0
  6. telnyx/resources/ai/integrations/__init__.py +33 -0
  7. telnyx/resources/ai/integrations/connections.py +294 -0
  8. telnyx/resources/ai/integrations/integrations.py +246 -0
  9. telnyx/resources/ai/mcp_servers.py +571 -0
  10. telnyx/resources/calls/actions.py +8 -0
  11. telnyx/resources/calls/calls.py +8 -0
  12. telnyx/resources/conferences/actions.py +180 -8
  13. telnyx/resources/conferences/conferences.py +50 -3
  14. telnyx/resources/recordings/recordings.py +2 -2
  15. telnyx/resources/texml/accounts/calls/calls.py +8 -0
  16. telnyx/resources/webhooks.py +82 -94
  17. telnyx/types/__init__.py +1 -0
  18. telnyx/types/ai/__init__.py +9 -0
  19. telnyx/types/ai/integration_list_response.py +28 -0
  20. telnyx/types/ai/integration_retrieve_response.py +24 -0
  21. telnyx/types/ai/integrations/__init__.py +6 -0
  22. telnyx/types/ai/integrations/connection_list_response.py +19 -0
  23. telnyx/types/ai/integrations/connection_retrieve_response.py +19 -0
  24. telnyx/types/ai/mcp_server_create_params.py +22 -0
  25. telnyx/types/ai/mcp_server_create_response.py +24 -0
  26. telnyx/types/ai/mcp_server_list_params.py +19 -0
  27. telnyx/types/ai/mcp_server_list_response.py +28 -0
  28. telnyx/types/ai/mcp_server_retrieve_response.py +24 -0
  29. telnyx/types/ai/mcp_server_update_params.py +28 -0
  30. telnyx/types/ai/mcp_server_update_response.py +24 -0
  31. telnyx/types/call_dial_params.py +3 -0
  32. telnyx/types/calls/action_transfer_params.py +3 -0
  33. telnyx/types/conference_create_params.py +6 -0
  34. telnyx/types/conference_list_params.py +3 -0
  35. telnyx/types/conference_list_participants_params.py +4 -1
  36. telnyx/types/conference_retrieve_params.py +12 -0
  37. telnyx/types/conferences/action_hold_params.py +7 -1
  38. telnyx/types/conferences/action_join_params.py +6 -0
  39. telnyx/types/conferences/action_leave_params.py +6 -0
  40. telnyx/types/conferences/action_mute_params.py +7 -1
  41. telnyx/types/conferences/action_play_params.py +7 -1
  42. telnyx/types/conferences/action_record_pause_params.py +7 -1
  43. telnyx/types/conferences/action_record_resume_params.py +7 -1
  44. telnyx/types/conferences/action_record_start_params.py +6 -0
  45. telnyx/types/conferences/action_record_stop_params.py +7 -1
  46. telnyx/types/conferences/action_speak_params.py +6 -0
  47. telnyx/types/conferences/action_stop_params.py +7 -1
  48. telnyx/types/conferences/action_unhold_params.py +7 -1
  49. telnyx/types/conferences/action_unmute_params.py +7 -1
  50. telnyx/types/conferences/action_update_params.py +6 -0
  51. telnyx/types/recording_list_params.py +7 -1
  52. telnyx/types/texml/accounts/call_calls_params.py +5 -0
  53. {telnyx-3.9.0.dist-info → telnyx-3.11.0.dist-info}/METADATA +1 -1
  54. {telnyx-3.9.0.dist-info → telnyx-3.11.0.dist-info}/RECORD +56 -39
  55. {telnyx-3.9.0.dist-info → telnyx-3.11.0.dist-info}/WHEEL +0 -0
  56. {telnyx-3.9.0.dist-info → telnyx-3.11.0.dist-info}/licenses/LICENSE +0 -0
@@ -79,6 +79,7 @@ class ActionsResource(SyncAPIResource):
79
79
  call_control_id: str,
80
80
  supervisor_role: Literal["barge", "monitor", "none", "whisper"],
81
81
  command_id: str | Omit = omit,
82
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
82
83
  whisper_call_control_ids: SequenceNotStr[str] | Omit = omit,
83
84
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
84
85
  # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -103,6 +104,9 @@ class ActionsResource(SyncAPIResource):
103
104
  subsequent commands with the same `command_id` as one that has already been
104
105
  executed.
105
106
 
107
+ region: Region where the conference data is located. Defaults to the region defined in
108
+ user's data locality settings (Europe or US).
109
+
106
110
  whisper_call_control_ids: Array of unique call_control_ids the supervisor can whisper to. If none
107
111
  provided, the supervisor will join the conference as a monitoring participant
108
112
  only.
@@ -124,6 +128,7 @@ class ActionsResource(SyncAPIResource):
124
128
  "call_control_id": call_control_id,
125
129
  "supervisor_role": supervisor_role,
126
130
  "command_id": command_id,
131
+ "region": region,
127
132
  "whisper_call_control_ids": whisper_call_control_ids,
128
133
  },
129
134
  action_update_params.ActionUpdateParams,
@@ -141,6 +146,7 @@ class ActionsResource(SyncAPIResource):
141
146
  audio_url: str | Omit = omit,
142
147
  call_control_ids: SequenceNotStr[str] | Omit = omit,
143
148
  media_name: str | Omit = omit,
149
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
144
150
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
145
151
  # The extra values given here take precedence over values defined on the client or passed to this method.
146
152
  extra_headers: Headers | None = None,
@@ -163,6 +169,9 @@ class ActionsResource(SyncAPIResource):
163
169
  api.telnyx.com/v2/media by the same user/organization. The file must either be a
164
170
  WAV or MP3 file.
165
171
 
172
+ region: Region where the conference data is located. Defaults to the region defined in
173
+ user's data locality settings (Europe or US).
174
+
166
175
  extra_headers: Send extra headers
167
176
 
168
177
  extra_query: Add additional query parameters to the request
@@ -180,6 +189,7 @@ class ActionsResource(SyncAPIResource):
180
189
  "audio_url": audio_url,
181
190
  "call_control_ids": call_control_ids,
182
191
  "media_name": media_name,
192
+ "region": region,
183
193
  },
184
194
  action_hold_params.ActionHoldParams,
185
195
  ),
@@ -202,6 +212,7 @@ class ActionsResource(SyncAPIResource):
202
212
  hold_audio_url: str | Omit = omit,
203
213
  hold_media_name: str | Omit = omit,
204
214
  mute: bool | Omit = omit,
215
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
205
216
  soft_end_conference_on_exit: bool | Omit = omit,
206
217
  start_conference_on_enter: bool | Omit = omit,
207
218
  supervisor_role: Literal["barge", "monitor", "none", "whisper"] | Omit = omit,
@@ -262,6 +273,9 @@ class ActionsResource(SyncAPIResource):
262
273
  mute: Whether the participant should be muted immediately after joining the
263
274
  conference. Defaults to "false".
264
275
 
276
+ region: Region where the conference data is located. Defaults to the region defined in
277
+ user's data locality settings (Europe or US).
278
+
265
279
  soft_end_conference_on_exit: Whether the conference should end after the participant leaves the conference.
266
280
  NOTE this doesn't hang up the other participants. Defaults to "false".
267
281
 
@@ -302,6 +316,7 @@ class ActionsResource(SyncAPIResource):
302
316
  "hold_audio_url": hold_audio_url,
303
317
  "hold_media_name": hold_media_name,
304
318
  "mute": mute,
319
+ "region": region,
305
320
  "soft_end_conference_on_exit": soft_end_conference_on_exit,
306
321
  "start_conference_on_enter": start_conference_on_enter,
307
322
  "supervisor_role": supervisor_role,
@@ -322,6 +337,7 @@ class ActionsResource(SyncAPIResource):
322
337
  call_control_id: str,
323
338
  beep_enabled: Literal["always", "never", "on_enter", "on_exit"] | Omit = omit,
324
339
  command_id: str | Omit = omit,
340
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
325
341
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
326
342
  # The extra values given here take precedence over values defined on the client or passed to this method.
327
343
  extra_headers: Headers | None = None,
@@ -346,6 +362,9 @@ class ActionsResource(SyncAPIResource):
346
362
  subsequent commands with the same `command_id` as one that has already been
347
363
  executed.
348
364
 
365
+ region: Region where the conference data is located. Defaults to the region defined in
366
+ user's data locality settings (Europe or US).
367
+
349
368
  extra_headers: Send extra headers
350
369
 
351
370
  extra_query: Add additional query parameters to the request
@@ -363,6 +382,7 @@ class ActionsResource(SyncAPIResource):
363
382
  "call_control_id": call_control_id,
364
383
  "beep_enabled": beep_enabled,
365
384
  "command_id": command_id,
385
+ "region": region,
366
386
  },
367
387
  action_leave_params.ActionLeaveParams,
368
388
  ),
@@ -377,6 +397,7 @@ class ActionsResource(SyncAPIResource):
377
397
  id: str,
378
398
  *,
379
399
  call_control_ids: SequenceNotStr[str] | Omit = omit,
400
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
380
401
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
381
402
  # The extra values given here take precedence over values defined on the client or passed to this method.
382
403
  extra_headers: Headers | None = None,
@@ -391,6 +412,9 @@ class ActionsResource(SyncAPIResource):
391
412
  call_control_ids: Array of unique identifiers and tokens for controlling the call. When empty all
392
413
  participants will be muted.
393
414
 
415
+ region: Region where the conference data is located. Defaults to the region defined in
416
+ user's data locality settings (Europe or US).
417
+
394
418
  extra_headers: Send extra headers
395
419
 
396
420
  extra_query: Add additional query parameters to the request
@@ -403,7 +427,13 @@ class ActionsResource(SyncAPIResource):
403
427
  raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
404
428
  return self._post(
405
429
  f"/conferences/{id}/actions/mute",
406
- body=maybe_transform({"call_control_ids": call_control_ids}, action_mute_params.ActionMuteParams),
430
+ body=maybe_transform(
431
+ {
432
+ "call_control_ids": call_control_ids,
433
+ "region": region,
434
+ },
435
+ action_mute_params.ActionMuteParams,
436
+ ),
407
437
  options=make_request_options(
408
438
  extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
409
439
  ),
@@ -418,6 +448,7 @@ class ActionsResource(SyncAPIResource):
418
448
  call_control_ids: SequenceNotStr[str] | Omit = omit,
419
449
  loop: LoopcountParam | Omit = omit,
420
450
  media_name: str | Omit = omit,
451
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
421
452
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
422
453
  # The extra values given here take precedence over values defined on the client or passed to this method.
423
454
  extra_headers: Headers | None = None,
@@ -443,6 +474,9 @@ class ActionsResource(SyncAPIResource):
443
474
  must point to a file previously uploaded to api.telnyx.com/v2/media by the same
444
475
  user/organization. The file must either be a WAV or MP3 file.
445
476
 
477
+ region: Region where the conference data is located. Defaults to the region defined in
478
+ user's data locality settings (Europe or US).
479
+
446
480
  extra_headers: Send extra headers
447
481
 
448
482
  extra_query: Add additional query parameters to the request
@@ -461,6 +495,7 @@ class ActionsResource(SyncAPIResource):
461
495
  "call_control_ids": call_control_ids,
462
496
  "loop": loop,
463
497
  "media_name": media_name,
498
+ "region": region,
464
499
  },
465
500
  action_play_params.ActionPlayParams,
466
501
  ),
@@ -476,6 +511,7 @@ class ActionsResource(SyncAPIResource):
476
511
  *,
477
512
  command_id: str | Omit = omit,
478
513
  recording_id: str | Omit = omit,
514
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
479
515
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
480
516
  # The extra values given here take precedence over values defined on the client or passed to this method.
481
517
  extra_headers: Headers | None = None,
@@ -492,6 +528,9 @@ class ActionsResource(SyncAPIResource):
492
528
 
493
529
  recording_id: Use this field to pause specific recording.
494
530
 
531
+ region: Region where the conference data is located. Defaults to the region defined in
532
+ user's data locality settings (Europe or US).
533
+
495
534
  extra_headers: Send extra headers
496
535
 
497
536
  extra_query: Add additional query parameters to the request
@@ -508,6 +547,7 @@ class ActionsResource(SyncAPIResource):
508
547
  {
509
548
  "command_id": command_id,
510
549
  "recording_id": recording_id,
550
+ "region": region,
511
551
  },
512
552
  action_record_pause_params.ActionRecordPauseParams,
513
553
  ),
@@ -523,6 +563,7 @@ class ActionsResource(SyncAPIResource):
523
563
  *,
524
564
  command_id: str | Omit = omit,
525
565
  recording_id: str | Omit = omit,
566
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
526
567
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
527
568
  # The extra values given here take precedence over values defined on the client or passed to this method.
528
569
  extra_headers: Headers | None = None,
@@ -539,6 +580,9 @@ class ActionsResource(SyncAPIResource):
539
580
 
540
581
  recording_id: Use this field to resume specific recording.
541
582
 
583
+ region: Region where the conference data is located. Defaults to the region defined in
584
+ user's data locality settings (Europe or US).
585
+
542
586
  extra_headers: Send extra headers
543
587
 
544
588
  extra_query: Add additional query parameters to the request
@@ -555,6 +599,7 @@ class ActionsResource(SyncAPIResource):
555
599
  {
556
600
  "command_id": command_id,
557
601
  "recording_id": recording_id,
602
+ "region": region,
558
603
  },
559
604
  action_record_resume_params.ActionRecordResumeParams,
560
605
  ),
@@ -572,6 +617,7 @@ class ActionsResource(SyncAPIResource):
572
617
  command_id: str | Omit = omit,
573
618
  custom_file_name: str | Omit = omit,
574
619
  play_beep: bool | Omit = omit,
620
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
575
621
  trim: Literal["trim-silence"] | Omit = omit,
576
622
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
577
623
  # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -601,6 +647,9 @@ class ActionsResource(SyncAPIResource):
601
647
 
602
648
  play_beep: If enabled, a beep sound will be played at the start of a recording.
603
649
 
650
+ region: Region where the conference data is located. Defaults to the region defined in
651
+ user's data locality settings (Europe or US).
652
+
604
653
  trim: When set to `trim-silence`, silence will be removed from the beginning and end
605
654
  of the recording.
606
655
 
@@ -622,6 +671,7 @@ class ActionsResource(SyncAPIResource):
622
671
  "command_id": command_id,
623
672
  "custom_file_name": custom_file_name,
624
673
  "play_beep": play_beep,
674
+ "region": region,
625
675
  "trim": trim,
626
676
  },
627
677
  action_record_start_params.ActionRecordStartParams,
@@ -639,6 +689,7 @@ class ActionsResource(SyncAPIResource):
639
689
  client_state: str | Omit = omit,
640
690
  command_id: str | Omit = omit,
641
691
  recording_id: str | Omit = omit,
692
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
642
693
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
643
694
  # The extra values given here take precedence over values defined on the client or passed to this method.
644
695
  extra_headers: Headers | None = None,
@@ -662,6 +713,9 @@ class ActionsResource(SyncAPIResource):
662
713
 
663
714
  recording_id: Uniquely identifies the resource.
664
715
 
716
+ region: Region where the conference data is located. Defaults to the region defined in
717
+ user's data locality settings (Europe or US).
718
+
665
719
  extra_headers: Send extra headers
666
720
 
667
721
  extra_query: Add additional query parameters to the request
@@ -679,6 +733,7 @@ class ActionsResource(SyncAPIResource):
679
733
  "client_state": client_state,
680
734
  "command_id": command_id,
681
735
  "recording_id": recording_id,
736
+ "region": region,
682
737
  },
683
738
  action_record_stop_params.ActionRecordStopParams,
684
739
  ),
@@ -729,6 +784,7 @@ class ActionsResource(SyncAPIResource):
729
784
  ]
730
785
  | Omit = omit,
731
786
  payload_type: Literal["text", "ssml"] | Omit = omit,
787
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
732
788
  voice_settings: action_speak_params.VoiceSettings | Omit = omit,
733
789
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
734
790
  # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -785,6 +841,9 @@ class ActionsResource(SyncAPIResource):
785
841
  payload_type: The type of the provided payload. The payload can either be plain text, or
786
842
  Speech Synthesis Markup Language (SSML).
787
843
 
844
+ region: Region where the conference data is located. Defaults to the region defined in
845
+ user's data locality settings (Europe or US).
846
+
788
847
  voice_settings: The settings associated with the voice selected
789
848
 
790
849
  extra_headers: Send extra headers
@@ -807,6 +866,7 @@ class ActionsResource(SyncAPIResource):
807
866
  "command_id": command_id,
808
867
  "language": language,
809
868
  "payload_type": payload_type,
869
+ "region": region,
810
870
  "voice_settings": voice_settings,
811
871
  },
812
872
  action_speak_params.ActionSpeakParams,
@@ -822,6 +882,7 @@ class ActionsResource(SyncAPIResource):
822
882
  id: str,
823
883
  *,
824
884
  call_control_ids: SequenceNotStr[str] | Omit = omit,
885
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
825
886
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
826
887
  # The extra values given here take precedence over values defined on the client or passed to this method.
827
888
  extra_headers: Headers | None = None,
@@ -836,6 +897,9 @@ class ActionsResource(SyncAPIResource):
836
897
  call_control_ids: List of call control ids identifying participants the audio file should stop be
837
898
  played to. If not given, the audio will be stoped to the entire conference.
838
899
 
900
+ region: Region where the conference data is located. Defaults to the region defined in
901
+ user's data locality settings (Europe or US).
902
+
839
903
  extra_headers: Send extra headers
840
904
 
841
905
  extra_query: Add additional query parameters to the request
@@ -848,7 +912,13 @@ class ActionsResource(SyncAPIResource):
848
912
  raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
849
913
  return self._post(
850
914
  f"/conferences/{id}/actions/stop",
851
- body=maybe_transform({"call_control_ids": call_control_ids}, action_stop_params.ActionStopParams),
915
+ body=maybe_transform(
916
+ {
917
+ "call_control_ids": call_control_ids,
918
+ "region": region,
919
+ },
920
+ action_stop_params.ActionStopParams,
921
+ ),
852
922
  options=make_request_options(
853
923
  extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
854
924
  ),
@@ -860,6 +930,7 @@ class ActionsResource(SyncAPIResource):
860
930
  id: str,
861
931
  *,
862
932
  call_control_ids: SequenceNotStr[str],
933
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
863
934
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
864
935
  # The extra values given here take precedence over values defined on the client or passed to this method.
865
936
  extra_headers: Headers | None = None,
@@ -874,6 +945,9 @@ class ActionsResource(SyncAPIResource):
874
945
  call_control_ids: List of unique identifiers and tokens for controlling the call. Enter each call
875
946
  control ID to be unheld.
876
947
 
948
+ region: Region where the conference data is located. Defaults to the region defined in
949
+ user's data locality settings (Europe or US).
950
+
877
951
  extra_headers: Send extra headers
878
952
 
879
953
  extra_query: Add additional query parameters to the request
@@ -886,7 +960,13 @@ class ActionsResource(SyncAPIResource):
886
960
  raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
887
961
  return self._post(
888
962
  f"/conferences/{id}/actions/unhold",
889
- body=maybe_transform({"call_control_ids": call_control_ids}, action_unhold_params.ActionUnholdParams),
963
+ body=maybe_transform(
964
+ {
965
+ "call_control_ids": call_control_ids,
966
+ "region": region,
967
+ },
968
+ action_unhold_params.ActionUnholdParams,
969
+ ),
890
970
  options=make_request_options(
891
971
  extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
892
972
  ),
@@ -898,6 +978,7 @@ class ActionsResource(SyncAPIResource):
898
978
  id: str,
899
979
  *,
900
980
  call_control_ids: SequenceNotStr[str] | Omit = omit,
981
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
901
982
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
902
983
  # The extra values given here take precedence over values defined on the client or passed to this method.
903
984
  extra_headers: Headers | None = None,
@@ -912,6 +993,9 @@ class ActionsResource(SyncAPIResource):
912
993
  call_control_ids: List of unique identifiers and tokens for controlling the call. Enter each call
913
994
  control ID to be unmuted. When empty all participants will be unmuted.
914
995
 
996
+ region: Region where the conference data is located. Defaults to the region defined in
997
+ user's data locality settings (Europe or US).
998
+
915
999
  extra_headers: Send extra headers
916
1000
 
917
1001
  extra_query: Add additional query parameters to the request
@@ -924,7 +1008,13 @@ class ActionsResource(SyncAPIResource):
924
1008
  raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
925
1009
  return self._post(
926
1010
  f"/conferences/{id}/actions/unmute",
927
- body=maybe_transform({"call_control_ids": call_control_ids}, action_unmute_params.ActionUnmuteParams),
1011
+ body=maybe_transform(
1012
+ {
1013
+ "call_control_ids": call_control_ids,
1014
+ "region": region,
1015
+ },
1016
+ action_unmute_params.ActionUnmuteParams,
1017
+ ),
928
1018
  options=make_request_options(
929
1019
  extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
930
1020
  ),
@@ -959,6 +1049,7 @@ class AsyncActionsResource(AsyncAPIResource):
959
1049
  call_control_id: str,
960
1050
  supervisor_role: Literal["barge", "monitor", "none", "whisper"],
961
1051
  command_id: str | Omit = omit,
1052
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
962
1053
  whisper_call_control_ids: SequenceNotStr[str] | Omit = omit,
963
1054
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
964
1055
  # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -983,6 +1074,9 @@ class AsyncActionsResource(AsyncAPIResource):
983
1074
  subsequent commands with the same `command_id` as one that has already been
984
1075
  executed.
985
1076
 
1077
+ region: Region where the conference data is located. Defaults to the region defined in
1078
+ user's data locality settings (Europe or US).
1079
+
986
1080
  whisper_call_control_ids: Array of unique call_control_ids the supervisor can whisper to. If none
987
1081
  provided, the supervisor will join the conference as a monitoring participant
988
1082
  only.
@@ -1004,6 +1098,7 @@ class AsyncActionsResource(AsyncAPIResource):
1004
1098
  "call_control_id": call_control_id,
1005
1099
  "supervisor_role": supervisor_role,
1006
1100
  "command_id": command_id,
1101
+ "region": region,
1007
1102
  "whisper_call_control_ids": whisper_call_control_ids,
1008
1103
  },
1009
1104
  action_update_params.ActionUpdateParams,
@@ -1021,6 +1116,7 @@ class AsyncActionsResource(AsyncAPIResource):
1021
1116
  audio_url: str | Omit = omit,
1022
1117
  call_control_ids: SequenceNotStr[str] | Omit = omit,
1023
1118
  media_name: str | Omit = omit,
1119
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
1024
1120
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
1025
1121
  # The extra values given here take precedence over values defined on the client or passed to this method.
1026
1122
  extra_headers: Headers | None = None,
@@ -1043,6 +1139,9 @@ class AsyncActionsResource(AsyncAPIResource):
1043
1139
  api.telnyx.com/v2/media by the same user/organization. The file must either be a
1044
1140
  WAV or MP3 file.
1045
1141
 
1142
+ region: Region where the conference data is located. Defaults to the region defined in
1143
+ user's data locality settings (Europe or US).
1144
+
1046
1145
  extra_headers: Send extra headers
1047
1146
 
1048
1147
  extra_query: Add additional query parameters to the request
@@ -1060,6 +1159,7 @@ class AsyncActionsResource(AsyncAPIResource):
1060
1159
  "audio_url": audio_url,
1061
1160
  "call_control_ids": call_control_ids,
1062
1161
  "media_name": media_name,
1162
+ "region": region,
1063
1163
  },
1064
1164
  action_hold_params.ActionHoldParams,
1065
1165
  ),
@@ -1082,6 +1182,7 @@ class AsyncActionsResource(AsyncAPIResource):
1082
1182
  hold_audio_url: str | Omit = omit,
1083
1183
  hold_media_name: str | Omit = omit,
1084
1184
  mute: bool | Omit = omit,
1185
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
1085
1186
  soft_end_conference_on_exit: bool | Omit = omit,
1086
1187
  start_conference_on_enter: bool | Omit = omit,
1087
1188
  supervisor_role: Literal["barge", "monitor", "none", "whisper"] | Omit = omit,
@@ -1142,6 +1243,9 @@ class AsyncActionsResource(AsyncAPIResource):
1142
1243
  mute: Whether the participant should be muted immediately after joining the
1143
1244
  conference. Defaults to "false".
1144
1245
 
1246
+ region: Region where the conference data is located. Defaults to the region defined in
1247
+ user's data locality settings (Europe or US).
1248
+
1145
1249
  soft_end_conference_on_exit: Whether the conference should end after the participant leaves the conference.
1146
1250
  NOTE this doesn't hang up the other participants. Defaults to "false".
1147
1251
 
@@ -1182,6 +1286,7 @@ class AsyncActionsResource(AsyncAPIResource):
1182
1286
  "hold_audio_url": hold_audio_url,
1183
1287
  "hold_media_name": hold_media_name,
1184
1288
  "mute": mute,
1289
+ "region": region,
1185
1290
  "soft_end_conference_on_exit": soft_end_conference_on_exit,
1186
1291
  "start_conference_on_enter": start_conference_on_enter,
1187
1292
  "supervisor_role": supervisor_role,
@@ -1202,6 +1307,7 @@ class AsyncActionsResource(AsyncAPIResource):
1202
1307
  call_control_id: str,
1203
1308
  beep_enabled: Literal["always", "never", "on_enter", "on_exit"] | Omit = omit,
1204
1309
  command_id: str | Omit = omit,
1310
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
1205
1311
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
1206
1312
  # The extra values given here take precedence over values defined on the client or passed to this method.
1207
1313
  extra_headers: Headers | None = None,
@@ -1226,6 +1332,9 @@ class AsyncActionsResource(AsyncAPIResource):
1226
1332
  subsequent commands with the same `command_id` as one that has already been
1227
1333
  executed.
1228
1334
 
1335
+ region: Region where the conference data is located. Defaults to the region defined in
1336
+ user's data locality settings (Europe or US).
1337
+
1229
1338
  extra_headers: Send extra headers
1230
1339
 
1231
1340
  extra_query: Add additional query parameters to the request
@@ -1243,6 +1352,7 @@ class AsyncActionsResource(AsyncAPIResource):
1243
1352
  "call_control_id": call_control_id,
1244
1353
  "beep_enabled": beep_enabled,
1245
1354
  "command_id": command_id,
1355
+ "region": region,
1246
1356
  },
1247
1357
  action_leave_params.ActionLeaveParams,
1248
1358
  ),
@@ -1257,6 +1367,7 @@ class AsyncActionsResource(AsyncAPIResource):
1257
1367
  id: str,
1258
1368
  *,
1259
1369
  call_control_ids: SequenceNotStr[str] | Omit = omit,
1370
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
1260
1371
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
1261
1372
  # The extra values given here take precedence over values defined on the client or passed to this method.
1262
1373
  extra_headers: Headers | None = None,
@@ -1271,6 +1382,9 @@ class AsyncActionsResource(AsyncAPIResource):
1271
1382
  call_control_ids: Array of unique identifiers and tokens for controlling the call. When empty all
1272
1383
  participants will be muted.
1273
1384
 
1385
+ region: Region where the conference data is located. Defaults to the region defined in
1386
+ user's data locality settings (Europe or US).
1387
+
1274
1388
  extra_headers: Send extra headers
1275
1389
 
1276
1390
  extra_query: Add additional query parameters to the request
@@ -1284,7 +1398,11 @@ class AsyncActionsResource(AsyncAPIResource):
1284
1398
  return await self._post(
1285
1399
  f"/conferences/{id}/actions/mute",
1286
1400
  body=await async_maybe_transform(
1287
- {"call_control_ids": call_control_ids}, action_mute_params.ActionMuteParams
1401
+ {
1402
+ "call_control_ids": call_control_ids,
1403
+ "region": region,
1404
+ },
1405
+ action_mute_params.ActionMuteParams,
1288
1406
  ),
1289
1407
  options=make_request_options(
1290
1408
  extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -1300,6 +1418,7 @@ class AsyncActionsResource(AsyncAPIResource):
1300
1418
  call_control_ids: SequenceNotStr[str] | Omit = omit,
1301
1419
  loop: LoopcountParam | Omit = omit,
1302
1420
  media_name: str | Omit = omit,
1421
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
1303
1422
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
1304
1423
  # The extra values given here take precedence over values defined on the client or passed to this method.
1305
1424
  extra_headers: Headers | None = None,
@@ -1325,6 +1444,9 @@ class AsyncActionsResource(AsyncAPIResource):
1325
1444
  must point to a file previously uploaded to api.telnyx.com/v2/media by the same
1326
1445
  user/organization. The file must either be a WAV or MP3 file.
1327
1446
 
1447
+ region: Region where the conference data is located. Defaults to the region defined in
1448
+ user's data locality settings (Europe or US).
1449
+
1328
1450
  extra_headers: Send extra headers
1329
1451
 
1330
1452
  extra_query: Add additional query parameters to the request
@@ -1343,6 +1465,7 @@ class AsyncActionsResource(AsyncAPIResource):
1343
1465
  "call_control_ids": call_control_ids,
1344
1466
  "loop": loop,
1345
1467
  "media_name": media_name,
1468
+ "region": region,
1346
1469
  },
1347
1470
  action_play_params.ActionPlayParams,
1348
1471
  ),
@@ -1358,6 +1481,7 @@ class AsyncActionsResource(AsyncAPIResource):
1358
1481
  *,
1359
1482
  command_id: str | Omit = omit,
1360
1483
  recording_id: str | Omit = omit,
1484
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
1361
1485
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
1362
1486
  # The extra values given here take precedence over values defined on the client or passed to this method.
1363
1487
  extra_headers: Headers | None = None,
@@ -1374,6 +1498,9 @@ class AsyncActionsResource(AsyncAPIResource):
1374
1498
 
1375
1499
  recording_id: Use this field to pause specific recording.
1376
1500
 
1501
+ region: Region where the conference data is located. Defaults to the region defined in
1502
+ user's data locality settings (Europe or US).
1503
+
1377
1504
  extra_headers: Send extra headers
1378
1505
 
1379
1506
  extra_query: Add additional query parameters to the request
@@ -1390,6 +1517,7 @@ class AsyncActionsResource(AsyncAPIResource):
1390
1517
  {
1391
1518
  "command_id": command_id,
1392
1519
  "recording_id": recording_id,
1520
+ "region": region,
1393
1521
  },
1394
1522
  action_record_pause_params.ActionRecordPauseParams,
1395
1523
  ),
@@ -1405,6 +1533,7 @@ class AsyncActionsResource(AsyncAPIResource):
1405
1533
  *,
1406
1534
  command_id: str | Omit = omit,
1407
1535
  recording_id: str | Omit = omit,
1536
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
1408
1537
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
1409
1538
  # The extra values given here take precedence over values defined on the client or passed to this method.
1410
1539
  extra_headers: Headers | None = None,
@@ -1421,6 +1550,9 @@ class AsyncActionsResource(AsyncAPIResource):
1421
1550
 
1422
1551
  recording_id: Use this field to resume specific recording.
1423
1552
 
1553
+ region: Region where the conference data is located. Defaults to the region defined in
1554
+ user's data locality settings (Europe or US).
1555
+
1424
1556
  extra_headers: Send extra headers
1425
1557
 
1426
1558
  extra_query: Add additional query parameters to the request
@@ -1437,6 +1569,7 @@ class AsyncActionsResource(AsyncAPIResource):
1437
1569
  {
1438
1570
  "command_id": command_id,
1439
1571
  "recording_id": recording_id,
1572
+ "region": region,
1440
1573
  },
1441
1574
  action_record_resume_params.ActionRecordResumeParams,
1442
1575
  ),
@@ -1454,6 +1587,7 @@ class AsyncActionsResource(AsyncAPIResource):
1454
1587
  command_id: str | Omit = omit,
1455
1588
  custom_file_name: str | Omit = omit,
1456
1589
  play_beep: bool | Omit = omit,
1590
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
1457
1591
  trim: Literal["trim-silence"] | Omit = omit,
1458
1592
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
1459
1593
  # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -1483,6 +1617,9 @@ class AsyncActionsResource(AsyncAPIResource):
1483
1617
 
1484
1618
  play_beep: If enabled, a beep sound will be played at the start of a recording.
1485
1619
 
1620
+ region: Region where the conference data is located. Defaults to the region defined in
1621
+ user's data locality settings (Europe or US).
1622
+
1486
1623
  trim: When set to `trim-silence`, silence will be removed from the beginning and end
1487
1624
  of the recording.
1488
1625
 
@@ -1504,6 +1641,7 @@ class AsyncActionsResource(AsyncAPIResource):
1504
1641
  "command_id": command_id,
1505
1642
  "custom_file_name": custom_file_name,
1506
1643
  "play_beep": play_beep,
1644
+ "region": region,
1507
1645
  "trim": trim,
1508
1646
  },
1509
1647
  action_record_start_params.ActionRecordStartParams,
@@ -1521,6 +1659,7 @@ class AsyncActionsResource(AsyncAPIResource):
1521
1659
  client_state: str | Omit = omit,
1522
1660
  command_id: str | Omit = omit,
1523
1661
  recording_id: str | Omit = omit,
1662
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
1524
1663
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
1525
1664
  # The extra values given here take precedence over values defined on the client or passed to this method.
1526
1665
  extra_headers: Headers | None = None,
@@ -1544,6 +1683,9 @@ class AsyncActionsResource(AsyncAPIResource):
1544
1683
 
1545
1684
  recording_id: Uniquely identifies the resource.
1546
1685
 
1686
+ region: Region where the conference data is located. Defaults to the region defined in
1687
+ user's data locality settings (Europe or US).
1688
+
1547
1689
  extra_headers: Send extra headers
1548
1690
 
1549
1691
  extra_query: Add additional query parameters to the request
@@ -1561,6 +1703,7 @@ class AsyncActionsResource(AsyncAPIResource):
1561
1703
  "client_state": client_state,
1562
1704
  "command_id": command_id,
1563
1705
  "recording_id": recording_id,
1706
+ "region": region,
1564
1707
  },
1565
1708
  action_record_stop_params.ActionRecordStopParams,
1566
1709
  ),
@@ -1611,6 +1754,7 @@ class AsyncActionsResource(AsyncAPIResource):
1611
1754
  ]
1612
1755
  | Omit = omit,
1613
1756
  payload_type: Literal["text", "ssml"] | Omit = omit,
1757
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
1614
1758
  voice_settings: action_speak_params.VoiceSettings | Omit = omit,
1615
1759
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
1616
1760
  # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -1667,6 +1811,9 @@ class AsyncActionsResource(AsyncAPIResource):
1667
1811
  payload_type: The type of the provided payload. The payload can either be plain text, or
1668
1812
  Speech Synthesis Markup Language (SSML).
1669
1813
 
1814
+ region: Region where the conference data is located. Defaults to the region defined in
1815
+ user's data locality settings (Europe or US).
1816
+
1670
1817
  voice_settings: The settings associated with the voice selected
1671
1818
 
1672
1819
  extra_headers: Send extra headers
@@ -1689,6 +1836,7 @@ class AsyncActionsResource(AsyncAPIResource):
1689
1836
  "command_id": command_id,
1690
1837
  "language": language,
1691
1838
  "payload_type": payload_type,
1839
+ "region": region,
1692
1840
  "voice_settings": voice_settings,
1693
1841
  },
1694
1842
  action_speak_params.ActionSpeakParams,
@@ -1704,6 +1852,7 @@ class AsyncActionsResource(AsyncAPIResource):
1704
1852
  id: str,
1705
1853
  *,
1706
1854
  call_control_ids: SequenceNotStr[str] | Omit = omit,
1855
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
1707
1856
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
1708
1857
  # The extra values given here take precedence over values defined on the client or passed to this method.
1709
1858
  extra_headers: Headers | None = None,
@@ -1718,6 +1867,9 @@ class AsyncActionsResource(AsyncAPIResource):
1718
1867
  call_control_ids: List of call control ids identifying participants the audio file should stop be
1719
1868
  played to. If not given, the audio will be stoped to the entire conference.
1720
1869
 
1870
+ region: Region where the conference data is located. Defaults to the region defined in
1871
+ user's data locality settings (Europe or US).
1872
+
1721
1873
  extra_headers: Send extra headers
1722
1874
 
1723
1875
  extra_query: Add additional query parameters to the request
@@ -1731,7 +1883,11 @@ class AsyncActionsResource(AsyncAPIResource):
1731
1883
  return await self._post(
1732
1884
  f"/conferences/{id}/actions/stop",
1733
1885
  body=await async_maybe_transform(
1734
- {"call_control_ids": call_control_ids}, action_stop_params.ActionStopParams
1886
+ {
1887
+ "call_control_ids": call_control_ids,
1888
+ "region": region,
1889
+ },
1890
+ action_stop_params.ActionStopParams,
1735
1891
  ),
1736
1892
  options=make_request_options(
1737
1893
  extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -1744,6 +1900,7 @@ class AsyncActionsResource(AsyncAPIResource):
1744
1900
  id: str,
1745
1901
  *,
1746
1902
  call_control_ids: SequenceNotStr[str],
1903
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
1747
1904
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
1748
1905
  # The extra values given here take precedence over values defined on the client or passed to this method.
1749
1906
  extra_headers: Headers | None = None,
@@ -1758,6 +1915,9 @@ class AsyncActionsResource(AsyncAPIResource):
1758
1915
  call_control_ids: List of unique identifiers and tokens for controlling the call. Enter each call
1759
1916
  control ID to be unheld.
1760
1917
 
1918
+ region: Region where the conference data is located. Defaults to the region defined in
1919
+ user's data locality settings (Europe or US).
1920
+
1761
1921
  extra_headers: Send extra headers
1762
1922
 
1763
1923
  extra_query: Add additional query parameters to the request
@@ -1771,7 +1931,11 @@ class AsyncActionsResource(AsyncAPIResource):
1771
1931
  return await self._post(
1772
1932
  f"/conferences/{id}/actions/unhold",
1773
1933
  body=await async_maybe_transform(
1774
- {"call_control_ids": call_control_ids}, action_unhold_params.ActionUnholdParams
1934
+ {
1935
+ "call_control_ids": call_control_ids,
1936
+ "region": region,
1937
+ },
1938
+ action_unhold_params.ActionUnholdParams,
1775
1939
  ),
1776
1940
  options=make_request_options(
1777
1941
  extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -1784,6 +1948,7 @@ class AsyncActionsResource(AsyncAPIResource):
1784
1948
  id: str,
1785
1949
  *,
1786
1950
  call_control_ids: SequenceNotStr[str] | Omit = omit,
1951
+ region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
1787
1952
  # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
1788
1953
  # The extra values given here take precedence over values defined on the client or passed to this method.
1789
1954
  extra_headers: Headers | None = None,
@@ -1798,6 +1963,9 @@ class AsyncActionsResource(AsyncAPIResource):
1798
1963
  call_control_ids: List of unique identifiers and tokens for controlling the call. Enter each call
1799
1964
  control ID to be unmuted. When empty all participants will be unmuted.
1800
1965
 
1966
+ region: Region where the conference data is located. Defaults to the region defined in
1967
+ user's data locality settings (Europe or US).
1968
+
1801
1969
  extra_headers: Send extra headers
1802
1970
 
1803
1971
  extra_query: Add additional query parameters to the request
@@ -1811,7 +1979,11 @@ class AsyncActionsResource(AsyncAPIResource):
1811
1979
  return await self._post(
1812
1980
  f"/conferences/{id}/actions/unmute",
1813
1981
  body=await async_maybe_transform(
1814
- {"call_control_ids": call_control_ids}, action_unmute_params.ActionUnmuteParams
1982
+ {
1983
+ "call_control_ids": call_control_ids,
1984
+ "region": region,
1985
+ },
1986
+ action_unmute_params.ActionUnmuteParams,
1815
1987
  ),
1816
1988
  options=make_request_options(
1817
1989
  extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout