release: 3.1.0-alpha (#94)

* chore: update github action

* codegen metadata

* codegen metadata

* feat: AISWE-429: Upgrade porting customer_service_record OpenAPI to 3.1 with Standard Webhooks

* codegen metadata

* codegen metadata

* feat: port-4315: add filter by country code

* chore(internal): change ci workflow machines

* feat(api): rename Error to MessagesError

* feat: AISWE-429: Upgrade messaging 10dlc OpenAPI to 3.1 with Standard Webhooks

* feat: AISWE-429: Upgrade messaging messaging OpenAPI to 3.1 with Standard Webhooks

* feat: AISWE-429: Upgrade programmable-fax programmable-fax OpenAPI to 3.1 with Standard Webhooks

* feat: port-4315: add country_code filter to description

* feat: AISWE-429: Upgrade call-control call-control OpenAPI to 3.1 with Standard Webhooks

* fix: avoid newer type syntax

* chore(internal): update pyright exclude list

* feat: NUM-6108: Update Advanced Order API reference to include requirement_groups

* feat: AISWE-429: Upgrade numbers numbers OpenAPI to 3.1 with Standard Webhooks

* release: 3.1.0-alpha

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -36,13 +36,13 @@ jobs:
         run: ./scripts/lint
 
   build:
-    if: github.repository == 'stainless-sdks/telnyx-python' && (github.event_name == 'push' || github.event.pull_request.head.repo.fork)
+    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     timeout-minutes: 10
     name: build
     permissions:
       contents: read
       id-token: write
-    runs-on: depot-ubuntu-24.04
+    runs-on: ${{ github.repository == 'stainless-sdks/telnyx-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     steps:
       - uses: actions/checkout@v4
 
@@ -61,12 +61,14 @@ jobs:
         run: rye build
 
       - name: Get GitHub OIDC Token
+        if: github.repository == 'stainless-sdks/telnyx-python'
         id: github-oidc
         uses: actions/github-script@v6
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
       - name: Upload tarball
+        if: github.repository == 'stainless-sdks/telnyx-python'
         env:
           URL: https://pkg.stainless.com/s
           AUTH: ${{ steps.github-oidc.outputs.github_token }}

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "3.0.0-alpha"
+  ".": "3.1.0-alpha"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 799
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/telnyx%2Ftelnyx-66f54879a0b9030d7c537924e1d2ea96445b49d214254da567e15293d2363d41.yml
-openapi_spec_hash: 3fe88315a74c8d3e044b8ae32ffe931e
-config_hash: cfebf6bd2ce8bd116d0eedc0d4a600f0
+configured_endpoints: 800
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/telnyx%2Ftelnyx-40a540682e7307b506c6d48ed7fc93b2751075b37276bbf6d1871415abc701a4.yml
+openapi_spec_hash: 2d2c92c05002d51217cb901152d4439a
+config_hash: 042e8a6e781fd484663a6c2142daaae5

CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 3.1.0-alpha (2025-08-27)
+
+Full Changelog: [v3.0.0-alpha...v3.1.0-alpha](https://github.com/team-telnyx/telnyx-python/compare/v3.0.0-alpha...v3.1.0-alpha)
+
+### Features
+
+* AISWE-429: Upgrade call-control call-control OpenAPI to 3.1 with Standard Webhooks ([c6498e6](https://github.com/team-telnyx/telnyx-python/commit/c6498e6e628c19175191de0092ba897c69318d0d))
+* AISWE-429: Upgrade messaging 10dlc OpenAPI to 3.1 with Standard Webhooks ([e0cf35f](https://github.com/team-telnyx/telnyx-python/commit/e0cf35f4d12d8f24e26dab02909e238c02d22465))
+* AISWE-429: Upgrade messaging messaging OpenAPI to 3.1 with Standard Webhooks ([c005985](https://github.com/team-telnyx/telnyx-python/commit/c005985aaacf9a41cf889bf15e6eb40d1a773e44))
+* AISWE-429: Upgrade numbers numbers OpenAPI to 3.1 with Standard Webhooks ([9448fc5](https://github.com/team-telnyx/telnyx-python/commit/9448fc586b6de3896cfacc01f4153650c3cd0d2b))
+* AISWE-429: Upgrade porting customer_service_record OpenAPI to 3.1 with Standard Webhooks ([ea07f5c](https://github.com/team-telnyx/telnyx-python/commit/ea07f5c8688b990d4890f28e377ec20074993ace))
+* AISWE-429: Upgrade programmable-fax programmable-fax OpenAPI to 3.1 with Standard Webhooks ([0ce7e38](https://github.com/team-telnyx/telnyx-python/commit/0ce7e38f1a87f45e1a60570322bae101b8646286))
+* **api:** rename Error to MessagesError ([ac58be4](https://github.com/team-telnyx/telnyx-python/commit/ac58be4181157fce47ac0bbc077dc2f0b73985e8))
+* NUM-6108: Update Advanced Order API reference to include requirement_groups ([d0cc66f](https://github.com/team-telnyx/telnyx-python/commit/d0cc66f4a4faa41a557cf3b27d30f465f724dcd4))
+* port-4315: add country_code filter to description ([7f7b678](https://github.com/team-telnyx/telnyx-python/commit/7f7b678b435cab29addaaff865275d9d0f0ffed7))
+* port-4315: add filter by country code ([920c561](https://github.com/team-telnyx/telnyx-python/commit/920c561527177a01119fb4c542227d2cfff02998))
+
+
+### Bug Fixes
+
+* avoid newer type syntax ([1f4d346](https://github.com/team-telnyx/telnyx-python/commit/1f4d346115cbe1f985e9f711716d47c891487440))
+
+
+### Chores
+
+* **internal:** change ci workflow machines ([c87408f](https://github.com/team-telnyx/telnyx-python/commit/c87408f180f76257a61fcbfc173d3ddc1890be8d))
+* **internal:** update pyright exclude list ([4863f67](https://github.com/team-telnyx/telnyx-python/commit/4863f67905e609ceb919323d86802c69bad660f8))
+* update github action ([f445c07](https://github.com/team-telnyx/telnyx-python/commit/f445c07c8a4e60a8c61b24925f0545b0bdd8f074))
+
 ## 3.0.0-alpha (2025-08-18)
 
 Full Changelog: [v0.0.1...v3.0.0-alpha](https://github.com/team-telnyx/telnyx-python/compare/v0.0.1...v3.0.0-alpha)

api.md

@@ -134,6 +134,7 @@ Methods:
 
 - <code title="post /advanced_orders">client.advanced_orders.<a href="./src/telnyx/resources/advanced_orders.py">create</a>(\*\*<a href="src/telnyx/types/advanced_order_create_params.py">params</a>) -> object</code>
 - <code title="get /advanced_orders/{order_id}">client.advanced_orders.<a href="./src/telnyx/resources/advanced_orders.py">retrieve</a>(order_id) -> object</code>
+- <code title="patch /advanced_orders/{order_id}">client.advanced_orders.<a href="./src/telnyx/resources/advanced_orders.py">update</a>(order_id, \*\*<a href="src/telnyx/types/advanced_order_update_params.py">params</a>) -> object</code>
 - <code title="get /advanced_orders">client.advanced_orders.<a href="./src/telnyx/resources/advanced_orders.py">list</a>() -> object</code>
 
 # AI

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "telnyx"
-version = "3.0.0-alpha"
+version = "3.1.0-alpha"
 description = "The official Python library for the telnyx API"
 dynamic = ["readme"]
 license = "MIT"
@@ -148,6 +148,7 @@ exclude = [
     "_dev",
     ".venv",
     ".nox",
+    ".git",
 ]
 
 reportImplicitOverride = true

src/telnyx/_models.py

@@ -304,7 +304,7 @@ def model_dump(
                 exclude_none=exclude_none,
             )
 
-            return cast(dict[str, Any], json_safe(dumped)) if mode == "json" else dumped
+            return cast("dict[str, Any]", json_safe(dumped)) if mode == "json" else dumped
 
         @override
         def model_dump_json(

src/telnyx/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "telnyx"
-__version__ = "3.0.0-alpha"  # x-release-please-version
+__version__ = "3.1.0-alpha"  # x-release-please-version

src/telnyx/resources/advanced_orders.py

@@ -7,7 +7,7 @@
 
 import httpx
 
-from ..types import advanced_order_create_params
+from ..types import advanced_order_create_params, advanced_order_update_params
 from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
@@ -54,6 +54,7 @@ def create(
         phone_number_type: Literal["local", "mobile", "toll_free", "shared_cost", "national", "landline"]
         | NotGiven = NOT_GIVEN,
         quantity: int | NotGiven = NOT_GIVEN,
+        requirement_group_id: str | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -65,6 +66,8 @@ def create(
         Create Advanced Order
 
         Args:
+          requirement_group_id: The ID of the requirement group to associate with this advanced order
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -84,6 +87,7 @@ def create(
                     "features": features,
                     "phone_number_type": phone_number_type,
                     "quantity": quantity,
+                    "requirement_group_id": requirement_group_id,
                 },
                 advanced_order_create_params.AdvancedOrderCreateParams,
             ),
@@ -126,6 +130,63 @@ def retrieve(
             cast_to=object,
         )
 
+    def update(
+        self,
+        order_id: str,
+        *,
+        area_code: str | NotGiven = NOT_GIVEN,
+        comments: str | NotGiven = NOT_GIVEN,
+        country_code: str | NotGiven = NOT_GIVEN,
+        customer_reference: str | NotGiven = NOT_GIVEN,
+        features: List[Literal["sms", "mms", "voice", "fax", "emergency"]] | NotGiven = NOT_GIVEN,
+        phone_number_type: Literal["local", "mobile", "toll_free", "shared_cost", "national", "landline"]
+        | NotGiven = NOT_GIVEN,
+        quantity: int | NotGiven = NOT_GIVEN,
+        requirement_group_id: str | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> object:
+        """
+        Update Advanced Order
+
+        Args:
+          requirement_group_id: The ID of the requirement group to associate with this advanced order
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not order_id:
+            raise ValueError(f"Expected a non-empty value for `order_id` but received {order_id!r}")
+        return self._patch(
+            f"/advanced_orders/{order_id}",
+            body=maybe_transform(
+                {
+                    "area_code": area_code,
+                    "comments": comments,
+                    "country_code": country_code,
+                    "customer_reference": customer_reference,
+                    "features": features,
+                    "phone_number_type": phone_number_type,
+                    "quantity": quantity,
+                    "requirement_group_id": requirement_group_id,
+                },
+                advanced_order_update_params.AdvancedOrderUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=object,
+        )
+
     def list(
         self,
         *,
@@ -177,6 +238,7 @@ async def create(
         phone_number_type: Literal["local", "mobile", "toll_free", "shared_cost", "national", "landline"]
         | NotGiven = NOT_GIVEN,
         quantity: int | NotGiven = NOT_GIVEN,
+        requirement_group_id: str | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -188,6 +250,8 @@ async def create(
         Create Advanced Order
 
         Args:
+          requirement_group_id: The ID of the requirement group to associate with this advanced order
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -207,6 +271,7 @@ async def create(
                     "features": features,
                     "phone_number_type": phone_number_type,
                     "quantity": quantity,
+                    "requirement_group_id": requirement_group_id,
                 },
                 advanced_order_create_params.AdvancedOrderCreateParams,
             ),
@@ -249,6 +314,63 @@ async def retrieve(
             cast_to=object,
         )
 
+    async def update(
+        self,
+        order_id: str,
+        *,
+        area_code: str | NotGiven = NOT_GIVEN,
+        comments: str | NotGiven = NOT_GIVEN,
+        country_code: str | NotGiven = NOT_GIVEN,
+        customer_reference: str | NotGiven = NOT_GIVEN,
+        features: List[Literal["sms", "mms", "voice", "fax", "emergency"]] | NotGiven = NOT_GIVEN,
+        phone_number_type: Literal["local", "mobile", "toll_free", "shared_cost", "national", "landline"]
+        | NotGiven = NOT_GIVEN,
+        quantity: int | NotGiven = NOT_GIVEN,
+        requirement_group_id: str | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> object:
+        """
+        Update Advanced Order
+
+        Args:
+          requirement_group_id: The ID of the requirement group to associate with this advanced order
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not order_id:
+            raise ValueError(f"Expected a non-empty value for `order_id` but received {order_id!r}")
+        return await self._patch(
+            f"/advanced_orders/{order_id}",
+            body=await async_maybe_transform(
+                {
+                    "area_code": area_code,
+                    "comments": comments,
+                    "country_code": country_code,
+                    "customer_reference": customer_reference,
+                    "features": features,
+                    "phone_number_type": phone_number_type,
+                    "quantity": quantity,
+                    "requirement_group_id": requirement_group_id,
+                },
+                advanced_order_update_params.AdvancedOrderUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=object,
+        )
+
     async def list(
         self,
         *,
@@ -279,6 +401,9 @@ def __init__(self, advanced_orders: AdvancedOrdersResource) -> None:
         self.retrieve = to_raw_response_wrapper(
             advanced_orders.retrieve,
         )
+        self.update = to_raw_response_wrapper(
+            advanced_orders.update,
+        )
         self.list = to_raw_response_wrapper(
             advanced_orders.list,
         )
@@ -294,6 +419,9 @@ def __init__(self, advanced_orders: AsyncAdvancedOrdersResource) -> None:
         self.retrieve = async_to_raw_response_wrapper(
             advanced_orders.retrieve,
         )
+        self.update = async_to_raw_response_wrapper(
+            advanced_orders.update,
+        )
         self.list = async_to_raw_response_wrapper(
             advanced_orders.list,
         )
@@ -309,6 +437,9 @@ def __init__(self, advanced_orders: AdvancedOrdersResource) -> None:
         self.retrieve = to_streamed_response_wrapper(
             advanced_orders.retrieve,
         )
+        self.update = to_streamed_response_wrapper(
+            advanced_orders.update,
+        )
         self.list = to_streamed_response_wrapper(
             advanced_orders.list,
         )
@@ -324,6 +455,9 @@ def __init__(self, advanced_orders: AsyncAdvancedOrdersResource) -> None:
         self.retrieve = async_to_streamed_response_wrapper(
             advanced_orders.retrieve,
         )
+        self.update = async_to_streamed_response_wrapper(
+            advanced_orders.update,
+        )
         self.list = async_to_streamed_response_wrapper(
             advanced_orders.list,
         )

src/telnyx/resources/portouts/portouts.py

@@ -145,9 +145,10 @@ def list(
         Args:
           filter:
               Consolidated filter parameter (deepObject style). Originally:
-              filter[carrier_name], filter[pon], filter[spid], filter[status],
-              filter[status_in], filter[ported_out_at], filter[inserted_at], filter[foc_date],
-              filter[phone_number], filter[support_key]
+              filter[carrier_name], filter[country_code], filter[country_code_in],
+              filter[foc_date], filter[inserted_at], filter[phone_number], filter[pon],
+              filter[ported_out_at], filter[spid], filter[status], filter[status_in],
+              filter[support_key]
 
           page: Consolidated page parameter (deepObject style). Originally: page[number],
               page[size]
@@ -359,9 +360,10 @@ async def list(
         Args:
           filter:
               Consolidated filter parameter (deepObject style). Originally:
-              filter[carrier_name], filter[pon], filter[spid], filter[status],
-              filter[status_in], filter[ported_out_at], filter[inserted_at], filter[foc_date],
-              filter[phone_number], filter[support_key]
+              filter[carrier_name], filter[country_code], filter[country_code_in],
+              filter[foc_date], filter[inserted_at], filter[phone_number], filter[pon],
+              filter[ported_out_at], filter[spid], filter[status], filter[status_in],
+              filter[support_key]
 
           page: Consolidated page parameter (deepObject style). Originally: page[number],
               page[size]