feat(api): add project_creation_defaults to organizations policies

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 193
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod/gitpod-163329b61609d5c35f782faa460b99ad014584f1f0746d863c5612d6ee6e2c4b.yml
-openapi_spec_hash: 97bfee064dda4a0e940140c91fec5206
-config_hash: e7d6e90c037f5d495ae913f3806471fd
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod/gitpod-b9c1a7558d4dda4b0e58729d1c14b130d19262615d63ce6c78340daeca76188e.yml
+openapi_spec_hash: a91da1453dbfb8aceccb085665b3b21d
+config_hash: 9052d3b03d620cf6871184b15487e020

api.md

@@ -507,6 +507,7 @@ from gitpod.types.organizations import (
     CustomSecurityAgent,
     KernelControlsAction,
     OrganizationPolicies,
+    ProjectCreationDefaults,
     SecurityAgentPolicy,
     VetoExecPolicy,
     PolicyRetrieveResponse,

src/gitpod/resources/organizations/policies.py

@@ -115,6 +115,7 @@ def update(
         members_create_projects: Optional[bool] | Omit = omit,
         members_require_projects: Optional[bool] | Omit = omit,
         port_sharing_disabled: Optional[bool] | Omit = omit,
+        project_creation_defaults: Optional[policy_update_params.ProjectCreationDefaults] | Omit = omit,
         require_custom_domain_access: Optional[bool] | Omit = omit,
         restrict_account_creation_to_scim: Optional[bool] | Omit = omit,
         security_agent_policy: Optional[policy_update_params.SecurityAgentPolicy] | Omit = omit,
@@ -218,6 +219,9 @@ def update(
               in the organization. System ports (VS Code Browser, agents) are always exempt
               from this policy.
 
+          project_creation_defaults: project_creation_defaults contains updates to default settings applied to newly
+              created projects.
+
           require_custom_domain_access: require_custom_domain_access controls whether users must access via custom
               domain when one is configured. When true, access via app.gitpod.io is blocked.
 
@@ -257,6 +261,7 @@ def update(
                     "members_create_projects": members_create_projects,
                     "members_require_projects": members_require_projects,
                     "port_sharing_disabled": port_sharing_disabled,
+                    "project_creation_defaults": project_creation_defaults,
                     "require_custom_domain_access": require_custom_domain_access,
                     "restrict_account_creation_to_scim": restrict_account_creation_to_scim,
                     "security_agent_policy": security_agent_policy,
@@ -362,6 +367,7 @@ async def update(
         members_create_projects: Optional[bool] | Omit = omit,
         members_require_projects: Optional[bool] | Omit = omit,
         port_sharing_disabled: Optional[bool] | Omit = omit,
+        project_creation_defaults: Optional[policy_update_params.ProjectCreationDefaults] | Omit = omit,
         require_custom_domain_access: Optional[bool] | Omit = omit,
         restrict_account_creation_to_scim: Optional[bool] | Omit = omit,
         security_agent_policy: Optional[policy_update_params.SecurityAgentPolicy] | Omit = omit,
@@ -465,6 +471,9 @@ async def update(
               in the organization. System ports (VS Code Browser, agents) are always exempt
               from this policy.
 
+          project_creation_defaults: project_creation_defaults contains updates to default settings applied to newly
+              created projects.
+
           require_custom_domain_access: require_custom_domain_access controls whether users must access via custom
               domain when one is configured. When true, access via app.gitpod.io is blocked.
 
@@ -504,6 +513,7 @@ async def update(
                     "members_create_projects": members_create_projects,
                     "members_require_projects": members_require_projects,
                     "port_sharing_disabled": port_sharing_disabled,
+                    "project_creation_defaults": project_creation_defaults,
                     "require_custom_domain_access": require_custom_domain_access,
                     "restrict_account_creation_to_scim": restrict_account_creation_to_scim,
                     "security_agent_policy": security_agent_policy,

src/gitpod/types/organizations/__init__.py

@@ -27,6 +27,7 @@
 from .policy_retrieve_response import PolicyRetrieveResponse as PolicyRetrieveResponse
 from .domain_verification_state import DomainVerificationState as DomainVerificationState
 from .invite_get_summary_params import InviteGetSummaryParams as InviteGetSummaryParams
+from .project_creation_defaults import ProjectCreationDefaults as ProjectCreationDefaults
 from .conversation_sharing_policy import ConversationSharingPolicy as ConversationSharingPolicy
 from .custom_domain_create_params import CustomDomainCreateParams as CustomDomainCreateParams
 from .custom_domain_delete_params import CustomDomainDeleteParams as CustomDomainDeleteParams

src/gitpod/types/organizations/organization_policies.py

@@ -8,6 +8,7 @@
 from .agent_policy import AgentPolicy
 from .veto_exec_policy import VetoExecPolicy
 from .security_agent_policy import SecurityAgentPolicy
+from .project_creation_defaults import ProjectCreationDefaults
 
 __all__ = ["OrganizationPolicies", "EditorVersionRestrictions"]
 
@@ -132,6 +133,14 @@ class OrganizationPolicies(BaseModel):
     ```
     """
 
+    project_creation_defaults: Optional[ProjectCreationDefaults] = FieldInfo(
+        alias="projectCreationDefaults", default=None
+    )
+    """
+    project_creation_defaults contains default settings applied to newly created
+    projects.
+    """
+
     security_agent_policy: Optional[SecurityAgentPolicy] = FieldInfo(alias="securityAgentPolicy", default=None)
     """
     security_agent_policy contains security agent configuration for the

src/gitpod/types/organizations/policy_update_params.py

@@ -15,6 +15,7 @@
     "PolicyUpdateParams",
     "AgentPolicy",
     "EditorVersionRestrictions",
+    "ProjectCreationDefaults",
     "SecurityAgentPolicy",
     "SecurityAgentPolicyCrowdstrike",
 ]
@@ -123,6 +124,14 @@ class PolicyUpdateParams(TypedDict, total=False):
     from this policy.
     """
 
+    project_creation_defaults: Annotated[
+        Optional[ProjectCreationDefaults], PropertyInfo(alias="projectCreationDefaults")
+    ]
+    """
+    project_creation_defaults contains updates to default settings applied to newly
+    created projects.
+    """
+
     require_custom_domain_access: Annotated[Optional[bool], PropertyInfo(alias="requireCustomDomainAccess")]
     """
     require_custom_domain_access controls whether users must access via custom
@@ -195,6 +204,18 @@ class EditorVersionRestrictions(TypedDict, total=False):
     """
 
 
+class ProjectCreationDefaults(TypedDict, total=False):
+    """
+    project_creation_defaults contains updates to default settings applied to newly created projects.
+    """
+
+    insights_enabled: Annotated[Optional[bool], PropertyInfo(alias="insightsEnabled")]
+    """
+    insights_enabled controls whether Insights (co-author attribution) is
+    automatically enabled on newly created projects.
+    """
+
+
 class SecurityAgentPolicyCrowdstrike(TypedDict, total=False):
     """crowdstrike contains CrowdStrike Falcon configuration updates"""
 

src/gitpod/types/organizations/project_creation_defaults.py

@@ -0,0 +1,21 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from pydantic import Field as FieldInfo
+
+from ..._models import BaseModel
+
+__all__ = ["ProjectCreationDefaults"]
+
+
+class ProjectCreationDefaults(BaseModel):
+    """
+    ProjectCreationDefaults contains default settings applied to newly created projects.
+    """
+
+    insights_enabled: Optional[bool] = FieldInfo(alias="insightsEnabled", default=None)
+    """
+    insights_enabled controls whether Insights (co-author attribution) is
+    automatically enabled on newly created projects.
+    """

tests/api_resources/organizations/test_policies.py

@@ -88,6 +88,7 @@ def test_method_update_with_all_params(self, client: Gitpod) -> None:
             members_create_projects=True,
             members_require_projects=True,
             port_sharing_disabled=True,
+            project_creation_defaults={"insights_enabled": True},
             require_custom_domain_access=True,
             restrict_account_creation_to_scim=True,
             security_agent_policy={
@@ -208,6 +209,7 @@ async def test_method_update_with_all_params(self, async_client: AsyncGitpod) ->
             members_create_projects=True,
             members_require_projects=True,
             port_sharing_disabled=True,
+            project_creation_defaults={"insights_enabled": True},
             require_custom_domain_access=True,
             restrict_account_creation_to_scim=True,
             security_agent_policy={