feat(api): add customer entitlement-grants list endpoint and feature integration config

Stainless-Generated-From: 02a1bc4

Author: dodo-squirrels[bot]

CHANGELOG.md

@@ -1,13 +1,5 @@
 # Changelog
 
-## [1.106.1](https://github.com/dodopayments/dodopayments-python/compare/v1.106.0...v1.106.1) (2026-06-27)
-
-
-### Bug Fixes
-
-* **api:** add allow_editing_addons checkout flag and refine schema descriptions ([8f9a015](https://github.com/dodopayments/dodopayments-python/commit/8f9a015b340a816d1f643069ff51909e76912f89))
-* **api:** add allow_editing_addons checkout flag and refine schema descriptions ([d578037](https://github.com/dodopayments/dodopayments-python/commit/d578037d7c376ef86571a5b3eec465085ce1105f))
-
 ## [1.106.0](https://github.com/dodopayments/dodopayments-python/compare/v1.105.1...v1.106.0) (2026-06-23)
 
 

scripts/mock

@@ -187,6 +187,12 @@ def update(
           integration_config: Integration-specific configuration supplied when creating or updating an
               entitlement. The shape required matches the entitlement's `integration_type`.
 
+              Untagged enum: variants are matched in order. `FeatureFlag` must precede
+              `LicenseKey`, whose fields are all optional and would otherwise match a
+              `feature_flag` config.
+
+          metadata: Arbitrary key-value metadata. Values can be string, integer, number, or boolean.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -218,7 +224,7 @@ def list(
         self,
         *,
         integration_type: Literal[
-            "discord", "telegram", "github", "figma", "framer", "notion", "digital_files", "license_key"
+            "discord", "telegram", "github", "figma", "framer", "notion", "digital_files", "license_key", "feature_flag"
         ]
         | Omit = omit,
         page_number: int | Omit = omit,
@@ -441,6 +447,12 @@ async def update(
           integration_config: Integration-specific configuration supplied when creating or updating an
               entitlement. The shape required matches the entitlement's `integration_type`.
 
+              Untagged enum: variants are matched in order. `FeatureFlag` must precede
+              `LicenseKey`, whose fields are all optional and would otherwise match a
+              `feature_flag` config.
+
+          metadata: Arbitrary key-value metadata. Values can be string, integer, number, or boolean.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -472,7 +484,7 @@ def list(
         self,
         *,
         integration_type: Literal[
-            "discord", "telegram", "github", "figma", "framer", "notion", "digital_files", "license_key"
+            "discord", "telegram", "github", "figma", "framer", "notion", "digital_files", "license_key", "feature_flag"
         ]
         | Omit = omit,
         page_number: int | Omit = omit,

src/dodopayments/resources/entitlements/entitlements.py

@@ -302,6 +302,8 @@ def update(
               the invoice instead of the customer's personal name. Send `null` to explicitly
               clear the business name.
 
+          metadata: Arbitrary key-value metadata. Values can be string, integer, number, or boolean.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1111,6 +1113,8 @@ async def update(
               the invoice instead of the customer's personal name. Send `null` to explicitly
               clear the business name.
 
+          metadata: Arbitrary key-value metadata. Values can be string, integer, number, or boolean.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request

src/dodopayments/resources/subscriptions.py

@@ -38,6 +38,10 @@ class BalanceListGrantsResponse(BaseModel):
     expires_at: Optional[datetime] = None
 
     metadata: Optional[Metadata] = None
+    """Arbitrary key-value metadata.
+
+    Values can be string, integer, number, or boolean.
+    """
 
     parent_grant_id: Optional[str] = None
 

src/dodopayments/types/credit_entitlements/balance_list_grants_response.py

@@ -27,6 +27,10 @@ class Discount(BaseModel):
     """The unique discount ID"""
 
     metadata: Metadata
+    """Arbitrary key-value metadata.
+
+    Values can be string, integer, number, or boolean.
+    """
 
     preserve_on_plan_change: bool
     """

src/dodopayments/types/discount.py

@@ -5,5 +5,5 @@
 __all__ = ["EntitlementIntegrationType"]
 
 EntitlementIntegrationType: TypeAlias = Literal[
-    "discord", "telegram", "github", "figma", "framer", "notion", "digital_files", "license_key"
+    "discord", "telegram", "github", "figma", "framer", "notion", "digital_files", "license_key", "feature_flag"
 ]

src/dodopayments/types/entitlement_integration_type.py

@@ -9,7 +9,7 @@
 
 class EntitlementListParams(TypedDict, total=False):
     integration_type: Literal[
-        "discord", "telegram", "github", "figma", "framer", "notion", "digital_files", "license_key"
+        "discord", "telegram", "github", "figma", "framer", "notion", "digital_files", "license_key", "feature_flag"
     ]
     """Filter by integration type"""
 

src/dodopayments/types/entitlement_list_params.py

@@ -18,8 +18,16 @@ class EntitlementUpdateParams(TypedDict, total=False):
     """
     Integration-specific configuration supplied when creating or updating an
     entitlement. The shape required matches the entitlement's `integration_type`.
+
+    Untagged enum: variants are matched in order. `FeatureFlag` must precede
+    `LicenseKey`, whose fields are all optional and would otherwise match a
+    `feature_flag` config.
     """
 
     metadata: Optional[MetadataParam]
+    """Arbitrary key-value metadata.
+
+    Values can be string, integer, number, or boolean.
+    """
 
     name: Optional[str]

src/dodopayments/types/entitlement_update_params.py

@@ -10,7 +10,20 @@
 from ..digital_product_delivery import DigitalProductDelivery
 from ..entitlement_integration_type import EntitlementIntegrationType
 
-__all__ = ["EntitlementGrant"]
+__all__ = ["EntitlementGrant", "Feature"]
+
+
+class Feature(BaseModel):
+    """
+    Typed feature payload, present only when the entitlement integration is
+    `feature_flag`; `null` for every other integration type.
+    """
+
+    feature_id: str
+    """Identifier of the capability this grant confers."""
+
+    feature_type: Literal["boolean"]
+    """Type of capability conferred."""
 
 
 class EntitlementGrant(BaseModel):
@@ -64,6 +77,12 @@ class EntitlementGrant(BaseModel):
     error_message: Optional[str] = None
     """Human-readable message reported when delivery failed, when applicable."""
 
+    feature: Optional[Feature] = None
+    """
+    Typed feature payload, present only when the entitlement integration is
+    `feature_flag`; `null` for every other integration type.
+    """
+
     license_key: Optional[LicenseKeyGrant] = None
     """
     License-key delivery payload, present when the entitlement integration is