chore(api): update composite API spec

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 1923
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-d01829c5ff74f82c372d7c132f3c9adcef9a7ac392e1dc7ff431f3397c94b6fb.yml
-openapi_spec_hash: 36f226c48f0fda588903ef75a766ccb1
+configured_endpoints: 1924
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-6183ef87f1b8eea6ad4bae542bfde2ec23a5526ae2b7bacdf6c6a4c48d990995.yml
+openapi_spec_hash: 9c8ac3d56571ebf1e170d993b71ccb4d
 config_hash: bfa05f973c1b1797df33a05f942d5fac

api.md

@@ -2949,8 +2949,13 @@ Methods:
 
 ## LOADocuments
 
+Types:
+
+- <code><a href="./src/resources/addressing/loa-documents.ts">LOADocumentCreateResponse</a></code>
+
 Methods:
 
+- <code title="post /accounts/{account_id}/addressing/loa_documents">client.addressing.loaDocuments.<a href="./src/resources/addressing/loa-documents.ts">create</a>({ ...params }) -> LOADocumentCreateResponse</code>
 - <code title="get /accounts/{account_id}/addressing/loa_documents/{loa_document_id}/download">client.addressing.loaDocuments.<a href="./src/resources/addressing/loa-documents.ts">get</a>(loaDocumentId, { ...params }) -> Response</code>
 
 ## Prefixes

src/resources/addressing/addressing.ts

@@ -2,7 +2,12 @@
 
 import { APIResource } from '../../resource';
 import * as LOADocumentsAPI from './loa-documents';
-import { LOADocumentGetParams, LOADocuments } from './loa-documents';
+import {
+  LOADocumentCreateParams,
+  LOADocumentCreateResponse,
+  LOADocumentGetParams,
+  LOADocuments,
+} from './loa-documents';
 import * as ServicesAPI from './services';
 import { ServiceListParams, ServiceListResponse, ServiceListResponsesSinglePage, Services } from './services';
 import * as AddressMapsAPI from './address-maps/address-maps';
@@ -106,7 +111,12 @@ export declare namespace Addressing {
     type AddressMapGetParams as AddressMapGetParams,
   };
 
-  export { LOADocuments as LOADocuments, type LOADocumentGetParams as LOADocumentGetParams };
+  export {
+    LOADocuments as LOADocuments,
+    type LOADocumentCreateResponse as LOADocumentCreateResponse,
+    type LOADocumentCreateParams as LOADocumentCreateParams,
+    type LOADocumentGetParams as LOADocumentGetParams,
+  };
 
   export {
     Prefixes as Prefixes,

src/resources/addressing/index.ts

@@ -15,7 +15,12 @@ export {
   type AddressMapGetParams,
 } from './address-maps/index';
 export { Addressing } from './addressing';
-export { LOADocuments, type LOADocumentGetParams } from './loa-documents';
+export {
+  LOADocuments,
+  type LOADocumentCreateResponse,
+  type LOADocumentCreateParams,
+  type LOADocumentGetParams,
+} from './loa-documents';
 export {
   PrefixesSinglePage,
   Prefixes,

src/resources/addressing/loa-documents.ts

@@ -5,6 +5,31 @@ import * as Core from '../../core';
 import { type Response } from '../../_shims/index';
 
 export class LOADocuments extends APIResource {
+  /**
+   * Submit LOA document (pdf format) under the account.
+   *
+   * @example
+   * ```ts
+   * const loaDocument =
+   *   await client.addressing.loaDocuments.create({
+   *     account_id: '258def64c72dae45f3e4c8516e2111f2',
+   *     loa_document: '@document.pdf',
+   *   });
+   * ```
+   */
+  create(
+    params: LOADocumentCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<LOADocumentCreateResponse> {
+    const { account_id, ...body } = params;
+    return (
+      this._client.post(
+        `/accounts/${account_id}/addressing/loa_documents`,
+        Core.multipartFormRequestOptions({ body, ...options }),
+      ) as Core.APIPromise<{ result: LOADocumentCreateResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
   /**
    * Download specified LOA document under the account.
    *
@@ -34,6 +59,52 @@ export class LOADocuments extends APIResource {
   }
 }
 
+export interface LOADocumentCreateResponse {
+  /**
+   * Identifier for the uploaded LOA document.
+   */
+  id?: string | null;
+
+  /**
+   * Identifier of a Cloudflare account.
+   */
+  account_id?: string;
+
+  created?: string;
+
+  /**
+   * Name of LOA document. Max file size 10MB, and supported filetype is pdf.
+   */
+  filename?: string;
+
+  /**
+   * File size of the uploaded LOA document.
+   */
+  size_bytes?: number;
+
+  /**
+   * Whether the LOA has been verified by Cloudflare staff.
+   */
+  verified?: boolean;
+
+  /**
+   * Timestamp of the moment the LOA was marked as validated.
+   */
+  verified_at?: string | null;
+}
+
+export interface LOADocumentCreateParams {
+  /**
+   * Path param: Identifier of a Cloudflare account.
+   */
+  account_id: string;
+
+  /**
+   * Body param: LOA document to upload.
+   */
+  loa_document: string;
+}
+
 export interface LOADocumentGetParams {
   /**
    * Identifier of a Cloudflare account.
@@ -42,5 +113,9 @@ export interface LOADocumentGetParams {
 }
 
 export declare namespace LOADocuments {
-  export { type LOADocumentGetParams as LOADocumentGetParams };
+  export {
+    type LOADocumentCreateResponse as LOADocumentCreateResponse,
+    type LOADocumentCreateParams as LOADocumentCreateParams,
+    type LOADocumentGetParams as LOADocumentGetParams,
+  };
 }

src/resources/addressing/prefixes/prefixes.ts

@@ -334,6 +334,11 @@ export interface PrefixCreateParams {
    * Body param: Description of the prefix.
    */
   description?: string;
+
+  /**
+   * Body param: Identifier for the uploaded LOA document.
+   */
+  loa_document_id?: string | null;
 }
 
 export interface PrefixListParams {

src/resources/cloudforce-one/threat-events/threat-events.ts

@@ -335,9 +335,48 @@ export interface ThreatEventDeleteResponse {
 }
 
 /**
- * Number of created bulk events
+ * Detailed result of bulk event creation with auto-tag management
  */
-export type ThreatEventBulkCreateResponse = number;
+export interface ThreatEventBulkCreateResponse {
+  /**
+   * Number of events created
+   */
+  createdEventsCount: number;
+
+  /**
+   * Number of indicators created
+   */
+  createdIndicatorsCount: number;
+
+  /**
+   * Number of tags created in SoT
+   */
+  createdTagsCount: number;
+
+  /**
+   * Number of errors encountered
+   */
+  errorCount: number;
+
+  /**
+   * Array of error details
+   */
+  errors?: Array<ThreatEventBulkCreateResponse.Error>;
+}
+
+export namespace ThreatEventBulkCreateResponse {
+  export interface Error {
+    /**
+     * Error message
+     */
+    error: string;
+
+    /**
+     * Index of the event that caused the error
+     */
+    eventIndex: number;
+  }
+}
 
 export interface ThreatEventEditResponse {
   attacker: string;

src/resources/iam/resource-groups.ts

@@ -30,7 +30,12 @@ export class ResourceGroups extends APIResource {
     options?: Core.RequestOptions,
   ): Core.APIPromise<ResourceGroupCreateResponse> {
     const { account_id, ...body } = params;
-    return this._client.post(`/accounts/${account_id}/iam/resource_groups`, { body, ...options });
+    return (
+      this._client.post(`/accounts/${account_id}/iam/resource_groups`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: ResourceGroupCreateResponse }>
+    )._thenUnwrap((obj) => obj.result);
   }
 
   /**
@@ -51,10 +56,12 @@ export class ResourceGroups extends APIResource {
     options?: Core.RequestOptions,
   ): Core.APIPromise<ResourceGroupUpdateResponse> {
     const { account_id, ...body } = params;
-    return this._client.put(`/accounts/${account_id}/iam/resource_groups/${resourceGroupId}`, {
-      body,
-      ...options,
-    });
+    return (
+      this._client.put(`/accounts/${account_id}/iam/resource_groups/${resourceGroupId}`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: ResourceGroupUpdateResponse }>
+    )._thenUnwrap((obj) => obj.result);
   }
 
   /**
@@ -125,7 +132,12 @@ export class ResourceGroups extends APIResource {
     options?: Core.RequestOptions,
   ): Core.APIPromise<ResourceGroupGetResponse> {
     const { account_id } = params;
-    return this._client.get(`/accounts/${account_id}/iam/resource_groups/${resourceGroupId}`, options);
+    return (
+      this._client.get(
+        `/accounts/${account_id}/iam/resource_groups/${resourceGroupId}`,
+        options,
+      ) as Core.APIPromise<{ result: ResourceGroupGetResponse }>
+    )._thenUnwrap((obj) => obj.result);
   }
 }
 
@@ -136,19 +148,24 @@ export class ResourceGroupListResponsesSinglePage extends SinglePage<ResourceGro
  */
 export interface ResourceGroupCreateResponse {
   /**
-   * Identifier of the group.
+   * Identifier of the resource group.
    */
-  id?: string;
+  id: string;
+
+  /**
+   * The scope associated to the resource group
+   */
+  scope: Array<ResourceGroupCreateResponse.Scope>;
 
   /**
    * Attributes associated to the resource group.
    */
-  meta?: unknown;
+  meta?: ResourceGroupCreateResponse.Meta;
 
   /**
-   * A scope is a combination of scope objects which provides additional context.
+   * Name of the resource group.
    */
-  scope?: ResourceGroupCreateResponse.Scope;
+  name?: string;
 }
 
 export namespace ResourceGroupCreateResponse {
@@ -163,8 +180,7 @@ export namespace ResourceGroupCreateResponse {
     key: string;
 
     /**
-     * A list of scope objects for additional context. The number of Scope objects
-     * should not be zero.
+     * A list of scope objects for additional context.
      */
     objects: Array<Scope.Object>;
   }
@@ -182,6 +198,15 @@ export namespace ResourceGroupCreateResponse {
       key: string;
     }
   }
+
+  /**
+   * Attributes associated to the resource group.
+   */
+  export interface Meta {
+    key?: string;
+
+    value?: string;
+  }
 }
 
 /**

src/resources/origin-ca-certificates.ts

@@ -14,7 +14,11 @@ export class OriginCACertificates extends APIResource {
    * @example
    * ```ts
    * const originCACertificate =
-   *   await client.originCACertificates.create();
+   *   await client.originCACertificates.create({
+   *     csr: '-----BEGIN CERTIFICATE REQUEST-----\nMIICxzCCAa8CAQAwSDELMAkGA1UEBhMCVVMxFjAUBgNVBAgTDVNhbiBGcmFuY2lz\nY28xCzAJBgNVBAcTAkNBMRQwEgYDVQQDEwtleGFtcGxlLm5ldDCCASIwDQYJKoZI\nhvcNAQEBBQADggEPADCCAQoCggEBALxejtu4b+jPdFeFi6OUsye8TYJQBm3WfCvL\nHu5EvijMO/4Z2TImwASbwUF7Ir8OLgH+mGlQZeqyNvGoSOMEaZVXcYfpR1hlVak8\n4GGVr+04IGfOCqaBokaBFIwzclGZbzKmLGwIQioNxGfqFm6RGYGA3be2Je2iseBc\nN8GV1wYmvYE0RR+yWweJCTJ157exyRzu7sVxaEW9F87zBQLyOnwXc64rflXslRqi\ng7F7w5IaQYOl8yvmk/jEPCAha7fkiUfEpj4N12+oPRiMvleJF98chxjD4MH39c5I\nuOslULhrWunfh7GB1jwWNA9y44H0snrf+xvoy2TcHmxvma9Eln8CAwEAAaA6MDgG\nCSqGSIb3DQEJDjErMCkwJwYDVR0RBCAwHoILZXhhbXBsZS5uZXSCD3d3dy5leGFt\ncGxlLm5ldDANBgkqhkiG9w0BAQsFAAOCAQEAcBaX6dOnI8ncARrI9ZSF2AJX+8mx\npTHY2+Y2C0VvrVDGMtbBRH8R9yMbqWtlxeeNGf//LeMkSKSFa4kbpdx226lfui8/\nauRDBTJGx2R1ccUxmLZXx4my0W5iIMxunu+kez+BDlu7bTT2io0uXMRHue4i6quH\nyc5ibxvbJMjR7dqbcanVE10/34oprzXQsJ/VmSuZNXtjbtSKDlmcpw6To/eeAJ+J\nhXykcUihvHyG4A1m2R6qpANBjnA0pHexfwM/SgfzvpbvUg0T1ubmer8BgTwCKIWs\ndcWYTthM51JIqRBfNqy4QcBnX+GY05yltEEswQI55wdiS3CjTTA67sdbcQ==\n-----END CERTIFICATE REQUEST-----',
+   *     hostnames: ['example.com', '*.example.com'],
+   *     request_type: 'origin-rsa',
+   *   });
    * ```
    */
   create(
@@ -156,19 +160,19 @@ export interface OriginCACertificateCreateParams {
   /**
    * The Certificate Signing Request (CSR). Must be newline-encoded.
    */
-  csr?: string;
+  csr: string;
 
   /**
    * Array of hostnames or wildcard names (e.g., \*.example.com) bound to the
    * certificate.
    */
-  hostnames?: Array<string>;
+  hostnames: Array<string>;
 
   /**
    * Signature type desired on certificate ("origin-rsa" (rsa), "origin-ecc" (ecdsa),
    * or "keyless-certificate" (for Keyless SSL servers).
    */
-  request_type?: Shared.CertificateRequestTypeParam;
+  request_type: Shared.CertificateRequestTypeParam;
 
   /**
    * The number of days for which the certificate should be valid.