telnyx 3.5.0a0__py3-none-any.whl → 3.6.0__py3-none-any.whl

telnyx/types/outbound_voice_profile.py

@@ -8,7 +8,27 @@ from .traffic_type import TrafficType
 from .usage_payment_method import UsagePaymentMethod
 from .outbound_call_recording import OutboundCallRecording
 
-__all__ = ["OutboundVoiceProfile"]
+__all__ = ["OutboundVoiceProfile", "CallingWindow"]
+
+
+class CallingWindow(BaseModel):
+    calls_per_cld: Optional[int] = None
+    """
+    (BETA) The maximum number of calls that can be initiated to a single called
+    party (CLD) within the calling window. A null value means no limit.
+    """
+
+    end_time: Optional[str] = None
+    """
+    (BETA) The UTC time of day (in HH:MM format, 24-hour clock) when calls are no
+    longer allowed to start.
+    """
+
+    start_time: Optional[str] = None
+    """
+    (BETA) The UTC time of day (in HH:MM format, 24-hour clock) when calls are
+    allowed to start.
+    """
 
 
 class OutboundVoiceProfile(BaseModel):
@@ -26,6 +46,12 @@ class OutboundVoiceProfile(BaseModel):
 
     call_recording: Optional[OutboundCallRecording] = None
 
+    calling_window: Optional[CallingWindow] = None
+    """
+    (BETA) Specifies the time window and call limits for calls made using this
+    outbound voice profile. Note that all times are UTC in 24-hour clock time.
+    """
+
     concurrent_call_limit: Optional[int] = None
     """Must be no more than your global concurrent call limit. Null means no limit."""
 

telnyx/types/outbound_voice_profile_create_params.py

@@ -11,7 +11,7 @@ from .traffic_type import TrafficType
 from .usage_payment_method import UsagePaymentMethod
 from .outbound_call_recording_param import OutboundCallRecordingParam
 
-__all__ = ["OutboundVoiceProfileCreateParams"]
+__all__ = ["OutboundVoiceProfileCreateParams", "CallingWindow"]
 
 
 class OutboundVoiceProfileCreateParams(TypedDict, total=False):
@@ -26,6 +26,12 @@ class OutboundVoiceProfileCreateParams(TypedDict, total=False):
 
     call_recording: OutboundCallRecordingParam
 
+    calling_window: CallingWindow
+    """
+    (BETA) Specifies the time window and call limits for calls made using this
+    outbound voice profile. Note that all times are UTC in 24-hour clock time.
+    """
+
     concurrent_call_limit: Optional[int]
     """Must be no more than your global concurrent call limit. Null means no limit."""
 
@@ -70,3 +76,23 @@ class OutboundVoiceProfileCreateParams(TypedDict, total=False):
     The list of destinations you want to be able to call using this outbound voice
     profile formatted in alpha2.
     """
+
+
+class CallingWindow(TypedDict, total=False):
+    calls_per_cld: int
+    """
+    (BETA) The maximum number of calls that can be initiated to a single called
+    party (CLD) within the calling window. A null value means no limit.
+    """
+
+    end_time: str
+    """
+    (BETA) The UTC time of day (in HH:MM format, 24-hour clock) when calls are no
+    longer allowed to start.
+    """
+
+    start_time: str
+    """
+    (BETA) The UTC time of day (in HH:MM format, 24-hour clock) when calls are
+    allowed to start.
+    """

telnyx/types/outbound_voice_profile_list_params.py

@@ -17,7 +17,7 @@ class OutboundVoiceProfileListParams(TypedDict, total=False):
     page: Page
     """Consolidated page parameter (deepObject style).
 
-    Originally: page[number], page[size]
+    Originally: page[size], page[number]
     """
 
     sort: Literal[

telnyx/types/outbound_voice_profile_update_params.py

@@ -11,7 +11,7 @@ from .traffic_type import TrafficType
 from .usage_payment_method import UsagePaymentMethod
 from .outbound_call_recording_param import OutboundCallRecordingParam
 
-__all__ = ["OutboundVoiceProfileUpdateParams"]
+__all__ = ["OutboundVoiceProfileUpdateParams", "CallingWindow"]
 
 
 class OutboundVoiceProfileUpdateParams(TypedDict, total=False):
@@ -26,6 +26,12 @@ class OutboundVoiceProfileUpdateParams(TypedDict, total=False):
 
     call_recording: OutboundCallRecordingParam
 
+    calling_window: CallingWindow
+    """
+    (BETA) Specifies the time window and call limits for calls made using this
+    outbound voice profile.
+    """
+
     concurrent_call_limit: Optional[int]
     """Must be no more than your global concurrent call limit. Null means no limit."""
 
@@ -70,3 +76,23 @@ class OutboundVoiceProfileUpdateParams(TypedDict, total=False):
     The list of destinations you want to be able to call using this outbound voice
     profile formatted in alpha2.
     """
+
+
+class CallingWindow(TypedDict, total=False):
+    calls_per_cld: int
+    """
+    (BETA) The maximum number of calls that can be initiated to a single called
+    party (CLD) within the calling window. A null value means no limit.
+    """
+
+    end_time: str
+    """
+    (BETA) The UTC time of day (in HH:MM format, 24-hour clock) when calls are no
+    longer allowed to start.
+    """
+
+    start_time: str
+    """
+    (BETA) The UTC time of day (in HH:MM format, 24-hour clock) when calls are
+    allowed to start.
+    """

telnyx/types/pagination_meta_cloudflare_ip_list_sync.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["PaginationMetaCloudflareIPListSync"]
+
+
+class PaginationMetaCloudflareIPListSync(BaseModel):
+    page_number: int
+
+    page_size: int
+
+    total_pages: int
+
+    total_results: int

telnyx/types/pagination_meta_oauth.py

@@ -0,0 +1,21 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+
+__all__ = ["PaginationMetaOAuth"]
+
+
+class PaginationMetaOAuth(BaseModel):
+    page_number: Optional[int] = None
+    """Current page number"""
+
+    page_size: Optional[int] = None
+    """Number of items per page"""
+
+    total_pages: Optional[int] = None
+    """Total number of pages"""
+
+    total_results: Optional[int] = None
+    """Total number of results"""

telnyx/types/phone_number_blocks/__init__.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from .job import Job as Job
+from .job_error import JobError as JobError
 from .job_list_params import JobListParams as JobListParams
 from .job_list_response import JobListResponse as JobListResponse
 from .job_retrieve_response import JobRetrieveResponse as JobRetrieveResponse

telnyx/types/phone_number_blocks/job.py

@@ -5,47 +5,16 @@ from datetime import datetime
 from typing_extensions import Literal
 
 from ..._models import BaseModel
+from .job_error import JobError
 
-__all__ = [
-    "Job",
-    "FailedOperation",
-    "FailedOperationError",
-    "FailedOperationErrorMeta",
-    "FailedOperationErrorSource",
-    "SuccessfulOperation",
-]
-
-
-class FailedOperationErrorMeta(BaseModel):
-    url: Optional[str] = None
-    """URL with additional information on the error."""
-
-
-class FailedOperationErrorSource(BaseModel):
-    parameter: Optional[str] = None
-    """Indicates which query parameter caused the error."""
-
-    pointer: Optional[str] = None
-    """JSON pointer (RFC6901) to the offending entity."""
-
-
-class FailedOperationError(BaseModel):
-    code: str
-
-    title: str
-
-    detail: Optional[str] = None
-
-    meta: Optional[FailedOperationErrorMeta] = None
-
-    source: Optional[FailedOperationErrorSource] = None
+__all__ = ["Job", "FailedOperation", "SuccessfulOperation"]
 
 
 class FailedOperation(BaseModel):
     id: Optional[str] = None
     """The phone number's ID"""
 
-    errors: Optional[List[FailedOperationError]] = None
+    errors: Optional[List[JobError]] = None
 
     phone_number: Optional[str] = None
     """The phone number in e164 format."""

telnyx/types/phone_number_blocks/job_error.py

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["JobError", "Meta", "Source"]
+
+
+class Meta(BaseModel):
+    url: Optional[str] = None
+    """URL with additional information on the error."""
+
+
+class Source(BaseModel):
+    parameter: Optional[str] = None
+    """Indicates which query parameter caused the error."""
+
+    pointer: Optional[str] = None
+    """JSON pointer (RFC6901) to the offending entity."""
+
+
+class JobError(BaseModel):
+    code: str
+
+    title: str
+
+    detail: Optional[str] = None
+
+    meta: Optional[Meta] = None
+
+    source: Optional[Source] = None

telnyx/types/phone_number_delete_response.py

@@ -49,6 +49,13 @@ class Data(BaseModel):
     customer_reference: Optional[str] = None
     """A customer reference string for customer look ups."""
 
+    deletion_lock_enabled: Optional[bool] = None
+    """Indicates whether deletion lock is enabled for this number.
+
+    When enabled, this prevents the phone number from being deleted via the API or
+    Telnyx portal.
+    """
+
     emergency_address_id: Optional[str] = None
     """Identifies the emergency address associated with the phone number."""
 

telnyx/types/phone_number_detailed.py

@@ -49,6 +49,13 @@ class PhoneNumberDetailed(BaseModel):
     customer_reference: Optional[str] = None
     """A customer reference string for customer look ups."""
 
+    deletion_lock_enabled: Optional[bool] = None
+    """Indicates whether deletion lock is enabled for this number.
+
+    When enabled, this prevents the phone number from being deleted via the API or
+    Telnyx portal.
+    """
+
     emergency_address_id: Optional[str] = None
     """Identifies the emergency address associated with the phone number."""
 

telnyx/types/phone_number_list_params.py

@@ -122,6 +122,12 @@ class Filter(TypedDict, total=False):
     ]
     """Filter by usage_payment_method."""
 
+    without_tags: Literal["true", "false"]
+    """When set to 'true', filters for phone numbers that do not have any tags applied.
+
+    All other values are ignored.
+    """
+
 
 class Page(TypedDict, total=False):
     number: int

telnyx/types/phone_numbers/job_update_batch_params.py

@@ -39,6 +39,13 @@ class JobUpdateBatchParams(TypedDict, total=False):
     customer_reference: str
     """A customer reference string for customer look ups."""
 
+    deletion_lock_enabled: bool
+    """Indicates whether to enable or disable the deletion lock on each phone number.
+
+    When enabled, this prevents the phone number from being deleted via the API or
+    Telnyx portal.
+    """
+
     external_pin: str
     """
     If someone attempts to port your phone number away from Telnyx and your phone

telnyx/types/phone_numbers/phone_numbers_job.py

@@ -5,49 +5,16 @@ from datetime import datetime
 from typing_extensions import Literal
 
 from ..._models import BaseModel
+from ..phone_number_blocks.job_error import JobError
 
-__all__ = [
-    "PhoneNumbersJob",
-    "FailedOperation",
-    "FailedOperationError",
-    "FailedOperationErrorMeta",
-    "FailedOperationErrorSource",
-    "PendingOperation",
-    "PhoneNumber",
-    "SuccessfulOperation",
-]
-
-
-class FailedOperationErrorMeta(BaseModel):
-    url: Optional[str] = None
-    """URL with additional information on the error."""
-
-
-class FailedOperationErrorSource(BaseModel):
-    parameter: Optional[str] = None
-    """Indicates which query parameter caused the error."""
-
-    pointer: Optional[str] = None
-    """JSON pointer (RFC6901) to the offending entity."""
-
-
-class FailedOperationError(BaseModel):
-    code: str
-
-    title: str
-
-    detail: Optional[str] = None
-
-    meta: Optional[FailedOperationErrorMeta] = None
-
-    source: Optional[FailedOperationErrorSource] = None
+__all__ = ["PhoneNumbersJob", "FailedOperation", "PendingOperation", "PhoneNumber", "SuccessfulOperation"]
 
 
 class FailedOperation(BaseModel):
     id: Optional[str] = None
     """The phone number's ID"""
 
-    errors: Optional[List[FailedOperationError]] = None
+    errors: Optional[List[JobError]] = None
 
     phone_number: Optional[str] = None
     """The phone number in e164 format."""

telnyx/types/porting_order.py

@@ -33,6 +33,9 @@ class PortingOrder(BaseModel):
     created_at: Optional[datetime] = None
     """ISO 8601 formatted date indicating when the resource was created."""
 
+    customer_group_reference: Optional[str] = None
+    """A customer-specified group reference for customer bookkeeping purposes"""
+
     customer_reference: Optional[str] = None
     """A customer-specified reference number for customer bookkeeping purposes"""
 

telnyx/types/porting_order_create_params.py

@@ -13,5 +13,8 @@ class PortingOrderCreateParams(TypedDict, total=False):
     phone_numbers: Required[SequenceNotStr[str]]
     """The list of +E.164 formatted phone numbers"""
 
+    customer_group_reference: str
+    """A customer-specified group reference for customer bookkeeping purposes"""
+
     customer_reference: str
     """A customer-specified reference number for customer bookkeeping purposes"""

telnyx/types/porting_order_list_params.py

@@ -2,15 +2,19 @@
 
 from __future__ import annotations
 
-from typing_extensions import Literal, Annotated, TypedDict
+from typing_extensions import Literal, TypedDict
 
-from .._utils import PropertyInfo
 from .porting_order_type import PortingOrderType
 
 __all__ = [
     "PortingOrderListParams",
     "Filter",
+    "FilterActivationSettings",
     "FilterActivationSettingsFocDatetimeRequested",
+    "FilterEndUser",
+    "FilterEndUserAdmin",
+    "FilterMisc",
+    "FilterPhoneNumbers",
     "FilterPhoneNumbersPhoneNumber",
     "Page",
     "Sort",
@@ -21,10 +25,10 @@ class PortingOrderListParams(TypedDict, total=False):
     filter: Filter
     """Consolidated filter parameter (deepObject style).
 
-    Originally: filter[customer_reference], filter[parent_support_key],
-    filter[phone_numbers.country_code], filter[phone_numbers.carrier_name],
-    filter[misc.type], filter[end_user.admin.entity_name],
-    filter[end_user.admin.auth_person_name],
+    Originally: filter[customer_reference], filter[customer_group_reference],
+    filter[parent_support_key], filter[phone_numbers.country_code],
+    filter[phone_numbers.carrier_name], filter[misc.type],
+    filter[end_user.admin.entity_name], filter[end_user.admin.auth_person_name],
     filter[activation_settings.fast_port_eligible],
     filter[activation_settings.foc_datetime_requested][gt],
     filter[activation_settings.foc_datetime_requested][lt],
@@ -52,47 +56,64 @@ class FilterActivationSettingsFocDatetimeRequested(TypedDict, total=False):
     """Filter results by foc date earlier than this value"""
 
 
-class FilterPhoneNumbersPhoneNumber(TypedDict, total=False):
-    contains: str
-    """Filter results by full or partial phone_number"""
-
-
-class Filter(TypedDict, total=False):
-    activation_settings_fast_port_eligible: Annotated[
-        bool, PropertyInfo(alias="activation_settings.fast_port_eligible")
-    ]
+class FilterActivationSettings(TypedDict, total=False):
+    fast_port_eligible: bool
     """Filter results by fast port eligible"""
 
-    activation_settings_foc_datetime_requested: Annotated[
-        FilterActivationSettingsFocDatetimeRequested, PropertyInfo(alias="activation_settings.foc_datetime_requested")
-    ]
+    foc_datetime_requested: FilterActivationSettingsFocDatetimeRequested
     """FOC datetime range filtering operations"""
 
-    customer_reference: str
-    """Filter results by customer_reference"""
 
-    end_user_admin_auth_person_name: Annotated[str, PropertyInfo(alias="end_user.admin.auth_person_name")]
+class FilterEndUserAdmin(TypedDict, total=False):
+    auth_person_name: str
     """Filter results by authorized person"""
 
-    end_user_admin_entity_name: Annotated[str, PropertyInfo(alias="end_user.admin.entity_name")]
+    entity_name: str
     """Filter results by person or company name"""
 
-    misc_type: Annotated[PortingOrderType, PropertyInfo(alias="misc.type")]
+
+class FilterEndUser(TypedDict, total=False):
+    admin: FilterEndUserAdmin
+
+
+class FilterMisc(TypedDict, total=False):
+    type: PortingOrderType
     """Filter results by porting order type"""
 
-    parent_support_key: str
-    """Filter results by parent_support_key"""
 
-    phone_numbers_carrier_name: Annotated[str, PropertyInfo(alias="phone_numbers.carrier_name")]
+class FilterPhoneNumbersPhoneNumber(TypedDict, total=False):
+    contains: str
+    """Filter results by full or partial phone_number"""
+
+
+class FilterPhoneNumbers(TypedDict, total=False):
+    carrier_name: str
     """Filter results by old service provider"""
 
-    phone_numbers_country_code: Annotated[str, PropertyInfo(alias="phone_numbers.country_code")]
+    country_code: str
     """Filter results by country ISO 3166-1 alpha-2 code"""
 
-    phone_numbers_phone_number: Annotated[
-        FilterPhoneNumbersPhoneNumber, PropertyInfo(alias="phone_numbers.phone_number")
-    ]
-    """Phone number filtering operations"""
+    phone_number: FilterPhoneNumbersPhoneNumber
+    """Phone number pattern filtering operations"""
+
+
+class Filter(TypedDict, total=False):
+    activation_settings: FilterActivationSettings
+
+    customer_group_reference: str
+    """Filter results by customer_group_reference"""
+
+    customer_reference: str
+    """Filter results by customer_reference"""
+
+    end_user: FilterEndUser
+
+    misc: FilterMisc
+
+    parent_support_key: str
+    """Filter results by parent_support_key"""
+
+    phone_numbers: FilterPhoneNumbers
 
 
 class Page(TypedDict, total=False):

telnyx/types/porting_order_update_params.py

@@ -19,6 +19,8 @@ __all__ = ["PortingOrderUpdateParams", "ActivationSettings", "Messaging", "Requi
 class PortingOrderUpdateParams(TypedDict, total=False):
     activation_settings: ActivationSettings
 
+    customer_group_reference: str
+
     customer_reference: str
 
     documents: PortingOrderDocumentsParam

telnyx/types/porting_orders/phone_number_configuration_list_params.py

@@ -3,12 +3,11 @@
 from __future__ import annotations
 
 from typing import List
-from typing_extensions import Literal, Annotated, TypedDict
+from typing_extensions import Literal, TypedDict
 
 from ..._types import SequenceNotStr
-from ..._utils import PropertyInfo
 
-__all__ = ["PhoneNumberConfigurationListParams", "Filter", "Page", "Sort"]
+__all__ = ["PhoneNumberConfigurationListParams", "Filter", "FilterPortingOrder", "Page", "Sort"]
 
 
 class PhoneNumberConfigurationListParams(TypedDict, total=False):
@@ -29,25 +28,26 @@ class PhoneNumberConfigurationListParams(TypedDict, total=False):
     """Consolidated sort parameter (deepObject style). Originally: sort[value]"""
 
 
-class Filter(TypedDict, total=False):
-    porting_order_status: Annotated[
-        List[
-            Literal[
-                "activation-in-progress",
-                "cancel-pending",
-                "cancelled",
-                "draft",
-                "exception",
-                "foc-date-confirmed",
-                "in-process",
-                "ported",
-                "submitted",
-            ]
-        ],
-        PropertyInfo(alias="porting_order.status"),
+class FilterPortingOrder(TypedDict, total=False):
+    status: List[
+        Literal[
+            "activation-in-progress",
+            "cancel-pending",
+            "cancelled",
+            "draft",
+            "exception",
+            "foc-date-confirmed",
+            "in-process",
+            "ported",
+            "submitted",
+        ]
     ]
     """Filter results by specific porting order statuses"""
 
+
+class Filter(TypedDict, total=False):
+    porting_order: FilterPortingOrder
+
     porting_phone_number: SequenceNotStr[str]
     """Filter results by a list of porting phone number IDs"""
 

telnyx/types/report_list_mdrs_response.py

@@ -5,8 +5,9 @@ from datetime import datetime
 from typing_extensions import Literal
 
 from .._models import BaseModel
+from .reports.pagination_meta_reporting import PaginationMetaReporting
 
-__all__ = ["ReportListMdrsResponse", "Data", "Meta"]
+__all__ = ["ReportListMdrsResponse", "Data"]
 
 
 class Data(BaseModel):
@@ -58,17 +59,7 @@ class Data(BaseModel):
     """Message status"""
 
 
-class Meta(BaseModel):
-    page_number: Optional[int] = None
-
-    page_size: Optional[int] = None
-
-    total_pages: Optional[int] = None
-
-    total_results: Optional[int] = None
-
-
 class ReportListMdrsResponse(BaseModel):
     data: Optional[List[Data]] = None
 
-    meta: Optional[Meta] = None
+    meta: Optional[PaginationMetaReporting] = None

telnyx/types/reports/__init__.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from .mdr_usage_report import MdrUsageReport as MdrUsageReport
+from .pagination_meta_reporting import PaginationMetaReporting as PaginationMetaReporting
 from .mdr_usage_report_list_params import MdrUsageReportListParams as MdrUsageReportListParams
 from .mdr_usage_report_create_params import MdrUsageReportCreateParams as MdrUsageReportCreateParams
 from .mdr_usage_report_list_response import MdrUsageReportListResponse as MdrUsageReportListResponse

telnyx/types/reports/mdr_usage_report_list_response.py

@@ -4,21 +4,12 @@ from typing import List, Optional
 
 from ..._models import BaseModel
 from .mdr_usage_report import MdrUsageReport
+from .pagination_meta_reporting import PaginationMetaReporting
 
-__all__ = ["MdrUsageReportListResponse", "Meta"]
-
-
-class Meta(BaseModel):
-    page_number: Optional[int] = None
-
-    page_size: Optional[int] = None
-
-    total_pages: Optional[int] = None
-
-    total_results: Optional[int] = None
+__all__ = ["MdrUsageReportListResponse"]
 
 
 class MdrUsageReportListResponse(BaseModel):
     data: Optional[List[MdrUsageReport]] = None
 
-    meta: Optional[Meta] = None
+    meta: Optional[PaginationMetaReporting] = None