diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index d484554e9..68b7001a1 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.403.0"
+  ".": "0.404.0"
 }
\ No newline at end of file
diff --git a/.stats.yml b/.stats.yml
index fe442fee6..5c11eef91 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 229
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-f24e91d60005894c135a6ccad84e179e0a2cb64def7e1101904c430a8e5e5dd9.yml
-openapi_spec_hash: a63e06588ae354c03b68d6cb9d965e11
-config_hash: ca1425272e17fa23d4466d33492334fa
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-d3646347697623deab851a220ce4b217e923bde3b3108af9eceb4da6df0534e2.yml
+openapi_spec_hash: 516fabeef616c695941d3a4aa4051f76
+config_hash: b6f365add90e618b2174634df140826e
diff --git a/CHANGELOG.md b/CHANGELOG.md
index aeddc0a80..a7356d442 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.404.0 (2025-12-04)
+
+Full Changelog: [v0.403.0...v0.404.0](https://github.com/Increase/increase-python/compare/v0.403.0...v0.404.0)
+
+### Features
+
+* **api:** api update ([2f0a505](https://github.com/Increase/increase-python/commit/2f0a5057568f909b3fca37ec3404b8728d684a39))
+
+
+### Chores
+
+* **docs:** use environment variables for authentication in code snippets ([6597cb7](https://github.com/Increase/increase-python/commit/6597cb7ea5a7698345b505a09f191ab8cf355644))
+* update lockfile ([d29939b](https://github.com/Increase/increase-python/commit/d29939be35567c02153df62140700c2bec7b4e64))
+
 ## 0.403.0 (2025-12-01)
 
 Full Changelog: [v0.402.1...v0.403.0](https://github.com/Increase/increase-python/compare/v0.402.1...v0.403.0)
diff --git a/README.md b/README.md
index b3415e44f..4edd8177b 100644
--- a/README.md
+++ b/README.md
@@ -89,6 +89,7 @@ pip install increase[aiohttp]
 Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
 
 ```python
+import os
 import asyncio
 from increase import DefaultAioHttpClient
 from increase import AsyncIncrease
@@ -96,7 +97,7 @@ from increase import AsyncIncrease
 
 async def main() -> None:
     async with AsyncIncrease(
-        api_key="My API Key",
+        api_key=os.environ.get("INCREASE_API_KEY"),  # This is the default and can be omitted
         http_client=DefaultAioHttpClient(),
     ) as client:
         account = await client.accounts.create(
diff --git a/pyproject.toml b/pyproject.toml
index 7b55156f2..341ddcf07 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,20 +1,22 @@
 [project]
 name = "increase"
-version = "0.403.0"
+version = "0.404.0"
 description = "The official Python library for the increase API"
 dynamic = ["readme"]
 license = "Apache-2.0"
 authors = [
 { name = "Increase", email = "dev-feedback@increase.com" },
 ]
+
 dependencies = [
-    "httpx>=0.23.0, <1",
-    "pydantic>=1.9.0, <3",
-    "typing-extensions>=4.10, <5",
-    "anyio>=3.5.0, <5",
-    "distro>=1.7.0, <2",
-    "sniffio",
+  "httpx>=0.23.0, <1",
+  "pydantic>=1.9.0, <3",
+  "typing-extensions>=4.10, <5",
+  "anyio>=3.5.0, <5",
+  "distro>=1.7.0, <2",
+  "sniffio",
 ]
+
 requires-python = ">= 3.9"
 classifiers = [
   "Typing :: Typed",
diff --git a/requirements-dev.lock b/requirements-dev.lock
index 6cfc1ea75..b89977af4 100644
--- a/requirements-dev.lock
+++ b/requirements-dev.lock
@@ -12,40 +12,45 @@
 -e file:.
 aiohappyeyeballs==2.6.1
     # via aiohttp
-aiohttp==3.12.8
+aiohttp==3.13.2
     # via httpx-aiohttp
     # via increase
-aiosignal==1.3.2
+aiosignal==1.4.0
     # via aiohttp
-annotated-types==0.6.0
+annotated-types==0.7.0
     # via pydantic
-anyio==4.4.0
+anyio==4.12.0
     # via httpx
     # via increase
-argcomplete==3.1.2
+argcomplete==3.6.3
     # via nox
 async-timeout==5.0.1
     # via aiohttp
-attrs==25.3.0
+attrs==25.4.0
     # via aiohttp
-certifi==2023.7.22
+    # via nox
+backports-asyncio-runner==1.2.0
+    # via pytest-asyncio
+certifi==2025.11.12
     # via httpcore
     # via httpx
-colorlog==6.7.0
+colorlog==6.10.1
+    # via nox
+dependency-groups==1.3.1
     # via nox
-dirty-equals==0.6.0
-distlib==0.3.7
+dirty-equals==0.11
+distlib==0.4.0
     # via virtualenv
-distro==1.8.0
+distro==1.9.0
     # via increase
-exceptiongroup==1.2.2
+exceptiongroup==1.3.1
     # via anyio
     # via pytest
-execnet==2.1.1
+execnet==2.1.2
     # via pytest-xdist
-filelock==3.12.4
+filelock==3.19.1
     # via virtualenv
-frozenlist==1.6.2
+frozenlist==1.8.0
     # via aiohttp
     # via aiosignal
 h11==0.16.0
@@ -58,82 +63,87 @@ httpx==0.28.1
     # via respx
 httpx-aiohttp==0.1.9
     # via increase
-idna==3.4
+humanize==4.13.0
+    # via nox
+idna==3.11
     # via anyio
     # via httpx
     # via yarl
-importlib-metadata==7.0.0
-iniconfig==2.0.0
+importlib-metadata==8.7.0
+iniconfig==2.1.0
     # via pytest
 markdown-it-py==3.0.0
     # via rich
 mdurl==0.1.2
     # via markdown-it-py
-multidict==6.4.4
+multidict==6.7.0
     # via aiohttp
     # via yarl
 mypy==1.17.0
-mypy-extensions==1.0.0
+mypy-extensions==1.1.0
     # via mypy
-nodeenv==1.8.0
+nodeenv==1.9.1
     # via pyright
-nox==2023.4.22
-packaging==23.2
+nox==2025.11.12
+packaging==25.0
+    # via dependency-groups
     # via nox
     # via pytest
 pathspec==0.12.1
     # via mypy
-platformdirs==3.11.0
+platformdirs==4.4.0
     # via virtualenv
-pluggy==1.5.0
+pluggy==1.6.0
     # via pytest
-propcache==0.3.1
+propcache==0.4.1
     # via aiohttp
     # via yarl
-pydantic==2.11.9
+pydantic==2.12.5
     # via increase
-pydantic-core==2.33.2
+pydantic-core==2.41.5
     # via pydantic
-pygments==2.18.0
+pygments==2.19.2
+    # via pytest
     # via rich
 pyright==1.1.399
-pytest==8.3.3
+pytest==8.4.2
     # via pytest-asyncio
     # via pytest-xdist
-pytest-asyncio==0.24.0
-pytest-xdist==3.7.0
-python-dateutil==2.8.2
+pytest-asyncio==1.2.0
+pytest-xdist==3.8.0
+python-dateutil==2.9.0.post0
     # via time-machine
-pytz==2023.3.post1
-    # via dirty-equals
 respx==0.22.0
-rich==13.7.1
-ruff==0.9.4
-setuptools==68.2.2
-    # via nodeenv
-six==1.16.0
+rich==14.2.0
+ruff==0.14.7
+six==1.17.0
     # via python-dateutil
-sniffio==1.3.0
-    # via anyio
+sniffio==1.3.1
     # via increase
-time-machine==2.9.0
-tomli==2.0.2
+time-machine==2.19.0
+tomli==2.3.0
+    # via dependency-groups
     # via mypy
+    # via nox
     # via pytest
-typing-extensions==4.12.2
+typing-extensions==4.15.0
+    # via aiosignal
     # via anyio
+    # via exceptiongroup
     # via increase
     # via multidict
     # via mypy
     # via pydantic
     # via pydantic-core
     # via pyright
+    # via pytest-asyncio
     # via typing-inspection
-typing-inspection==0.4.1
+    # via virtualenv
+typing-inspection==0.4.2
     # via pydantic
-virtualenv==20.24.5
+virtualenv==20.35.4
     # via nox
-yarl==1.20.0
+yarl==1.22.0
     # via aiohttp
-zipp==3.17.0
+zipp==3.23.0
     # via importlib-metadata
diff --git a/requirements.lock b/requirements.lock
index 7f4bff497..db5859e44 100644
--- a/requirements.lock
+++ b/requirements.lock
@@ -12,28 +12,28 @@
 -e file:.
 aiohappyeyeballs==2.6.1
     # via aiohttp
-aiohttp==3.12.8
+aiohttp==3.13.2
     # via httpx-aiohttp
     # via increase
-aiosignal==1.3.2
+aiosignal==1.4.0
     # via aiohttp
-annotated-types==0.6.0
+annotated-types==0.7.0
     # via pydantic
-anyio==4.4.0
+anyio==4.12.0
     # via httpx
     # via increase
 async-timeout==5.0.1
     # via aiohttp
-attrs==25.3.0
+attrs==25.4.0
     # via aiohttp
-certifi==2023.7.22
+certifi==2025.11.12
     # via httpcore
     # via httpx
-distro==1.8.0
+distro==1.9.0
     # via increase
-exceptiongroup==1.2.2
+exceptiongroup==1.3.1
     # via anyio
-frozenlist==1.6.2
+frozenlist==1.8.0
     # via aiohttp
     # via aiosignal
 h11==0.16.0
@@ -45,25 +45,26 @@ httpx==0.28.1
     # via increase
 httpx-aiohttp==0.1.9
     # via increase
-idna==3.4
+idna==3.11
     # via anyio
     # via httpx
     # via yarl
-multidict==6.4.4
+multidict==6.7.0
     # via aiohttp
     # via yarl
-propcache==0.3.1
+propcache==0.4.1
     # via aiohttp
     # via yarl
 pydantic==2.12.5
     # via increase
 pydantic-core==2.41.5
     # via pydantic
-sniffio==1.3.0
-    # via anyio
+sniffio==1.3.1
     # via increase
 typing-extensions==4.15.0
+    # via aiosignal
     # via anyio
+    # via exceptiongroup
     # via increase
     # via multidict
     # via pydantic
@@ -71,5 +72,5 @@ typing-extensions==4.15.0
     # via typing-inspection
 typing-inspection==0.4.2
     # via pydantic
-yarl==1.20.0
+yarl==1.22.0
     # via aiohttp
diff --git a/src/increase/_version.py b/src/increase/_version.py
index bf0f091d1..edea8e76f 100644
--- a/src/increase/_version.py
+++ b/src/increase/_version.py
@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "increase"
-__version__ = "0.403.0"  # x-release-please-version
+__version__ = "0.404.0"  # x-release-please-version
diff --git a/src/increase/types/real_time_decision.py b/src/increase/types/real_time_decision.py
index 3de77429d..ebe9f4f02 100644
--- a/src/increase/types/real_time_decision.py
+++ b/src/increase/types/real_time_decision.py
@@ -24,6 +24,7 @@
     "CardAuthorizationAdditionalAmountsTransit",
     "CardAuthorizationAdditionalAmountsUnknown",
     "CardAuthorizationAdditionalAmountsVision",
+    "CardAuthorizationApproval",
     "CardAuthorizationDecline",
     "CardAuthorizationNetworkDetails",
     "CardAuthorizationNetworkDetailsPulse",
@@ -274,6 +275,14 @@ class CardAuthorizationAdditionalAmounts(BaseModel):
     """The part of this transaction amount that was for vision-related services."""
 
 
+class CardAuthorizationApproval(BaseModel):
+    partial_amount: Optional[int] = None
+    """
+    If the authorization was partially approved, this field contains the approved
+    amount in the minor unit of the settlement currency.
+    """
+
+
 class CardAuthorizationDecline(BaseModel):
     reason: Literal[
         "insufficient_funds",
@@ -572,6 +581,12 @@ class CardAuthorization(BaseModel):
     to provide more detailed information about the transaction.
     """
 
+    approval: Optional[CardAuthorizationApproval] = None
+    """Present if and only if `decision` is `approve`.
+
+    Contains information related to the approval of the authorization.
+    """
+
     card_id: str
     """The identifier of the Card that is being authorized."""
 
@@ -650,6 +665,13 @@ class CardAuthorization(BaseModel):
     riskiest.
     """
 
+    partial_approval_capability: Literal["supported", "not_supported"]
+    """Whether or not the authorization supports partial approvals.
+
+    - `supported` - This transaction supports partial approvals.
+    - `not_supported` - This transaction does not support partial approvals.
+    """
+
     physical_card_id: Optional[str] = None
     """
     If the authorization was made in-person with a physical card, the Physical Card
diff --git a/src/increase/types/real_time_decision_action_params.py b/src/increase/types/real_time_decision_action_params.py
index b4a73334b..7f3792ab5 100644
--- a/src/increase/types/real_time_decision_action_params.py
+++ b/src/increase/types/real_time_decision_action_params.py
@@ -108,6 +108,14 @@ class CardAuthorizationApproval(TypedDict, total=False):
     guide.
     """
 
+    partial_amount: int
+    """
+    If the transaction supports partial approvals
+    (`partial_approval_capability: supported`) the `partial_amount` can be provided
+    in the transaction's settlement currency to approve a lower amount than was
+    requested.
+    """
+
 
 class CardAuthorizationDecline(TypedDict, total=False):
     reason: Required[
diff --git a/tests/api_resources/test_real_time_decisions.py b/tests/api_resources/test_real_time_decisions.py
index 3cc0575b9..a547359a4 100644
--- a/tests/api_resources/test_real_time_decisions.py
+++ b/tests/api_resources/test_real_time_decisions.py
@@ -74,7 +74,8 @@ def test_method_action_with_all_params(self, client: Increase) -> None:
                     "cardholder_address_verification_result": {
                         "line1": "match",
                         "postal_code": "no_match",
-                    }
+                    },
+                    "partial_amount": 1,
                 },
                 "decline": {"reason": "insufficient_funds"},
             },
@@ -189,7 +190,8 @@ async def test_method_action_with_all_params(self, async_client: AsyncIncrease)
                     "cardholder_address_verification_result": {
                         "line1": "match",
                         "postal_code": "no_match",
-                    }
+                    },
+                    "partial_amount": 1,
                 },
                 "decline": {"reason": "insufficient_funds"},
             },