feat(api): add project_creation_defaults field to organization 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

@@ -480,6 +480,7 @@ Types:
 - <code><a href="./src/resources/organizations/policies.ts">CustomSecurityAgent</a></code>
 - <code><a href="./src/resources/organizations/policies.ts">KernelControlsAction</a></code>
 - <code><a href="./src/resources/organizations/policies.ts">OrganizationPolicies</a></code>
+- <code><a href="./src/resources/organizations/policies.ts">ProjectCreationDefaults</a></code>
 - <code><a href="./src/resources/organizations/policies.ts">SecurityAgentPolicy</a></code>
 - <code><a href="./src/resources/organizations/policies.ts">VetoExecPolicy</a></code>
 - <code><a href="./src/resources/organizations/policies.ts">PolicyRetrieveResponse</a></code>

src/resources/organizations/index.ts

@@ -77,6 +77,7 @@ export {
   type CustomSecurityAgent,
   type KernelControlsAction,
   type OrganizationPolicies,
+  type ProjectCreationDefaults,
   type SecurityAgentPolicy,
   type VetoExecPolicy,
   type PolicyRetrieveResponse,

src/resources/organizations/organizations.ts

@@ -66,6 +66,7 @@ import {
   PolicyRetrieveResponse,
   PolicyUpdateParams,
   PolicyUpdateResponse,
+  ProjectCreationDefaults,
   SecurityAgentPolicy,
   VetoExecPolicy,
 } from './policies';
@@ -1063,6 +1064,7 @@ export declare namespace Organizations {
     type CustomSecurityAgent as CustomSecurityAgent,
     type KernelControlsAction as KernelControlsAction,
     type OrganizationPolicies as OrganizationPolicies,
+    type ProjectCreationDefaults as ProjectCreationDefaults,
     type SecurityAgentPolicy as SecurityAgentPolicy,
     type VetoExecPolicy as VetoExecPolicy,
     type PolicyRetrieveResponse as PolicyRetrieveResponse,

src/resources/organizations/policies.ts

@@ -349,6 +349,12 @@ export interface OrganizationPolicies {
    */
   maximumEnvironmentTimeout?: string;
 
+  /**
+   * project_creation_defaults contains default settings applied to newly created
+   * projects.
+   */
+  projectCreationDefaults?: ProjectCreationDefaults;
+
   /**
    * security_agent_policy contains security agent configuration for the
    * organization. When configured, security agents are automatically deployed to all
@@ -377,6 +383,18 @@ export namespace OrganizationPolicies {
   }
 }
 
+/**
+ * ProjectCreationDefaults contains default settings applied to newly created
+ * projects.
+ */
+export interface ProjectCreationDefaults {
+  /**
+   * insights_enabled controls whether Insights (co-author attribution) is
+   * automatically enabled on newly created projects.
+   */
+  insightsEnabled?: boolean;
+}
+
 /**
  * SecurityAgentPolicy contains security agent configuration for an organization.
  * When enabled, security agents are automatically deployed to all environments.
@@ -527,6 +545,12 @@ export interface PolicyUpdateParams {
    */
   portSharingDisabled?: boolean | null;
 
+  /**
+   * project_creation_defaults contains updates to default settings applied to newly
+   * created projects.
+   */
+  projectCreationDefaults?: PolicyUpdateParams.ProjectCreationDefaults | null;
+
   /**
    * 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.
@@ -606,6 +630,18 @@ export namespace PolicyUpdateParams {
     allowedVersions?: Array<string>;
   }
 
+  /**
+   * project_creation_defaults contains updates to default settings applied to newly
+   * created projects.
+   */
+  export interface ProjectCreationDefaults {
+    /**
+     * insights_enabled controls whether Insights (co-author attribution) is
+     * automatically enabled on newly created projects.
+     */
+    insightsEnabled?: boolean | null;
+  }
+
   /**
    * security_agent_policy contains security agent configuration updates
    */
@@ -659,6 +695,7 @@ export declare namespace Policies {
     type CustomSecurityAgent as CustomSecurityAgent,
     type KernelControlsAction as KernelControlsAction,
     type OrganizationPolicies as OrganizationPolicies,
+    type ProjectCreationDefaults as ProjectCreationDefaults,
     type SecurityAgentPolicy as SecurityAgentPolicy,
     type VetoExecPolicy as VetoExecPolicy,
     type PolicyRetrieveResponse as PolicyRetrieveResponse,

tests/api-resources/organizations/policies.test.ts

@@ -69,6 +69,7 @@ describe('resource policies', () => {
       membersCreateProjects: true,
       membersRequireProjects: true,
       portSharingDisabled: true,
+      projectCreationDefaults: { insightsEnabled: true },
       requireCustomDomainAccess: true,
       restrictAccountCreationToScim: true,
       securityAgentPolicy: {