proxyrequest-sdk 4.2.0__tar.gz → 4.3.0__tar.gz

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.3.0}/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to the ProxyRequest Python SDK are documented here.
 
 ## Unreleased
 
+## 4.3.0 (2026-10-07)
+
+- Add `include_geo` to synchronous and asynchronous `locations.list_asns()`. Set it to `True` to request country, region, and city scopes in each ASN's `geo` list; the API returns an empty list by default.
+- Expose the always-present `country_codes` summary on `LocationASNRecord`.
+- Regenerate the SDK and reference from the latest public API contract while preserving existing arguments.
+
+## 4.2.1 (2026-10-05)
+
+- Allow an explicit zero invoice total for free product purchases; setting any explicit total requires superuser authorization.
+- Restore PostgreSQL integer bounds and int64 formats in the bundled OpenAPI contract and regenerate the SDK.
+
 ## 4.2.0 (2026-10-05)
 
 - Add the optional price_total invoice creation field.

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proxyrequest-sdk
-Version: 4.2.0
+Version: 4.3.0
 Summary: Official sync and async Python SDK for the ProxyRequest public API.
 Project-URL: Homepage, https://proxyrequest.com
 Project-URL: Documentation, https://proxyrequest.com/docs/
@@ -370,3 +370,5 @@ for balance in page.results:
 Provider byte amounts are exact decimal **strings**, including history entries; calculated usage and remaining amounts can be `null`. The response includes observation and calculation times, freshness, errors, and recent checkpoint history. History is limited by the server's `PROVIDER_DATA_BALANCE_HISTORY_LIMIT` setting (default 10). Standard pagination applies to providers.
 
 Country, region, and city methods also support `include_asns`. Set it to `true` to populate nested ASN arrays; omitted or false uses the API's empty-array default.
+
+`client.locations.list_asns(package_id=package_id, include_geo=True)` includes country, region, and city scopes in each ASN's `geo` list. Without `include_geo`, `geo` is empty; `country_codes` still lists the available country codes. The same option is available on `AsyncClient`.

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.3.0}/README.md

@@ -340,3 +340,5 @@ for balance in page.results:
 Provider byte amounts are exact decimal **strings**, including history entries; calculated usage and remaining amounts can be `null`. The response includes observation and calculation times, freshness, errors, and recent checkpoint history. History is limited by the server's `PROVIDER_DATA_BALANCE_HISTORY_LIMIT` setting (default 10). Standard pagination applies to providers.
 
 Country, region, and city methods also support `include_asns`. Set it to `true` to populate nested ASN arrays; omitted or false uses the API's empty-array default.
+
+`client.locations.list_asns(package_id=package_id, include_geo=True)` includes country, region, and city scopes in each ASN's `geo` list. Without `include_geo`, `geo` is empty; `country_codes` still lists the available country codes. The same option is available on `AsyncClient`.

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.3.0}/docs/reference/sdk-reference.json

@@ -4,12 +4,12 @@
     "id": "python",
     "label": "Python",
     "language": "Python",
-    "version": "4.2.0",
+    "version": "4.3.0",
     "package": "proxyrequest-sdk",
     "runtime": "Python 3.11 or later",
     "install": "python -m pip install proxyrequest-sdk",
     "openapi": {
-      "commit": "3bd7c30b6727264a0eae42f6d536e1cce34b3b5b",
+      "commit": "19f5f67335bbd888e9454914eca4a59acfce270c",
       "excludedOperations": [
         "sessions_destroy",
         "sessions_list"
@@ -17,7 +17,7 @@
       "operations": 85,
       "repository": "papaproxy/api",
       "schemas": 142,
-      "sha256": "08b890bf82142b5a60d198ef7cf53f5cbc073e8f4a44b7b7994b7a49baae4a88",
+      "sha256": "b787e51bd6b990ad492a97c3ff09d823a6d3269855fb46ddc82a02a2becaac9d",
       "source": "openapi.yml"
     }
   },
@@ -3105,11 +3105,11 @@
           ],
           "example": {
             "language": "python",
-            "code": "result = client.coupons.create(\n        body=models.CouponCreateRequest.from_dict({'value': 1, 'type': 'free_data'}),\n    )"
+            "code": "result = client.coupons.create(\n        body=models.CouponCreateRequest.from_dict({'value': -9223372036854775808, 'type': 'free_data'}),\n    )"
           },
           "asyncExample": {
             "language": "python",
-            "code": "result = await async_client.coupons.create(\n        body=models.CouponCreateRequest.from_dict({'value': 1, 'type': 'free_data'}),\n    )"
+            "code": "result = await async_client.coupons.create(\n        body=models.CouponCreateRequest.from_dict({'value': -9223372036854775808, 'type': 'free_data'}),\n    )"
           }
         },
         {
@@ -3362,11 +3362,11 @@
           ],
           "example": {
             "language": "python",
-            "code": "result = client.coupons.replace(\n        id='550e8400-e29b-41d4-a716-446655440000',\n        body=models.CouponUpdateRequest.from_dict({'value': 1, 'type': 'free_data'}),\n    )"
+            "code": "result = client.coupons.replace(\n        id='550e8400-e29b-41d4-a716-446655440000',\n        body=models.CouponUpdateRequest.from_dict({'value': -9223372036854775808, 'type': 'free_data'}),\n    )"
           },
           "asyncExample": {
             "language": "python",
-            "code": "result = await async_client.coupons.replace(\n        id='550e8400-e29b-41d4-a716-446655440000',\n        body=models.CouponUpdateRequest.from_dict({'value': 1, 'type': 'free_data'}),\n    )"
+            "code": "result = await async_client.coupons.replace(\n        id='550e8400-e29b-41d4-a716-446655440000',\n        body=models.CouponUpdateRequest.from_dict({'value': -9223372036854775808, 'type': 'free_data'}),\n    )"
           }
         },
         {
@@ -4797,23 +4797,23 @@
           "operationId": "locations_asn_list",
           "name": "list_asns",
           "summary": "List available autonomous systems",
-          "description": "Returns targetable ASNs for the selected package. Geo-scoped records include the country, region, or city where the ASN can be selected.",
+          "description": "Returns targetable ASNs for the selected package. The geo field is empty unless include_geo=true; then it contains targetable geographic scopes.",
           "httpMethod": "GET",
           "path": "/locations/asn",
           "signatures": [
             {
               "label": "Sync",
-              "signature": "client.locations.list_asns(*, code: str | Unset=UNSET, country_code: str | Unset=UNSET, global_: bool | Unset=UNSET, limit: int | Unset=UNSET, name: str | Unset=UNSET, offset: int | Unset=UNSET, ordering: str | Unset=UNSET, package_id: UUID, search: str | Unset=UNSET, accept_language: str | Unset=UNSET) -> PaginatedLocationASNRecordList"
+              "signature": "client.locations.list_asns(*, code: str | Unset=UNSET, country_code: str | Unset=UNSET, global_: bool | Unset=UNSET, include_geo: bool | Unset=False, limit: int | Unset=UNSET, name: str | Unset=UNSET, offset: int | Unset=UNSET, ordering: str | Unset=UNSET, package_id: UUID, search: str | Unset=UNSET, accept_language: str | Unset=UNSET) -> PaginatedLocationASNRecordList"
             },
             {
               "label": "Async",
-              "signature": "await async_client.locations.list_asns(*, code: str | Unset=UNSET, country_code: str | Unset=UNSET, global_: bool | Unset=UNSET, limit: int | Unset=UNSET, name: str | Unset=UNSET, offset: int | Unset=UNSET, ordering: str | Unset=UNSET, package_id: UUID, search: str | Unset=UNSET, accept_language: str | Unset=UNSET) -> PaginatedLocationASNRecordList"
+              "signature": "await async_client.locations.list_asns(*, code: str | Unset=UNSET, country_code: str | Unset=UNSET, global_: bool | Unset=UNSET, include_geo: bool | Unset=False, limit: int | Unset=UNSET, name: str | Unset=UNSET, offset: int | Unset=UNSET, ordering: str | Unset=UNSET, package_id: UUID, search: str | Unset=UNSET, accept_language: str | Unset=UNSET) -> PaginatedLocationASNRecordList"
             }
           ],
           "variants": [
             {
               "name": "list_asns_with_response",
-              "signature": "client.locations.list_asns_with_response(*, code: str | Unset=UNSET, country_code: str | Unset=UNSET, global_: bool | Unset=UNSET, limit: int | Unset=UNSET, name: str | Unset=UNSET, offset: int | Unset=UNSET, ordering: str | Unset=UNSET, package_id: UUID, search: str | Unset=UNSET, accept_language: str | Unset=UNSET) -> ApiResponse[PaginatedLocationASNRecordList]",
+              "signature": "client.locations.list_asns_with_response(*, code: str | Unset=UNSET, country_code: str | Unset=UNSET, global_: bool | Unset=UNSET, include_geo: bool | Unset=False, limit: int | Unset=UNSET, name: str | Unset=UNSET, offset: int | Unset=UNSET, ordering: str | Unset=UNSET, package_id: UUID, search: str | Unset=UNSET, accept_language: str | Unset=UNSET) -> ApiResponse[PaginatedLocationASNRecordList]",
               "description": "Returns response status, headers, ETag and idempotency metadata with the decoded data."
             }
           ],
@@ -4851,6 +4851,17 @@
               "example": false,
               "modelRefs": []
             },
+            {
+              "name": "include_geo",
+              "wireName": "include_geo",
+              "in": "query",
+              "required": false,
+              "type": "bool",
+              "default": false,
+              "description": "Include geographic scopes for each ASN. By default geo is an empty list.",
+              "example": false,
+              "modelRefs": []
+            },
             {
               "name": "limit",
               "wireName": "limit",
@@ -14264,7 +14275,7 @@
           "type": "int",
           "required": false,
           "default": null,
-          "description": "Optional final invoice total in the smallest currency unit, including tax and discounts. For a balance invoice, this is also the balance credit and takes precedence over amount. Only superusers or active superuser API keys may supply it, including during API-key impersonation; coupon_code cannot be supplied with price_total.",
+          "description": "Optional final invoice total in the smallest currency unit, including tax and discounts. Zero is allowed for a free product purchase. For a balance invoice, this is also the balance credit, must satisfy the balance top-up limits, and takes precedence over amount. Only superusers or active superuser API keys may supply it, including zero and during API-key impersonation; coupon_code cannot be supplied with price_total.",
           "enum": null,
           "modelRefs": []
         },
@@ -14707,10 +14718,19 @@
           "enum": null,
           "modelRefs": []
         },
+        {
+          "name": "country_codes",
+          "type": "list[str]",
+          "required": true,
+          "default": null,
+          "description": "",
+          "enum": null,
+          "modelRefs": []
+        },
         {
           "name": "geo",
           "type": "list[LocationASNGeoItem]",
-          "required": false,
+          "required": true,
           "default": null,
           "description": "",
           "enum": null,

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.3.0}/openapi/openapi.yaml

@@ -6984,8 +6984,8 @@ paths:
   /locations/asn:
     get:
       operationId: locations_asn_list
-      description: Returns targetable ASNs for the selected package. Geo-scoped records
-        include the country, region, or city where the ASN can be selected.
+      description: Returns targetable ASNs for the selected package. The geo field is
+        empty unless include_geo=true; then it contains targetable geographic scopes.
       summary: List available autonomous systems
       parameters:
       - in: query
@@ -7001,6 +7001,16 @@ paths:
         schema:
           type: boolean
         description: Set to true to return only globally targetable ASNs.
+      - in: query
+        name: include_geo
+        schema:
+          type: boolean
+          default: false
+        description: Include geographic scopes for each ASN. By default geo is an empty list.
+        examples:
+          IncludeASNGeography:
+            value: true
+            summary: Include ASN geography
       - name: limit
         required: false
         in: query
@@ -7076,16 +7086,9 @@ paths:
                     results:
                     - code: '7922'
                       name: Comcast Cable Communications
-                      geo:
-                      - country:
-                          code: us
-                          name: United States
-                        region:
-                          code: california
-                          name: California
-                        city:
-                          code: los_angeles
-                          name: Los Angeles
+                      country_codes:
+                      - us
+                      geo: []
                   summary: Available ASNs
           description: The operation completed successfully.
         '400':
@@ -17983,6 +17986,9 @@ components:
           readOnly: true
         value:
           type: integer
+          maximum: 9223372036854775807
+          minimum: -9223372036854775808
+          format: int64
           description: Arbitrary coupon value
         code:
           type: string
@@ -18000,6 +18006,8 @@ components:
           $ref: '#/components/schemas/CouponTypeEnum'
         limit:
           type: integer
+          maximum: 2147483647
+          minimum: -2147483648
           description: Number of times coupon can be used
         valid_until:
           type: string
@@ -18051,6 +18059,9 @@ components:
       properties:
         value:
           type: integer
+          maximum: 9223372036854775807
+          minimum: -9223372036854775808
+          format: int64
           description: Arbitrary coupon value
         code:
           type: string
@@ -18074,6 +18085,8 @@ components:
           $ref: '#/components/schemas/CouponTypeEnum'
         limit:
           type: integer
+          maximum: 2147483647
+          minimum: -2147483648
           description: Number of times coupon can be used
         valid_until:
           type: string
@@ -18166,6 +18179,9 @@ components:
           readOnly: true
         value:
           type: integer
+          maximum: 9223372036854775807
+          minimum: -9223372036854775808
+          format: int64
           description: Arbitrary coupon value
         code:
           type: string
@@ -18183,6 +18199,8 @@ components:
           $ref: '#/components/schemas/CouponTypeEnum'
         limit:
           type: integer
+          maximum: 2147483647
+          minimum: -2147483648
           description: Number of times coupon can be used
         valid_until:
           type: string
@@ -18242,6 +18260,9 @@ components:
       properties:
         value:
           type: integer
+          maximum: 9223372036854775807
+          minimum: -9223372036854775808
+          format: int64
           description: Arbitrary coupon value
         code:
           type: string
@@ -18266,6 +18287,8 @@ components:
           $ref: '#/components/schemas/CouponTypeEnum'
         limit:
           type: integer
+          maximum: 2147483647
+          minimum: -2147483648
           description: Number of times coupon can be used
         valid_until:
           type: string
@@ -18699,11 +18722,13 @@ components:
             be left blank.
         connection_limit:
           type: integer
+          maximum: 2147483647
           minimum: -1
           description: The maximum number of concurrent connections allowed for this
             package.
         quantity:
           type: integer
+          maximum: 2147483647
           minimum: 0
           description: The number of proxies to assign.
         data:
@@ -18919,13 +18944,14 @@ components:
         price_total:
           type: integer
           maximum: 10000000000
-          minimum: 1
+          minimum: 0
           format: int64
           description: Optional final invoice total in the smallest currency unit,
-            including tax and discounts. For a balance invoice, this is also the balance
-            credit and takes precedence over amount. Only superusers or active superuser
-            API keys may supply it, including during API-key impersonation; coupon_code
-            cannot be supplied with price_total.
+            including tax and discounts. Zero is allowed for a free product purchase.
+            For a balance invoice, this is also the balance credit, must satisfy the
+            balance top-up limits, and takes precedence over amount. Only superusers
+            or active superuser API keys may supply it, including zero and during
+            API-key impersonation; coupon_code cannot be supplied with price_total.
         connection_limit:
           type: integer
           minimum: -1
@@ -19061,12 +19087,18 @@ components:
           type: string
         name:
           type: string
+        country_codes:
+          type: array
+          items:
+            type: string
         geo:
           type: array
           items:
             $ref: '#/components/schemas/LocationASNGeoItem'
       required:
       - code
+      - country_codes
+      - geo
       - name
     LocationCodeName:
       type: object
@@ -19348,6 +19380,9 @@ components:
             order.
         latest_data_top_up:
           type: integer
+          maximum: 9223372036854775807
+          minimum: -9223372036854775808
+          format: int64
           title: Latest Top-up (bytes)
           description: Amount of data added to this order in bytes during the most
             recent top-up.
@@ -19464,6 +19499,9 @@ components:
             orders. Not a complete history, and array position is not spending priority.
         latest_data_top_up:
           type: integer
+          maximum: 9223372036854775807
+          minimum: -9223372036854775808
+          format: int64
           title: Latest Top-up (bytes)
           description: Amount of data added to this order in bytes during the most
             recent top-up.
@@ -19564,6 +19602,7 @@ components:
           $ref: '#/components/schemas/ProxyTypeEnum'
         order:
           type: integer
+          maximum: 2147483647
           minimum: 0
           description: Display order in the UI. Lower values appear first.
         is_continent_targeting:
@@ -19628,6 +19667,7 @@ components:
             will not enforce any bandwidth limit.
         billing_unlimited:
           type: integer
+          maximum: 2147483647
           minimum: 0
           title: Unlimited Price
           description: Price charged for unlimited data access on this package. Set
@@ -20201,6 +20241,9 @@ components:
       properties:
         value:
           type: integer
+          maximum: 9223372036854775807
+          minimum: -9223372036854775808
+          format: int64
           description: Arbitrary coupon value
         code:
           type: string
@@ -20225,6 +20268,8 @@ components:
           $ref: '#/components/schemas/CouponTypeEnum'
         limit:
           type: integer
+          maximum: 2147483647
+          minimum: -2147483648
           description: Number of times coupon can be used
         valid_until:
           type: string
@@ -20770,6 +20815,7 @@ components:
           readOnly: true
         balance:
           type: integer
+          maximum: 2147483647
           minimum: 0
           title: Balance (cents)
         data:
@@ -21316,6 +21362,7 @@ components:
           maxLength: 150
         balance:
           type: integer
+          maximum: 2147483647
           minimum: 0
         language:
           $ref: '#/components/schemas/LanguageEnum'
@@ -21366,6 +21413,7 @@ components:
           readOnly: true
         connection_limit:
           type: integer
+          maximum: 2147483647
           minimum: -1
           description: The maximum number of concurrent connections allowed for this
             package.

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.3.0}/openapi/source.json

@@ -1,5 +1,5 @@
 {
-  "commit": "3bd7c30b6727264a0eae42f6d536e1cce34b3b5b",
+  "commit": "19f5f67335bbd888e9454914eca4a59acfce270c",
   "excludedOperations": [
     "sessions_destroy",
     "sessions_list"
@@ -7,6 +7,6 @@
   "operations": 85,
   "repository": "papaproxy/api",
   "schemas": 142,
-  "sha256": "08b890bf82142b5a60d198ef7cf53f5cbc073e8f4a44b7b7994b7a49baae4a88",
+  "sha256": "b787e51bd6b990ad492a97c3ff09d823a6d3269855fb46ddc82a02a2becaac9d",
   "source": "openapi.yml"
 }

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "proxyrequest-sdk"
-version = "4.2.0"
+version = "4.3.0"
 description = "Official sync and async Python SDK for the ProxyRequest public API."
 readme = "README.md"
 requires-python = ">=3.11"

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.3.0}/src/proxyrequest_sdk/_generated/api/locations/locations_asn_list.py

@@ -24,6 +24,7 @@ def _get_kwargs(
     code: str | Unset = UNSET,
     country_code: str | Unset = UNSET,
     global_: bool | Unset = UNSET,
+    include_geo: bool | Unset = False,
     limit: int | Unset = UNSET,
     name: str | Unset = UNSET,
     offset: int | Unset = UNSET,
@@ -44,6 +45,8 @@ def _get_kwargs(
 
     params["global"] = global_
 
+    params["include_geo"] = include_geo
+
     params["limit"] = limit
 
     params["name"] = name
@@ -127,6 +130,7 @@ def sync_detailed(
     code: str | Unset = UNSET,
     country_code: str | Unset = UNSET,
     global_: bool | Unset = UNSET,
+    include_geo: bool | Unset = False,
     limit: int | Unset = UNSET,
     name: str | Unset = UNSET,
     offset: int | Unset = UNSET,
@@ -142,13 +146,14 @@ def sync_detailed(
 ]:
     """List available autonomous systems
 
-     Returns targetable ASNs for the selected package. Geo-scoped records include the country, region, or
-    city where the ASN can be selected.
+     Returns targetable ASNs for the selected package. The geo field is empty unless include_geo=true;
+    then it contains targetable geographic scopes.
 
     Args:
         code (str | Unset):
         country_code (str | Unset):
         global_ (bool | Unset):
+        include_geo (bool | Unset):  Default: False.
         limit (int | Unset):
         name (str | Unset):
         offset (int | Unset):
@@ -169,6 +174,7 @@ def sync_detailed(
         code=code,
         country_code=country_code,
         global_=global_,
+        include_geo=include_geo,
         limit=limit,
         name=name,
         offset=offset,
@@ -191,6 +197,7 @@ def sync(
     code: str | Unset = UNSET,
     country_code: str | Unset = UNSET,
     global_: bool | Unset = UNSET,
+    include_geo: bool | Unset = False,
     limit: int | Unset = UNSET,
     name: str | Unset = UNSET,
     offset: int | Unset = UNSET,
@@ -207,13 +214,14 @@ def sync(
 ):
     """List available autonomous systems
 
-     Returns targetable ASNs for the selected package. Geo-scoped records include the country, region, or
-    city where the ASN can be selected.
+     Returns targetable ASNs for the selected package. The geo field is empty unless include_geo=true;
+    then it contains targetable geographic scopes.
 
     Args:
         code (str | Unset):
         country_code (str | Unset):
         global_ (bool | Unset):
+        include_geo (bool | Unset):  Default: False.
         limit (int | Unset):
         name (str | Unset):
         offset (int | Unset):
@@ -235,6 +243,7 @@ def sync(
         code=code,
         country_code=country_code,
         global_=global_,
+        include_geo=include_geo,
         limit=limit,
         name=name,
         offset=offset,
@@ -251,6 +260,7 @@ async def asyncio_detailed(
     code: str | Unset = UNSET,
     country_code: str | Unset = UNSET,
     global_: bool | Unset = UNSET,
+    include_geo: bool | Unset = False,
     limit: int | Unset = UNSET,
     name: str | Unset = UNSET,
     offset: int | Unset = UNSET,
@@ -266,13 +276,14 @@ async def asyncio_detailed(
 ]:
     """List available autonomous systems
 
-     Returns targetable ASNs for the selected package. Geo-scoped records include the country, region, or
-    city where the ASN can be selected.
+     Returns targetable ASNs for the selected package. The geo field is empty unless include_geo=true;
+    then it contains targetable geographic scopes.
 
     Args:
         code (str | Unset):
         country_code (str | Unset):
         global_ (bool | Unset):
+        include_geo (bool | Unset):  Default: False.
         limit (int | Unset):
         name (str | Unset):
         offset (int | Unset):
@@ -293,6 +304,7 @@ async def asyncio_detailed(
         code=code,
         country_code=country_code,
         global_=global_,
+        include_geo=include_geo,
         limit=limit,
         name=name,
         offset=offset,
@@ -313,6 +325,7 @@ async def asyncio(
     code: str | Unset = UNSET,
     country_code: str | Unset = UNSET,
     global_: bool | Unset = UNSET,
+    include_geo: bool | Unset = False,
     limit: int | Unset = UNSET,
     name: str | Unset = UNSET,
     offset: int | Unset = UNSET,
@@ -329,13 +342,14 @@ async def asyncio(
 ):
     """List available autonomous systems
 
-     Returns targetable ASNs for the selected package. Geo-scoped records include the country, region, or
-    city where the ASN can be selected.
+     Returns targetable ASNs for the selected package. The geo field is empty unless include_geo=true;
+    then it contains targetable geographic scopes.
 
     Args:
         code (str | Unset):
         country_code (str | Unset):
         global_ (bool | Unset):
+        include_geo (bool | Unset):  Default: False.
         limit (int | Unset):
         name (str | Unset):
         offset (int | Unset):
@@ -358,6 +372,7 @@ async def asyncio(
             code=code,
             country_code=country_code,
             global_=global_,
+            include_geo=include_geo,
             limit=limit,
             name=name,
             offset=offset,

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.3.0}/src/proxyrequest_sdk/_generated/models/invoice_create_request.py

@@ -52,10 +52,10 @@ class InvoiceCreateRequest:
     """ Account balance amount to purchase, in the smallest currency unit. Use for a wallet top-up without
     package_id, not for buying proxy data. """
     price_total: int | Unset = UNSET
-    """ Optional final invoice total in the smallest currency unit, including tax and discounts. For a balance
-    invoice, this is also the balance credit and takes precedence over amount. Only superusers or active superuser
-    API keys may supply it, including during API-key impersonation; coupon_code cannot be supplied with price_total.
-    """
+    """ Optional final invoice total in the smallest currency unit, including tax and discounts. Zero is allowed for
+    a free product purchase. For a balance invoice, this is also the balance credit, must satisfy the balance top-up
+    limits, and takes precedence over amount. Only superusers or active superuser API keys may supply it, including
+    zero and during API-key impersonation; coupon_code cannot be supplied with price_total. """
     connection_limit: int | Unset = UNSET
     expires: int | Unset = UNSET
     """ Optional future expiration as a Unix timestamp in seconds, not milliseconds. Otherwise a positive package