telnyx 3.3.0a0__py3-none-any.whl → 3.4.0__py3-none-any.whl

telnyx/types/oauth_client_update_response.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+from .oauth_client import OAuthClient
+
+__all__ = ["OAuthClientUpdateResponse"]
+
+
+class OAuthClientUpdateResponse(BaseModel):
+    data: Optional[OAuthClient] = None

telnyx/types/oauth_grant.py

@@ -0,0 +1,29 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["OAuthGrant"]
+
+
+class OAuthGrant(BaseModel):
+    id: str
+    """Unique identifier for the OAuth grant"""
+
+    client_id: str
+    """OAuth client identifier"""
+
+    created_at: datetime
+    """Timestamp when the grant was created"""
+
+    record_type: Literal["oauth_grant"]
+    """Record type identifier"""
+
+    scopes: List[str]
+    """List of granted OAuth scopes"""
+
+    last_used_at: Optional[datetime] = None
+    """Timestamp when the grant was last used"""

telnyx/types/oauth_grant_delete_response.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+from .oauth_grant import OAuthGrant
+
+__all__ = ["OAuthGrantDeleteResponse"]
+
+
+class OAuthGrantDeleteResponse(BaseModel):
+    data: Optional[OAuthGrant] = None

telnyx/types/oauth_grant_list_params.py

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["OAuthGrantListParams"]
+
+
+class OAuthGrantListParams(TypedDict, total=False):
+    page_number: Annotated[int, PropertyInfo(alias="page[number]")]
+    """Page number"""
+
+    page_size: Annotated[int, PropertyInfo(alias="page[size]")]
+    """Number of results per page"""

telnyx/types/oauth_grant_list_response.py

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+
+from .._models import BaseModel
+from .oauth_grant import OAuthGrant
+
+__all__ = ["OAuthGrantListResponse", "Meta"]
+
+
+class Meta(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"""
+
+
+class OAuthGrantListResponse(BaseModel):
+    data: Optional[List[OAuthGrant]] = None
+
+    meta: Optional[Meta] = None

telnyx/types/oauth_grant_retrieve_response.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+from .oauth_grant import OAuthGrant
+
+__all__ = ["OAuthGrantRetrieveResponse"]
+
+
+class OAuthGrantRetrieveResponse(BaseModel):
+    data: Optional[OAuthGrant] = None

telnyx/types/oauth_grants_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["OAuthGrantsParams"]
+
+
+class OAuthGrantsParams(TypedDict, total=False):
+    allowed: Required[bool]
+    """Whether the grant is allowed"""
+
+    consent_token: Required[str]
+    """Consent token"""

telnyx/types/oauth_grants_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["OAuthGrantsResponse"]
+
+
+class OAuthGrantsResponse(BaseModel):
+    redirect_uri: str
+    """Redirect URI with authorization code or error"""

telnyx/types/oauth_introspect_params.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["OAuthIntrospectParams"]
+
+
+class OAuthIntrospectParams(TypedDict, total=False):
+    token: Required[str]
+    """The token to introspect"""

telnyx/types/oauth_introspect_response.py

@@ -0,0 +1,30 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+
+__all__ = ["OAuthIntrospectResponse"]
+
+
+class OAuthIntrospectResponse(BaseModel):
+    active: bool
+    """Whether the token is active"""
+
+    aud: Optional[str] = None
+    """Audience"""
+
+    client_id: Optional[str] = None
+    """Client identifier"""
+
+    exp: Optional[int] = None
+    """Expiration timestamp"""
+
+    iat: Optional[int] = None
+    """Issued at timestamp"""
+
+    iss: Optional[str] = None
+    """Issuer"""
+
+    scope: Optional[str] = None
+    """Space-separated list of scopes"""

telnyx/types/oauth_register_params.py

@@ -0,0 +1,39 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List
+from typing_extensions import Literal, TypedDict
+
+from .._types import SequenceNotStr
+
+__all__ = ["OAuthRegisterParams"]
+
+
+class OAuthRegisterParams(TypedDict, total=False):
+    client_name: str
+    """Human-readable string name of the client to be presented to the end-user"""
+
+    grant_types: List[Literal["authorization_code", "client_credentials", "refresh_token"]]
+    """Array of OAuth 2.0 grant type strings that the client may use"""
+
+    logo_uri: str
+    """URL of the client logo"""
+
+    policy_uri: str
+    """URL of the client's privacy policy"""
+
+    redirect_uris: SequenceNotStr[str]
+    """Array of redirection URI strings for use in redirect-based flows"""
+
+    response_types: SequenceNotStr[str]
+    """Array of the OAuth 2.0 response type strings that the client may use"""
+
+    scope: str
+    """Space-separated string of scope values that the client may use"""
+
+    token_endpoint_auth_method: Literal["none", "client_secret_basic", "client_secret_post"]
+    """Authentication method for the token endpoint"""
+
+    tos_uri: str
+    """URL of the client's terms of service"""

telnyx/types/oauth_register_response.py

@@ -0,0 +1,45 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+
+from .._models import BaseModel
+
+__all__ = ["OAuthRegisterResponse"]
+
+
+class OAuthRegisterResponse(BaseModel):
+    client_id: str
+    """Unique client identifier"""
+
+    client_id_issued_at: int
+    """Unix timestamp of when the client ID was issued"""
+
+    client_name: Optional[str] = None
+    """Human-readable client name"""
+
+    client_secret: Optional[str] = None
+    """Client secret (only for confidential clients)"""
+
+    grant_types: Optional[List[str]] = None
+    """Array of allowed grant types"""
+
+    logo_uri: Optional[str] = None
+    """URL of the client logo"""
+
+    policy_uri: Optional[str] = None
+    """URL of the client's privacy policy"""
+
+    redirect_uris: Optional[List[str]] = None
+    """Array of redirection URIs"""
+
+    response_types: Optional[List[str]] = None
+    """Array of allowed response types"""
+
+    scope: Optional[str] = None
+    """Space-separated scope values"""
+
+    token_endpoint_auth_method: Optional[str] = None
+    """Token endpoint authentication method"""
+
+    tos_uri: Optional[str] = None
+    """URL of the client's terms of service"""

telnyx/types/oauth_retrieve_authorize_params.py

@@ -0,0 +1,30 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["OAuthRetrieveAuthorizeParams"]
+
+
+class OAuthRetrieveAuthorizeParams(TypedDict, total=False):
+    client_id: Required[str]
+    """OAuth client identifier"""
+
+    redirect_uri: Required[str]
+    """Redirect URI"""
+
+    response_type: Required[Literal["code"]]
+    """OAuth response type"""
+
+    code_challenge: str
+    """PKCE code challenge"""
+
+    code_challenge_method: Literal["plain", "S256"]
+    """PKCE code challenge method"""
+
+    scope: str
+    """Space-separated list of requested scopes"""
+
+    state: str
+    """State parameter for CSRF protection"""

telnyx/types/oauth_retrieve_jwks_response.py

@@ -0,0 +1,25 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+
+from .._models import BaseModel
+
+__all__ = ["OAuthRetrieveJwksResponse", "Key"]
+
+
+class Key(BaseModel):
+    alg: Optional[str] = None
+    """Algorithm"""
+
+    kid: Optional[str] = None
+    """Key ID"""
+
+    kty: Optional[str] = None
+    """Key type"""
+
+    use: Optional[str] = None
+    """Key use"""
+
+
+class OAuthRetrieveJwksResponse(BaseModel):
+    keys: Optional[List[Key]] = None

telnyx/types/oauth_retrieve_response.py

@@ -0,0 +1,47 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+
+from .._models import BaseModel
+
+__all__ = ["OAuthRetrieveResponse", "Data", "DataRequestedScope"]
+
+
+class DataRequestedScope(BaseModel):
+    id: Optional[str] = None
+    """Scope ID"""
+
+    description: Optional[str] = None
+    """Scope description"""
+
+    name: Optional[str] = None
+    """Scope name"""
+
+
+class Data(BaseModel):
+    client_id: Optional[str] = None
+    """Client ID"""
+
+    logo_uri: Optional[str] = None
+    """URL of the client logo"""
+
+    name: Optional[str] = None
+    """Client name"""
+
+    policy_uri: Optional[str] = None
+    """URL of the client's privacy policy"""
+
+    redirect_uri: Optional[str] = None
+    """The redirect URI for this authorization"""
+
+    requested_scopes: Optional[List[DataRequestedScope]] = None
+
+    tos_uri: Optional[str] = None
+    """URL of the client's terms of service"""
+
+    verified: Optional[bool] = None
+    """Whether the client is verified"""
+
+
+class OAuthRetrieveResponse(BaseModel):
+    data: Optional[Data] = None

telnyx/types/oauth_token_params.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["OAuthTokenParams"]
+
+
+class OAuthTokenParams(TypedDict, total=False):
+    grant_type: Required[Literal["client_credentials", "authorization_code", "refresh_token"]]
+    """OAuth 2.0 grant type"""
+
+    client_id: str
+    """OAuth client ID (if not using HTTP Basic auth)"""
+
+    client_secret: str
+    """OAuth client secret (if not using HTTP Basic auth)"""
+
+    code: str
+    """Authorization code (for authorization_code flow)"""
+
+    code_verifier: str
+    """PKCE code verifier (for authorization_code flow)"""
+
+    redirect_uri: str
+    """Redirect URI (for authorization_code flow)"""
+
+    refresh_token: str
+    """Refresh token (for refresh_token flow)"""
+
+    scope: str
+    """Space-separated list of requested scopes (for client_credentials)"""

telnyx/types/oauth_token_response.py

@@ -0,0 +1,25 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["OAuthTokenResponse"]
+
+
+class OAuthTokenResponse(BaseModel):
+    access_token: str
+    """The access token"""
+
+    expires_in: int
+    """Token lifetime in seconds"""
+
+    token_type: Literal["Bearer"]
+    """Token type"""
+
+    refresh_token: Optional[str] = None
+    """Refresh token (if applicable)"""
+
+    scope: Optional[str] = None
+    """Space-separated list of granted scopes"""

telnyx/types/outbound_call_recording_param.py

@@ -2,14 +2,15 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import Literal, TypedDict
 
+from .._types import SequenceNotStr
+
 __all__ = ["OutboundCallRecordingParam"]
 
 
 class OutboundCallRecordingParam(TypedDict, total=False):
-    call_recording_caller_phone_numbers: List[str]
+    call_recording_caller_phone_numbers: SequenceNotStr[str]
     """
     When call_recording_type is 'by_caller_phone_number', only outbound calls using
     one of these numbers will be recorded. Numbers must be specified in E164 format.

telnyx/types/outbound_voice_profile_create_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List, Optional
+from typing import Optional
 from typing_extensions import Required, TypedDict
 
+from .._types import SequenceNotStr
 from .service_plan import ServicePlan
 from .traffic_type import TrafficType
 from .usage_payment_method import UsagePaymentMethod
@@ -56,7 +57,7 @@ class OutboundVoiceProfileCreateParams(TypedDict, total=False):
     service_plan: ServicePlan
     """Indicates the coverage of the termination regions."""
 
-    tags: List[str]
+    tags: SequenceNotStr[str]
 
     traffic_type: TrafficType
     """Specifies the type of traffic allowed in this profile."""
@@ -64,7 +65,7 @@ class OutboundVoiceProfileCreateParams(TypedDict, total=False):
     usage_payment_method: UsagePaymentMethod
     """Setting for how costs for outbound profile are calculated."""
 
-    whitelisted_destinations: List[str]
+    whitelisted_destinations: SequenceNotStr[str]
     """
     The list of destinations you want to be able to call using this outbound voice
     profile formatted in alpha2.

telnyx/types/outbound_voice_profile_update_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List, Optional
+from typing import Optional
 from typing_extensions import Required, TypedDict
 
+from .._types import SequenceNotStr
 from .service_plan import ServicePlan
 from .traffic_type import TrafficType
 from .usage_payment_method import UsagePaymentMethod
@@ -56,7 +57,7 @@ class OutboundVoiceProfileUpdateParams(TypedDict, total=False):
     service_plan: ServicePlan
     """Indicates the coverage of the termination regions."""
 
-    tags: List[str]
+    tags: SequenceNotStr[str]
 
     traffic_type: TrafficType
     """Specifies the type of traffic allowed in this profile."""
@@ -64,7 +65,7 @@ class OutboundVoiceProfileUpdateParams(TypedDict, total=False):
     usage_payment_method: UsagePaymentMethod
     """Setting for how costs for outbound profile are calculated."""
 
-    whitelisted_destinations: List[str]
+    whitelisted_destinations: SequenceNotStr[str]
     """
     The list of destinations you want to be able to call using this outbound voice
     profile formatted in alpha2.

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

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List, Union
+from typing import Union
 from typing_extensions import Literal, Annotated, TypedDict
 
+from .._types import SequenceNotStr
 from .._utils import PropertyInfo
 
 __all__ = ["PhoneNumberListParams", "Filter", "FilterNumberType", "FilterVoiceConnectionName", "Page"]
@@ -64,7 +65,7 @@ class Filter(TypedDict, total=False):
     connection_id: str
     """Filter by connection_id."""
 
-    country_iso_alpha2: Union[str, List[str]]
+    country_iso_alpha2: Union[str, SequenceNotStr[str]]
     """Filter by phone number country ISO alpha-2 code.
 
     Can be a single value or an array of values.
@@ -121,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_number_slim_list_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List, Union
+from typing import Union
 from typing_extensions import Literal, Annotated, TypedDict
 
+from .._types import SequenceNotStr
 from .._utils import PropertyInfo
 
 __all__ = ["PhoneNumberSlimListParams", "Filter", "FilterNumberType", "FilterVoiceConnectionName", "Page"]
@@ -79,7 +80,7 @@ class Filter(TypedDict, total=False):
     connection_id: str
     """Filter by connection_id."""
 
-    country_iso_alpha2: Union[str, List[str]]
+    country_iso_alpha2: Union[str, SequenceNotStr[str]]
     """Filter by phone number country ISO alpha-2 code.
 
     Can be a single value or an array of values.

telnyx/types/phone_number_update_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import TypedDict
 
+from .._types import SequenceNotStr
+
 __all__ = ["PhoneNumberUpdateParams"]
 
 
@@ -29,5 +30,5 @@ class PhoneNumberUpdateParams(TypedDict, total=False):
     hd_voice_enabled: bool
     """Indicates whether HD voice is enabled for this number."""
 
-    tags: List[str]
+    tags: SequenceNotStr[str]
     """A list of user-assigned tags to help organize phone numbers."""

telnyx/types/phone_numbers/action_verify_ownership_params.py

@@ -2,12 +2,13 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import Required, TypedDict
 
+from ..._types import SequenceNotStr
+
 __all__ = ["ActionVerifyOwnershipParams"]
 
 
 class ActionVerifyOwnershipParams(TypedDict, total=False):
-    phone_numbers: Required[List[str]]
+    phone_numbers: Required[SequenceNotStr[str]]
     """Array of phone numbers to verify ownership for"""

telnyx/types/phone_numbers/job_delete_batch_params.py

@@ -2,11 +2,12 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import Required, TypedDict
 
+from ..._types import SequenceNotStr
+
 __all__ = ["JobDeleteBatchParams"]
 
 
 class JobDeleteBatchParams(TypedDict, total=False):
-    phone_numbers: Required[List[str]]
+    phone_numbers: Required[SequenceNotStr[str]]