archil-openapi 0.0.53__tar.gz → 0.0.55__tar.gz

{archil_openapi-0.0.53 → archil_openapi-0.0.55}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: archil-openapi
-Version: 0.0.53
+Version: 0.0.55
 Summary: Generated low-level Python client for the Archil control plane API
 Keywords: archil,openapi
 Author: Archil, Inc.

{archil_openapi-0.0.53 → archil_openapi-0.0.55}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "archil-openapi"
-version = "0.0.53"
+version = "0.0.55"
 description = "Generated low-level Python client for the Archil control plane API"
 readme = "README.md"
 license = { file = "LICENSE" }

archil_openapi-0.0.55/src/archil_openapi/api/billing/get_billing_costs.py

@@ -0,0 +1,273 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.api_response_billing_costs import ApiResponseBillingCosts
+from ...models.error_response import ErrorResponse
+from ...models.get_billing_costs_for import GetBillingCostsFor
+from ...models.get_billing_costs_granularity import GetBillingCostsGranularity
+from ...types import UNSET, Response, Unset
+
+
+def _get_kwargs(
+    *,
+    start: Union[Unset, str] = UNSET,
+    end: Union[Unset, str] = UNSET,
+    for_: Union[Unset, GetBillingCostsFor] = UNSET,
+    granularity: Union[Unset, GetBillingCostsGranularity] = GetBillingCostsGranularity.VALUE_0,
+    timezone: Union[Unset, str] = "UTC",
+) -> dict[str, Any]:
+    params: dict[str, Any] = {}
+
+    params["start"] = start
+
+    params["end"] = end
+
+    json_for_: Union[Unset, str] = UNSET
+    if not isinstance(for_, Unset):
+        json_for_ = for_.value
+
+    params["for"] = json_for_
+
+    json_granularity: Union[Unset, str] = UNSET
+    if not isinstance(granularity, Unset):
+        json_granularity = granularity.value
+
+    params["granularity"] = json_granularity
+
+    params["timezone"] = timezone
+
+    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/api/billing/costs",
+        "params": params,
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Optional[Union[ApiResponseBillingCosts, ErrorResponse]]:
+    if response.status_code == 200:
+        response_200 = ApiResponseBillingCosts.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 400:
+        response_400 = ErrorResponse.from_dict(response.json())
+
+        return response_400
+
+    if response.status_code == 401:
+        response_401 = ErrorResponse.from_dict(response.json())
+
+        return response_401
+
+    if response.status_code == 502:
+        response_502 = ErrorResponse.from_dict(response.json())
+
+        return response_502
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Response[Union[ApiResponseBillingCosts, ErrorResponse]]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient,
+    start: Union[Unset, str] = UNSET,
+    end: Union[Unset, str] = UNSET,
+    for_: Union[Unset, GetBillingCostsFor] = UNSET,
+    granularity: Union[Unset, GetBillingCostsGranularity] = GetBillingCostsGranularity.VALUE_0,
+    timezone: Union[Unset, str] = "UTC",
+) -> Response[Union[ApiResponseBillingCosts, ErrorResponse]]:
+    """Get the cost of metered usage over a window
+
+     Returns the same usage as `/api/billing/usage` priced at the account's rates, for the window and per
+    interval and meter, before the plan's included credits and base price: the cost of what was used,
+    not what will be invoiced. Summed over the billing period it is the usage line of the invoice;
+    `/api/billing/summary` applies the plan's base price and included credits on top. Money is in
+    integer cents. On a plan that prices no usage, `priced` is false and every cost is zero.
+
+    Args:
+        start (Union[Unset, str]):  Example: 2026-10-13.
+        end (Union[Unset, str]):  Example: 2026-10-20.
+        for_ (Union[Unset, GetBillingCostsFor]):
+        granularity (Union[Unset, GetBillingCostsGranularity]):  Default:
+            GetBillingCostsGranularity.VALUE_0.
+        timezone (Union[Unset, str]):  Default: 'UTC'. Example: America/Los_Angeles.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Union[ApiResponseBillingCosts, ErrorResponse]]
+    """
+
+    kwargs = _get_kwargs(
+        start=start,
+        end=end,
+        for_=for_,
+        granularity=granularity,
+        timezone=timezone,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient,
+    start: Union[Unset, str] = UNSET,
+    end: Union[Unset, str] = UNSET,
+    for_: Union[Unset, GetBillingCostsFor] = UNSET,
+    granularity: Union[Unset, GetBillingCostsGranularity] = GetBillingCostsGranularity.VALUE_0,
+    timezone: Union[Unset, str] = "UTC",
+) -> Optional[Union[ApiResponseBillingCosts, ErrorResponse]]:
+    """Get the cost of metered usage over a window
+
+     Returns the same usage as `/api/billing/usage` priced at the account's rates, for the window and per
+    interval and meter, before the plan's included credits and base price: the cost of what was used,
+    not what will be invoiced. Summed over the billing period it is the usage line of the invoice;
+    `/api/billing/summary` applies the plan's base price and included credits on top. Money is in
+    integer cents. On a plan that prices no usage, `priced` is false and every cost is zero.
+
+    Args:
+        start (Union[Unset, str]):  Example: 2026-10-13.
+        end (Union[Unset, str]):  Example: 2026-10-20.
+        for_ (Union[Unset, GetBillingCostsFor]):
+        granularity (Union[Unset, GetBillingCostsGranularity]):  Default:
+            GetBillingCostsGranularity.VALUE_0.
+        timezone (Union[Unset, str]):  Default: 'UTC'. Example: America/Los_Angeles.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Union[ApiResponseBillingCosts, ErrorResponse]
+    """
+
+    return sync_detailed(
+        client=client,
+        start=start,
+        end=end,
+        for_=for_,
+        granularity=granularity,
+        timezone=timezone,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient,
+    start: Union[Unset, str] = UNSET,
+    end: Union[Unset, str] = UNSET,
+    for_: Union[Unset, GetBillingCostsFor] = UNSET,
+    granularity: Union[Unset, GetBillingCostsGranularity] = GetBillingCostsGranularity.VALUE_0,
+    timezone: Union[Unset, str] = "UTC",
+) -> Response[Union[ApiResponseBillingCosts, ErrorResponse]]:
+    """Get the cost of metered usage over a window
+
+     Returns the same usage as `/api/billing/usage` priced at the account's rates, for the window and per
+    interval and meter, before the plan's included credits and base price: the cost of what was used,
+    not what will be invoiced. Summed over the billing period it is the usage line of the invoice;
+    `/api/billing/summary` applies the plan's base price and included credits on top. Money is in
+    integer cents. On a plan that prices no usage, `priced` is false and every cost is zero.
+
+    Args:
+        start (Union[Unset, str]):  Example: 2026-10-13.
+        end (Union[Unset, str]):  Example: 2026-10-20.
+        for_ (Union[Unset, GetBillingCostsFor]):
+        granularity (Union[Unset, GetBillingCostsGranularity]):  Default:
+            GetBillingCostsGranularity.VALUE_0.
+        timezone (Union[Unset, str]):  Default: 'UTC'. Example: America/Los_Angeles.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Union[ApiResponseBillingCosts, ErrorResponse]]
+    """
+
+    kwargs = _get_kwargs(
+        start=start,
+        end=end,
+        for_=for_,
+        granularity=granularity,
+        timezone=timezone,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient,
+    start: Union[Unset, str] = UNSET,
+    end: Union[Unset, str] = UNSET,
+    for_: Union[Unset, GetBillingCostsFor] = UNSET,
+    granularity: Union[Unset, GetBillingCostsGranularity] = GetBillingCostsGranularity.VALUE_0,
+    timezone: Union[Unset, str] = "UTC",
+) -> Optional[Union[ApiResponseBillingCosts, ErrorResponse]]:
+    """Get the cost of metered usage over a window
+
+     Returns the same usage as `/api/billing/usage` priced at the account's rates, for the window and per
+    interval and meter, before the plan's included credits and base price: the cost of what was used,
+    not what will be invoiced. Summed over the billing period it is the usage line of the invoice;
+    `/api/billing/summary` applies the plan's base price and included credits on top. Money is in
+    integer cents. On a plan that prices no usage, `priced` is false and every cost is zero.
+
+    Args:
+        start (Union[Unset, str]):  Example: 2026-10-13.
+        end (Union[Unset, str]):  Example: 2026-10-20.
+        for_ (Union[Unset, GetBillingCostsFor]):
+        granularity (Union[Unset, GetBillingCostsGranularity]):  Default:
+            GetBillingCostsGranularity.VALUE_0.
+        timezone (Union[Unset, str]):  Default: 'UTC'. Example: America/Los_Angeles.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Union[ApiResponseBillingCosts, ErrorResponse]
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            start=start,
+            end=end,
+            for_=for_,
+            granularity=granularity,
+            timezone=timezone,
+        )
+    ).parsed

{archil_openapi-0.0.53 → archil_openapi-0.0.55}/src/archil_openapi/api/billing/get_billing_credits.py

@@ -85,8 +85,11 @@ def sync_detailed(
 ) -> Response[Union[ApiResponseBillingCredits, ErrorResponse]]:
     """Get the account credit balance
 
-     Returns the customer credit balance and one page of balance transactions, newest first, such as
-    credit notes applied to the balance. Pass nextCursor as cursor to continue.
+     Deprecated: the plan's credit pool on `/api/billing/summary` replaces the Stripe customer balance,
+    and credit notes are on each invoice under `/api/billing/invoices/{invoiceID}`; this route goes once
+    the console no longer calls it. Returns the customer credit balance and one page of balance
+    transactions, newest first, such as credit notes applied to the balance. Pass nextCursor as cursor
+    to continue.
 
     Args:
         limit (Union[Unset, int]):  Default: 24.
@@ -120,8 +123,11 @@ def sync(
 ) -> Optional[Union[ApiResponseBillingCredits, ErrorResponse]]:
     """Get the account credit balance
 
-     Returns the customer credit balance and one page of balance transactions, newest first, such as
-    credit notes applied to the balance. Pass nextCursor as cursor to continue.
+     Deprecated: the plan's credit pool on `/api/billing/summary` replaces the Stripe customer balance,
+    and credit notes are on each invoice under `/api/billing/invoices/{invoiceID}`; this route goes once
+    the console no longer calls it. Returns the customer credit balance and one page of balance
+    transactions, newest first, such as credit notes applied to the balance. Pass nextCursor as cursor
+    to continue.
 
     Args:
         limit (Union[Unset, int]):  Default: 24.
@@ -150,8 +156,11 @@ async def asyncio_detailed(
 ) -> Response[Union[ApiResponseBillingCredits, ErrorResponse]]:
     """Get the account credit balance
 
-     Returns the customer credit balance and one page of balance transactions, newest first, such as
-    credit notes applied to the balance. Pass nextCursor as cursor to continue.
+     Deprecated: the plan's credit pool on `/api/billing/summary` replaces the Stripe customer balance,
+    and credit notes are on each invoice under `/api/billing/invoices/{invoiceID}`; this route goes once
+    the console no longer calls it. Returns the customer credit balance and one page of balance
+    transactions, newest first, such as credit notes applied to the balance. Pass nextCursor as cursor
+    to continue.
 
     Args:
         limit (Union[Unset, int]):  Default: 24.
@@ -183,8 +192,11 @@ async def asyncio(
 ) -> Optional[Union[ApiResponseBillingCredits, ErrorResponse]]:
     """Get the account credit balance
 
-     Returns the customer credit balance and one page of balance transactions, newest first, such as
-    credit notes applied to the balance. Pass nextCursor as cursor to continue.
+     Deprecated: the plan's credit pool on `/api/billing/summary` replaces the Stripe customer balance,
+    and credit notes are on each invoice under `/api/billing/invoices/{invoiceID}`; this route goes once
+    the console no longer calls it. Returns the customer credit balance and one page of balance
+    transactions, newest first, such as credit notes applied to the balance. Pass nextCursor as cursor
+    to continue.
 
     Args:
         limit (Union[Unset, int]):  Default: 24.

archil_openapi-0.0.53/src/archil_openapi/api/billing/get_billing_summary.py → archil_openapi-0.0.55/src/archil_openapi/api/billing/get_billing_subscription.py

@@ -5,7 +5,7 @@ import httpx
 
 from ... import errors
 from ...client import AuthenticatedClient, Client
-from ...models.api_response_billing_summary import ApiResponseBillingSummary
+from ...models.api_response_billing_subscription import ApiResponseBillingSubscription
 from ...models.error_response import ErrorResponse
 from ...types import Response
 
@@ -13,7 +13,7 @@ from ...types import Response
 def _get_kwargs() -> dict[str, Any]:
     _kwargs: dict[str, Any] = {
         "method": "get",
-        "url": "/api/billing/summary",
+        "url": "/api/billing/subscription",
     }
 
     return _kwargs
@@ -21,9 +21,9 @@ def _get_kwargs() -> dict[str, Any]:
 
 def _parse_response(
     *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Optional[Union[ApiResponseBillingSummary, ErrorResponse, str]]:
+) -> Optional[Union[ApiResponseBillingSubscription, ErrorResponse, str]]:
     if response.status_code == 200:
-        response_200 = ApiResponseBillingSummary.from_dict(response.json())
+        response_200 = ApiResponseBillingSubscription.from_dict(response.json())
 
         return response_200
 
@@ -44,7 +44,7 @@ def _parse_response(
 
 def _build_response(
     *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Response[Union[ApiResponseBillingSummary, ErrorResponse, str]]:
+) -> Response[Union[ApiResponseBillingSubscription, ErrorResponse, str]]:
     return Response(
         status_code=HTTPStatus(response.status_code),
         content=response.content,
@@ -56,18 +56,18 @@ def _build_response(
 def sync_detailed(
     *,
     client: AuthenticatedClient,
-) -> Response[Union[ApiResponseBillingSummary, ErrorResponse, str]]:
-    """Get billing summary
+) -> Response[Union[ApiResponseBillingSubscription, ErrorResponse, str]]:
+    """Get the subscription's state and the actions it allows
 
-     Returns the selected account's billing state and available actions. Accounts that share billing also
-    share subscription and open-invoice information.
+     Returns the selected account's subscription state and available actions. Accounts that share billing
+    also share subscription and open-invoice information.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[Union[ApiResponseBillingSummary, ErrorResponse, str]]
+        Response[Union[ApiResponseBillingSubscription, ErrorResponse, str]]
     """
 
     kwargs = _get_kwargs()
@@ -82,18 +82,18 @@ def sync_detailed(
 def sync(
     *,
     client: AuthenticatedClient,
-) -> Optional[Union[ApiResponseBillingSummary, ErrorResponse, str]]:
-    """Get billing summary
+) -> Optional[Union[ApiResponseBillingSubscription, ErrorResponse, str]]:
+    """Get the subscription's state and the actions it allows
 
-     Returns the selected account's billing state and available actions. Accounts that share billing also
-    share subscription and open-invoice information.
+     Returns the selected account's subscription state and available actions. Accounts that share billing
+    also share subscription and open-invoice information.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Union[ApiResponseBillingSummary, ErrorResponse, str]
+        Union[ApiResponseBillingSubscription, ErrorResponse, str]
     """
 
     return sync_detailed(
@@ -104,18 +104,18 @@ def sync(
 async def asyncio_detailed(
     *,
     client: AuthenticatedClient,
-) -> Response[Union[ApiResponseBillingSummary, ErrorResponse, str]]:
-    """Get billing summary
+) -> Response[Union[ApiResponseBillingSubscription, ErrorResponse, str]]:
+    """Get the subscription's state and the actions it allows
 
-     Returns the selected account's billing state and available actions. Accounts that share billing also
-    share subscription and open-invoice information.
+     Returns the selected account's subscription state and available actions. Accounts that share billing
+    also share subscription and open-invoice information.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[Union[ApiResponseBillingSummary, ErrorResponse, str]]
+        Response[Union[ApiResponseBillingSubscription, ErrorResponse, str]]
     """
 
     kwargs = _get_kwargs()
@@ -128,18 +128,18 @@ async def asyncio_detailed(
 async def asyncio(
     *,
     client: AuthenticatedClient,
-) -> Optional[Union[ApiResponseBillingSummary, ErrorResponse, str]]:
-    """Get billing summary
+) -> Optional[Union[ApiResponseBillingSubscription, ErrorResponse, str]]:
+    """Get the subscription's state and the actions it allows
 
-     Returns the selected account's billing state and available actions. Accounts that share billing also
-    share subscription and open-invoice information.
+     Returns the selected account's subscription state and available actions. Accounts that share billing
+    also share subscription and open-invoice information.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Union[ApiResponseBillingSummary, ErrorResponse, str]
+        Union[ApiResponseBillingSubscription, ErrorResponse, str]
     """
 
     return (