chore(docs): add missing descriptions

Author: stainless-app[bot]

src/postgrid/_client.py

@@ -113,12 +113,24 @@ def __init__(
 
     @cached_property
     def address_verification(self) -> AddressVerificationResource:
+        """Standard Address Verification API.
+
+        Provides endpoints to verify and standardize addresses across US and Canada,
+        supporting both structured and freeform inputs.
+
+        Note that this uses a different set of lookups than our international API.
+        """
         from .resources.address_verification import AddressVerificationResource
 
         return AddressVerificationResource(self)
 
     @cached_property
     def intl_address_verification(self) -> IntlAddressVerificationResource:
+        """International Address Verification API.
+
+        Provides endpoints to verify and standardize international addresses,
+        supporting both structured and freeform inputs.
+        """
         from .resources.intl_address_verification import IntlAddressVerificationResource
 
         return IntlAddressVerificationResource(self)
@@ -341,12 +353,24 @@ def __init__(
 
     @cached_property
     def address_verification(self) -> AsyncAddressVerificationResource:
+        """Standard Address Verification API.
+
+        Provides endpoints to verify and standardize addresses across US and Canada,
+        supporting both structured and freeform inputs.
+
+        Note that this uses a different set of lookups than our international API.
+        """
         from .resources.address_verification import AsyncAddressVerificationResource
 
         return AsyncAddressVerificationResource(self)
 
     @cached_property
     def intl_address_verification(self) -> AsyncIntlAddressVerificationResource:
+        """International Address Verification API.
+
+        Provides endpoints to verify and standardize international addresses,
+        supporting both structured and freeform inputs.
+        """
         from .resources.intl_address_verification import AsyncIntlAddressVerificationResource
 
         return AsyncIntlAddressVerificationResource(self)
@@ -516,12 +540,24 @@ def __init__(self, client: PostGrid) -> None:
 
     @cached_property
     def address_verification(self) -> address_verification.AddressVerificationResourceWithRawResponse:
+        """Standard Address Verification API.
+
+        Provides endpoints to verify and standardize addresses across US and Canada,
+        supporting both structured and freeform inputs.
+
+        Note that this uses a different set of lookups than our international API.
+        """
         from .resources.address_verification import AddressVerificationResourceWithRawResponse
 
         return AddressVerificationResourceWithRawResponse(self._client.address_verification)
 
     @cached_property
     def intl_address_verification(self) -> intl_address_verification.IntlAddressVerificationResourceWithRawResponse:
+        """International Address Verification API.
+
+        Provides endpoints to verify and standardize international addresses,
+        supporting both structured and freeform inputs.
+        """
         from .resources.intl_address_verification import IntlAddressVerificationResourceWithRawResponse
 
         return IntlAddressVerificationResourceWithRawResponse(self._client.intl_address_verification)
@@ -541,6 +577,13 @@ def __init__(self, client: AsyncPostGrid) -> None:
 
     @cached_property
     def address_verification(self) -> address_verification.AsyncAddressVerificationResourceWithRawResponse:
+        """Standard Address Verification API.
+
+        Provides endpoints to verify and standardize addresses across US and Canada,
+        supporting both structured and freeform inputs.
+
+        Note that this uses a different set of lookups than our international API.
+        """
         from .resources.address_verification import AsyncAddressVerificationResourceWithRawResponse
 
         return AsyncAddressVerificationResourceWithRawResponse(self._client.address_verification)
@@ -549,6 +592,11 @@ def address_verification(self) -> address_verification.AsyncAddressVerificationR
     def intl_address_verification(
         self,
     ) -> intl_address_verification.AsyncIntlAddressVerificationResourceWithRawResponse:
+        """International Address Verification API.
+
+        Provides endpoints to verify and standardize international addresses,
+        supporting both structured and freeform inputs.
+        """
         from .resources.intl_address_verification import AsyncIntlAddressVerificationResourceWithRawResponse
 
         return AsyncIntlAddressVerificationResourceWithRawResponse(self._client.intl_address_verification)
@@ -568,6 +616,13 @@ def __init__(self, client: PostGrid) -> None:
 
     @cached_property
     def address_verification(self) -> address_verification.AddressVerificationResourceWithStreamingResponse:
+        """Standard Address Verification API.
+
+        Provides endpoints to verify and standardize addresses across US and Canada,
+        supporting both structured and freeform inputs.
+
+        Note that this uses a different set of lookups than our international API.
+        """
         from .resources.address_verification import AddressVerificationResourceWithStreamingResponse
 
         return AddressVerificationResourceWithStreamingResponse(self._client.address_verification)
@@ -576,6 +631,11 @@ def address_verification(self) -> address_verification.AddressVerificationResour
     def intl_address_verification(
         self,
     ) -> intl_address_verification.IntlAddressVerificationResourceWithStreamingResponse:
+        """International Address Verification API.
+
+        Provides endpoints to verify and standardize international addresses,
+        supporting both structured and freeform inputs.
+        """
         from .resources.intl_address_verification import IntlAddressVerificationResourceWithStreamingResponse
 
         return IntlAddressVerificationResourceWithStreamingResponse(self._client.intl_address_verification)
@@ -595,6 +655,13 @@ def __init__(self, client: AsyncPostGrid) -> None:
 
     @cached_property
     def address_verification(self) -> address_verification.AsyncAddressVerificationResourceWithStreamingResponse:
+        """Standard Address Verification API.
+
+        Provides endpoints to verify and standardize addresses across US and Canada,
+        supporting both structured and freeform inputs.
+
+        Note that this uses a different set of lookups than our international API.
+        """
         from .resources.address_verification import AsyncAddressVerificationResourceWithStreamingResponse
 
         return AsyncAddressVerificationResourceWithStreamingResponse(self._client.address_verification)
@@ -603,6 +670,11 @@ def address_verification(self) -> address_verification.AsyncAddressVerificationR
     def intl_address_verification(
         self,
     ) -> intl_address_verification.AsyncIntlAddressVerificationResourceWithStreamingResponse:
+        """International Address Verification API.
+
+        Provides endpoints to verify and standardize international addresses,
+        supporting both structured and freeform inputs.
+        """
         from .resources.intl_address_verification import AsyncIntlAddressVerificationResourceWithStreamingResponse
 
         return AsyncIntlAddressVerificationResourceWithStreamingResponse(self._client.intl_address_verification)

src/postgrid/resources/address_verification.py

@@ -24,6 +24,14 @@
 
 
 class AddressVerificationResource(SyncAPIResource):
+    """Standard Address Verification API.
+
+    Provides endpoints to verify and standardize addresses across US and Canada,
+    supporting both structured and freeform inputs.
+
+    Note that this uses a different set of lookups than our international API.
+    """
+
     @cached_property
     def with_raw_response(self) -> AddressVerificationResourceWithRawResponse:
         """
@@ -162,6 +170,14 @@ def verify(
 
 
 class AsyncAddressVerificationResource(AsyncAPIResource):
+    """Standard Address Verification API.
+
+    Provides endpoints to verify and standardize addresses across US and Canada,
+    supporting both structured and freeform inputs.
+
+    Note that this uses a different set of lookups than our international API.
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncAddressVerificationResourceWithRawResponse:
         """

src/postgrid/resources/intl_address_verification.py

@@ -24,6 +24,12 @@
 
 
 class IntlAddressVerificationResource(SyncAPIResource):
+    """International Address Verification API.
+
+    Provides endpoints to verify and standardize international addresses,
+    supporting both structured and freeform inputs.
+    """
+
     @cached_property
     def with_raw_response(self) -> IntlAddressVerificationResourceWithRawResponse:
         """
@@ -152,6 +158,12 @@ def verify(
 
 
 class AsyncIntlAddressVerificationResource(AsyncAPIResource):
+    """International Address Verification API.
+
+    Provides endpoints to verify and standardize international addresses,
+    supporting both structured and freeform inputs.
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncIntlAddressVerificationResourceWithRawResponse:
         """

src/postgrid/resources/print_mail/campaigns.py

@@ -32,6 +32,11 @@
 
 
 class CampaignsResource(SyncAPIResource):
+    """
+    The campaigns API enables you to send out large volumes of fully
+     personalized mail to a mailing list.
+    """
+
     @cached_property
     def with_raw_response(self) -> CampaignsResourceWithRawResponse:
         """
@@ -378,6 +383,11 @@ def send(
 
 
 class AsyncCampaignsResource(AsyncAPIResource):
+    """
+    The campaigns API enables you to send out large volumes of fully
+     personalized mail to a mailing list.
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncCampaignsResourceWithRawResponse:
         """

src/postgrid/resources/print_mail/mailing_list_imports.py

@@ -32,6 +32,11 @@
 
 
 class MailingListImportsResource(SyncAPIResource):
+    """
+    The mailing list imports API enables you to import contact lists from files
+     and validate them for use in campaigns.
+    """
+
     @cached_property
     def with_raw_response(self) -> MailingListImportsResourceWithRawResponse:
         """
@@ -298,6 +303,11 @@ def delete(
 
 
 class AsyncMailingListImportsResource(AsyncAPIResource):
+    """
+    The mailing list imports API enables you to import contact lists from files
+     and validate them for use in campaigns.
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncMailingListImportsResourceWithRawResponse:
         """

src/postgrid/resources/print_mail/order_profiles/cheques.py

@@ -47,6 +47,14 @@
 
 
 class ChequesResource(SyncAPIResource):
+    """
+    Order Profiles are reusable blueprints for creating print and mail orders (Letters, Postcards, Cheques, Self-Mailers).
+     They define common properties like size, content (via templates or uploaded PDFs), mailing class, and metadata.
+     Using profiles simplifies order creation, especially for recurring mailings or campaigns, by pre-filling many parameters.
+
+     Profiles are environment-specific (live vs. test).
+    """
+
     @cached_property
     def with_raw_response(self) -> ChequesResourceWithRawResponse:
         """
@@ -445,6 +453,14 @@ def delete(
 
 
 class AsyncChequesResource(AsyncAPIResource):
+    """
+    Order Profiles are reusable blueprints for creating print and mail orders (Letters, Postcards, Cheques, Self-Mailers).
+     They define common properties like size, content (via templates or uploaded PDFs), mailing class, and metadata.
+     Using profiles simplifies order creation, especially for recurring mailings or campaigns, by pre-filling many parameters.
+
+     Profiles are environment-specific (live vs. test).
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncChequesResourceWithRawResponse:
         """

src/postgrid/resources/print_mail/order_profiles/letters.py

@@ -36,6 +36,14 @@
 
 
 class LettersResource(SyncAPIResource):
+    """
+    Order Profiles are reusable blueprints for creating print and mail orders (Letters, Postcards, Cheques, Self-Mailers).
+     They define common properties like size, content (via templates or uploaded PDFs), mailing class, and metadata.
+     Using profiles simplifies order creation, especially for recurring mailings or campaigns, by pre-filling many parameters.
+
+     Profiles are environment-specific (live vs. test).
+    """
+
     @cached_property
     def with_raw_response(self) -> LettersResourceWithRawResponse:
         """
@@ -442,6 +450,14 @@ def delete(
 
 
 class AsyncLettersResource(AsyncAPIResource):
+    """
+    Order Profiles are reusable blueprints for creating print and mail orders (Letters, Postcards, Cheques, Self-Mailers).
+     They define common properties like size, content (via templates or uploaded PDFs), mailing class, and metadata.
+     Using profiles simplifies order creation, especially for recurring mailings or campaigns, by pre-filling many parameters.
+
+     Profiles are environment-specific (live vs. test).
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncLettersResourceWithRawResponse:
         """