feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 40
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sent%2Fsent-dm-38aaadafbb2bf0c5d5bb9330a0a5e7a89052fe3e791569c8a12051e040193edf.yml
-openapi_spec_hash: 2d35c1223beebaf2c1b8d8a474cbf7c2
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sent%2Fsent-dm-2566cdc5d8e0bffe2a8c442692b0fc1b35d3bfe7e9bf578331fc19d402361c1f.yml
+openapi_spec_hash: 85e1feeb9bbc8d59bb34d6cdd679575a
 config_hash: ad652575976c2c8db09e4575778f0e77

src/sent_dm/resources/messages.py

@@ -153,7 +153,8 @@ def send(
           sandbox: Sandbox flag - when true, the operation is simulated without side effects Useful
               for testing integrations without actual execution
 
-          template: Template reference (by id or name, with optional parameters)
+          template: SDK-style template reference: resolve by ID or by name, with optional
+              parameters.
 
           to: List of recipient phone numbers in E.164 format (multi-recipient fan-out)
 
@@ -320,7 +321,8 @@ async def send(
           sandbox: Sandbox flag - when true, the operation is simulated without side effects Useful
               for testing integrations without actual execution
 
-          template: Template reference (by id or name, with optional parameters)
+          template: SDK-style template reference: resolve by ID or by name, with optional
+              parameters.
 
           to: List of recipient phone numbers in E.164 format (multi-recipient fan-out)
 

src/sent_dm/resources/profiles/campaigns.py

@@ -66,7 +66,7 @@ def create(
         campaign must include at least one use case with sample messages.
 
         Args:
-          campaign: Campaign data
+          campaign: Campaign data for create or update operation
 
           sandbox: Sandbox flag - when true, the operation is simulated without side effects Useful
               for testing integrations without actual execution
@@ -127,7 +127,7 @@ def update(
         update campaigns that have already been submitted to TCR.
 
         Args:
-          campaign: Campaign data
+          campaign: Campaign data for create or update operation
 
           sandbox: Sandbox flag - when true, the operation is simulated without side effects Useful
               for testing integrations without actual execution
@@ -293,7 +293,7 @@ async def create(
         campaign must include at least one use case with sample messages.
 
         Args:
-          campaign: Campaign data
+          campaign: Campaign data for create or update operation
 
           sandbox: Sandbox flag - when true, the operation is simulated without side effects Useful
               for testing integrations without actual execution
@@ -354,7 +354,7 @@ async def update(
         update campaigns that have already been submitted to TCR.
 
         Args:
-          campaign: Campaign data
+          campaign: Campaign data for create or update operation
 
           sandbox: Sandbox flag - when true, the operation is simulated without side effects Useful
               for testing integrations without actual execution

src/sent_dm/resources/profiles/profiles.py

@@ -139,9 +139,8 @@ def create(
 
           allow_template_sharing: Whether templates are shared across profiles (default: false)
 
-          billing_contact: Billing contact for this profile. Required when billing_model is "profile" or
-              "profile_and_organization". Identifies who receives invoices and who is
-              responsible for payment.
+          billing_contact: Billing contact information for a profile. Required when billing_model is
+              "profile" or "profile_and_organization".
 
           billing_model:
               Billing model: profile, organization, or profile_and_organization (default:
@@ -153,9 +152,7 @@ def create(
               - "profile_and_organization": the profile is billed first with the organization
                 as fallback; billing_contact is required.
 
-          brand: Brand and KYC information for this profile (optional). When provided, creates
-              the brand associated with this profile. Cannot be set when inherit_tcr_brand is
-              true.
+          brand: Brand and KYC data grouped into contact, business, and compliance sections
 
           description: Profile description (optional)
 
@@ -171,9 +168,9 @@ def create(
 
           name: Profile name (required)
 
-          payment_details: Payment card details for this profile (optional). Accepted when billing_model is
-              "profile" or "profile_and_organization". Not persisted on our servers —
-              forwarded to the payment processor.
+          payment_details: Payment card details for a profile. Accepted when billing_model is "profile" or
+              "profile_and_organization". These details are not stored on our servers and will
+              be forwarded to the payment processor.
 
           sandbox: Sandbox flag - when true, the operation is simulated without side effects Useful
               for testing integrations without actual execution
@@ -182,11 +179,11 @@ def create(
               only letters, numbers, and spaces, and include at least one letter. Example:
               "SALES", "Mkt 2", "Support1".
 
-          whatsapp_business_account: Direct WhatsApp Business Account credentials for this profile. When provided,
-              the profile uses its own WhatsApp Business Account instead of inheriting from
-              the organization. When omitted, the profile inherits the organization's WhatsApp
-              Business Account (requires the organization to have completed WhatsApp Embedded
-              Signup).
+          whatsapp_business_account: Direct WhatsApp Business Account credentials for a profile. Use this when the
+              profile should have its own WhatsApp Business Account instead of inheriting from
+              the organization. Credentials must be obtained from Meta Business Manager by
+              creating a System User with whatsapp_business_messaging and
+              whatsapp_business_management scopes.
 
           extra_headers: Send extra headers
 
@@ -332,9 +329,8 @@ def update(
 
           allow_template_sharing: Whether templates are shared across profiles (optional)
 
-          billing_contact: Billing contact for this profile. Required when billing_model is "profile" or
-              "profile_and_organization" and no billing contact has been configured yet.
-              Identifies who receives invoices and who is responsible for payment.
+          billing_contact: Billing contact information for a profile. Required when billing_model is
+              "profile" or "profile_and_organization".
 
           billing_model: Billing model: profile, organization, or profile_and_organization (optional).
 
@@ -344,10 +340,7 @@ def update(
               - "profile_and_organization": the profile is billed first with the organization
                 as fallback; billing_contact is required.
 
-          brand: Brand and KYC information for this profile (optional). When provided, creates or
-              updates the brand associated with this profile. Cannot be set when
-              inherit_tcr_brand is true. Once a brand has been submitted to TCR it cannot be
-              modified.
+          brand: Brand and KYC data grouped into contact, business, and compliance sections
 
           description: Profile description (optional)
 
@@ -363,9 +356,9 @@ def update(
 
           name: Profile name (optional)
 
-          payment_details: Payment card details for this profile (optional). Accepted when billing_model is
-              "profile" or "profile_and_organization". Not persisted on our servers —
-              forwarded to the payment processor.
+          payment_details: Payment card details for a profile. Accepted when billing_model is "profile" or
+              "profile_and_organization". These details are not stored on our servers and will
+              be forwarded to the payment processor.
 
           sandbox: Sandbox flag - when true, the operation is simulated without side effects Useful
               for testing integrations without actual execution
@@ -687,9 +680,8 @@ async def create(
 
           allow_template_sharing: Whether templates are shared across profiles (default: false)
 
-          billing_contact: Billing contact for this profile. Required when billing_model is "profile" or
-              "profile_and_organization". Identifies who receives invoices and who is
-              responsible for payment.
+          billing_contact: Billing contact information for a profile. Required when billing_model is
+              "profile" or "profile_and_organization".
 
           billing_model:
               Billing model: profile, organization, or profile_and_organization (default:
@@ -701,9 +693,7 @@ async def create(
               - "profile_and_organization": the profile is billed first with the organization
                 as fallback; billing_contact is required.
 
-          brand: Brand and KYC information for this profile (optional). When provided, creates
-              the brand associated with this profile. Cannot be set when inherit_tcr_brand is
-              true.
+          brand: Brand and KYC data grouped into contact, business, and compliance sections
 
           description: Profile description (optional)
 
@@ -719,9 +709,9 @@ async def create(
 
           name: Profile name (required)
 
-          payment_details: Payment card details for this profile (optional). Accepted when billing_model is
-              "profile" or "profile_and_organization". Not persisted on our servers —
-              forwarded to the payment processor.
+          payment_details: Payment card details for a profile. Accepted when billing_model is "profile" or
+              "profile_and_organization". These details are not stored on our servers and will
+              be forwarded to the payment processor.
 
           sandbox: Sandbox flag - when true, the operation is simulated without side effects Useful
               for testing integrations without actual execution
@@ -730,11 +720,11 @@ async def create(
               only letters, numbers, and spaces, and include at least one letter. Example:
               "SALES", "Mkt 2", "Support1".
 
-          whatsapp_business_account: Direct WhatsApp Business Account credentials for this profile. When provided,
-              the profile uses its own WhatsApp Business Account instead of inheriting from
-              the organization. When omitted, the profile inherits the organization's WhatsApp
-              Business Account (requires the organization to have completed WhatsApp Embedded
-              Signup).
+          whatsapp_business_account: Direct WhatsApp Business Account credentials for a profile. Use this when the
+              profile should have its own WhatsApp Business Account instead of inheriting from
+              the organization. Credentials must be obtained from Meta Business Manager by
+              creating a System User with whatsapp_business_messaging and
+              whatsapp_business_management scopes.
 
           extra_headers: Send extra headers
 
@@ -880,9 +870,8 @@ async def update(
 
           allow_template_sharing: Whether templates are shared across profiles (optional)
 
-          billing_contact: Billing contact for this profile. Required when billing_model is "profile" or
-              "profile_and_organization" and no billing contact has been configured yet.
-              Identifies who receives invoices and who is responsible for payment.
+          billing_contact: Billing contact information for a profile. Required when billing_model is
+              "profile" or "profile_and_organization".
 
           billing_model: Billing model: profile, organization, or profile_and_organization (optional).
 
@@ -892,10 +881,7 @@ async def update(
               - "profile_and_organization": the profile is billed first with the organization
                 as fallback; billing_contact is required.
 
-          brand: Brand and KYC information for this profile (optional). When provided, creates or
-              updates the brand associated with this profile. Cannot be set when
-              inherit_tcr_brand is true. Once a brand has been submitted to TCR it cannot be
-              modified.
+          brand: Brand and KYC data grouped into contact, business, and compliance sections
 
           description: Profile description (optional)
 
@@ -911,9 +897,9 @@ async def update(
 
           name: Profile name (optional)
 
-          payment_details: Payment card details for this profile (optional). Accepted when billing_model is
-              "profile" or "profile_and_organization". Not persisted on our servers —
-              forwarded to the payment processor.
+          payment_details: Payment card details for a profile. Accepted when billing_model is "profile" or
+              "profile_and_organization". These details are not stored on our servers and will
+              be forwarded to the payment processor.
 
           sandbox: Sandbox flag - when true, the operation is simulated without side effects Useful
               for testing integrations without actual execution

src/sent_dm/resources/templates.py

@@ -82,7 +82,8 @@ def create(
 
           creation_source: Source of template creation (default: from-api)
 
-          definition: Template definition including header, body, footer, and buttons
+          definition: Complete definition of a message template including header, body, footer, and
+              buttons
 
           language: Template language code (e.g., en_US) (optional, auto-detected if not provided)
 
@@ -190,7 +191,8 @@ def update(
         Args:
           category: Template category: MARKETING, UTILITY, AUTHENTICATION
 
-          definition: Template definition including header, body, footer, and buttons
+          definition: Complete definition of a message template including header, body, footer, and
+              buttons
 
           language: Template language code (e.g., en_US)
 
@@ -410,7 +412,8 @@ async def create(
 
           creation_source: Source of template creation (default: from-api)
 
-          definition: Template definition including header, body, footer, and buttons
+          definition: Complete definition of a message template including header, body, footer, and
+              buttons
 
           language: Template language code (e.g., en_US) (optional, auto-detected if not provided)
 
@@ -518,7 +521,8 @@ async def update(
         Args:
           category: Template category: MARKETING, UTILITY, AUTHENTICATION
 
-          definition: Template definition including header, body, footer, and buttons
+          definition: Complete definition of a message template including header, body, footer, and
+              buttons
 
           language: Template language code (e.g., en_US)
 

src/sent_dm/types/api_response_of_contact.py

@@ -14,13 +14,13 @@ class APIResponseOfContact(BaseModel):
     """Standard API response envelope for all v3 endpoints"""
 
     data: Optional[ContactResponse] = None
-    """The response data (null if error)"""
+    """Contact response for v3 API Uses snake_case for JSON property names"""
 
     error: Optional[APIError] = None
-    """Error details (null if successful)"""
+    """Error information"""
 
     meta: Optional[APIMeta] = None
-    """Metadata about the request and response"""
+    """Request and response metadata"""
 
     success: Optional[bool] = None
     """Indicates whether the request was successful"""

src/sent_dm/types/api_response_of_profile_detail.py

@@ -14,13 +14,13 @@ class APIResponseOfProfileDetail(BaseModel):
     """Standard API response envelope for all v3 endpoints"""
 
     data: Optional[ProfileDetail] = None
-    """The response data (null if error)"""
+    """Detailed profile response for v3 API"""
 
     error: Optional[APIError] = None
-    """Error details (null if successful)"""
+    """Error information"""
 
     meta: Optional[APIMeta] = None
-    """Metadata about the request and response"""
+    """Request and response metadata"""
 
     success: Optional[bool] = None
     """Indicates whether the request was successful"""

src/sent_dm/types/api_response_of_user.py

@@ -14,13 +14,13 @@ class APIResponseOfUser(BaseModel):
     """Standard API response envelope for all v3 endpoints"""
 
     data: Optional[UserResponse] = None
-    """The response data (null if error)"""
+    """User response for v3 API"""
 
     error: Optional[APIError] = None
-    """Error details (null if successful)"""
+    """Error information"""
 
     meta: Optional[APIMeta] = None
-    """Metadata about the request and response"""
+    """Request and response metadata"""
 
     success: Optional[bool] = None
     """Indicates whether the request was successful"""

src/sent_dm/types/api_response_template.py

@@ -14,13 +14,13 @@ class APIResponseTemplate(BaseModel):
     """Standard API response envelope for all v3 endpoints"""
 
     data: Optional[Template] = None
-    """The response data (null if error)"""
+    """Template response for v3 API"""
 
     error: Optional[APIError] = None
-    """Error details (null if successful)"""
+    """Error information"""
 
     meta: Optional[APIMeta] = None
-    """Metadata about the request and response"""
+    """Request and response metadata"""
 
     success: Optional[bool] = None
     """Indicates whether the request was successful"""

src/sent_dm/types/api_response_webhook.py

@@ -17,10 +17,10 @@ class APIResponseWebhook(BaseModel):
     """The response data (null if error)"""
 
     error: Optional[APIError] = None
-    """Error details (null if successful)"""
+    """Error information"""
 
     meta: Optional[APIMeta] = None
-    """Metadata about the request and response"""
+    """Request and response metadata"""
 
     success: Optional[bool] = None
     """Indicates whether the request was successful"""