chore: add missing docstrings

Author: stainless-app[bot]

src/cloudflare/types/abuse_reports/abuse_report_get_response.py

@@ -9,6 +9,8 @@
 
 
 class MitigationSummary(BaseModel):
+    """A summary of the mitigations related to this report."""
+
     accepted_url_count: int
     """How many of the reported URLs were confirmed as abusive."""
 
@@ -26,6 +28,8 @@ class MitigationSummary(BaseModel):
 
 
 class Submitter(BaseModel):
+    """Information about the submitter of the report."""
+
     company: Optional[str] = None
 
     email: Optional[str] = None

src/cloudflare/types/abuse_reports/abuse_report_list_response.py

@@ -9,6 +9,8 @@
 
 
 class ReportMitigationSummary(BaseModel):
+    """A summary of the mitigations related to this report."""
+
     accepted_url_count: int
     """How many of the reported URLs were confirmed as abusive."""
 
@@ -26,6 +28,8 @@ class ReportMitigationSummary(BaseModel):
 
 
 class ReportSubmitter(BaseModel):
+    """Information about the submitter of the report."""
+
     company: Optional[str] = None
 
     email: Optional[str] = None

src/cloudflare/types/accounts/account.py

@@ -10,6 +10,8 @@
 
 
 class ManagedBy(BaseModel):
+    """Parent container details"""
+
     parent_org_id: Optional[str] = None
     """ID of the parent Organization, if one exists"""
 
@@ -18,6 +20,8 @@ class ManagedBy(BaseModel):
 
 
 class Settings(BaseModel):
+    """Account settings"""
+
     abuse_contact_email: Optional[str] = None
     """Sets an abuse contact email to notify for abuse reports."""
 

src/cloudflare/types/accounts/account_create_params.py

@@ -22,5 +22,9 @@ class AccountCreateParams(TypedDict, total=False):
 
 
 class Unit(TypedDict, total=False):
+    """
+    information related to the tenant unit, and optionally, an id of the unit to create the account on. see https://developers.cloudflare.com/tenant/how-to/manage-accounts/
+    """
+
     id: str
     """Tenant unit ID"""

src/cloudflare/types/accounts/account_update_params.py

@@ -27,10 +27,14 @@ class AccountUpdateParams(TypedDict, total=False):
 
 
 class ManagedBy(TypedDict, total=False):
+    """Parent container details"""
+
     pass
 
 
 class Settings(TypedDict, total=False):
+    """Account settings"""
+
     abuse_contact_email: str
     """Sets an abuse contact email to notify for abuse reports."""
 

src/cloudflare/types/accounts/logs/audit_list_response.py

@@ -12,6 +12,8 @@
 
 
 class Account(BaseModel):
+    """Contains account related information."""
+
     id: Optional[str] = None
     """A unique identifier for the account."""
 
@@ -20,6 +22,8 @@ class Account(BaseModel):
 
 
 class Action(BaseModel):
+    """Provides information about the action performed."""
+
     description: Optional[str] = None
     """A short description of the action performed."""
 
@@ -34,6 +38,8 @@ class Action(BaseModel):
 
 
 class Actor(BaseModel):
+    """Provides details about the actor who performed the action."""
+
     id: Optional[str] = None
     """The ID of the actor who performed the action.
 
@@ -59,6 +65,8 @@ class Actor(BaseModel):
 
 
 class Raw(BaseModel):
+    """Provides raw information about the request and response."""
+
     cf_rayid: Optional[str] = FieldInfo(alias="cf_ray_id", default=None)
     """The Cloudflare Ray ID for the request."""
 
@@ -76,6 +84,8 @@ class Raw(BaseModel):
 
 
 class Resource(BaseModel):
+    """Provides details about the affected resource."""
+
     id: Optional[str] = None
     """The unique identifier for the affected resource."""
 
@@ -94,6 +104,8 @@ class Resource(BaseModel):
 
 
 class Zone(BaseModel):
+    """Provides details about the zone affected by the action."""
+
     id: Optional[str] = None
     """A string that identifies the zone id."""
 

src/cloudflare/types/accounts/member_create_params.py

@@ -44,11 +44,15 @@ class IAMCreateMemberWithPolicies(TypedDict, total=False):
 
 
 class IAMCreateMemberWithPoliciesPolicyPermissionGroup(TypedDict, total=False):
+    """A group of permissions."""
+
     id: Required[str]
     """Identifier of the group."""
 
 
 class IAMCreateMemberWithPoliciesPolicyResourceGroup(TypedDict, total=False):
+    """A group of scoped resources."""
+
     id: Required[str]
     """Identifier of the group."""
 

src/cloudflare/types/accounts/member_update_params.py

@@ -34,11 +34,15 @@ class IAMUpdateMemberWithPolicies(TypedDict, total=False):
 
 
 class IAMUpdateMemberWithPoliciesPolicyPermissionGroup(TypedDict, total=False):
+    """A group of permissions."""
+
     id: Required[str]
     """Identifier of the group."""
 
 
 class IAMUpdateMemberWithPoliciesPolicyResourceGroup(TypedDict, total=False):
+    """A group of scoped resources."""
+
     id: Required[str]
     """Identifier of the group."""
 

src/cloudflare/types/accounts/token_create_params.py

@@ -46,6 +46,8 @@ class TokenCreateParams(TypedDict, total=False):
 
 
 class ConditionRequestIP(_ConditionRequestIPReservedKeywords, total=False):
+    """Client IP restrictions."""
+
     not_in: SequenceNotStr[TokenConditionCIDRList]
     """List of IPv4/IPv6 CIDR addresses."""
 

src/cloudflare/types/accounts/token_create_response.py

@@ -15,6 +15,8 @@
 
 
 class ConditionRequestIP(BaseModel):
+    """Client IP restrictions."""
+
     in_: Optional[List[TokenConditionCIDRList]] = FieldInfo(alias="in", default=None)
     """List of IPv4/IPv6 CIDR addresses."""