feat: Add hidden audit-logs export endpoint

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 124
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-4c243ff089133bd49322d98a6943647589972f71ecadc993fe9e5029972b3995.yml
-openapi_spec_hash: a2cb637a19a070d07a1a4343c75444ee
-config_hash: fb167e754ebb3a14649463725891c9d0
+configured_endpoints: 125
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-55409ab573762d8bc010fb34c885651ca858a97d4353b4776b7aafeaaa313257.yml
+openapi_spec_hash: 0cf678d80f2a2b73fb9ec82d05c8cc0a
+config_hash: 06186eb40e0058a2a87ac251fc07415d

api.md

@@ -404,6 +404,7 @@ Types:
 Methods:
 
 - <code title="get /audit-logs">client.auditLogs.<a href="./src/resources/audit-logs.ts">list</a>({ ...params }) -> AuditLogEntriesPageTokenPagination</code>
+- <code title="get /audit-logs/export/chunk">client.auditLogs.<a href="./src/resources/audit-logs.ts">exportChunk</a>({ ...params }) -> Response</code>
 
 # APIKeys
 

src/client.ts

@@ -45,6 +45,7 @@ import {
 import {
   AuditLogEntriesPageTokenPagination,
   AuditLogEntry,
+  AuditLogExportChunkParams,
   AuditLogListParams,
   AuditLogs,
 } from './resources/audit-logs';
@@ -1192,6 +1193,7 @@ export declare namespace Kernel {
     type AuditLogEntry as AuditLogEntry,
     type AuditLogEntriesPageTokenPagination as AuditLogEntriesPageTokenPagination,
     type AuditLogListParams as AuditLogListParams,
+    type AuditLogExportChunkParams as AuditLogExportChunkParams,
   };
 
   export {

src/resources/audit-logs.ts

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
 import { PagePromise, PageTokenPagination, type PageTokenPaginationParams } from '../core/pagination';
+import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
 
 /**
@@ -18,6 +20,20 @@ export class AuditLogs extends APIResource {
   ): PagePromise<AuditLogEntriesPageTokenPagination, AuditLogEntry> {
     return this._client.getAPIList('/audit-logs', PageTokenPagination<AuditLogEntry>, { query, ...options });
   }
+
+  /**
+   * Download an organization's audit log records for a time range as a file, for
+   * archival, compliance, or offline analysis. For interactive browsing, use GET
+   * /audit-logs.
+   */
+  exportChunk(query: AuditLogExportChunkParams, options?: RequestOptions): APIPromise<Response> {
+    return this._client.get('/audit-logs/export/chunk', {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: 'application/octet-stream' }, options?.headers]),
+      __binaryResponse: true,
+    });
+  }
 }
 
 export type AuditLogEntriesPageTokenPagination = PageTokenPagination<AuditLogEntry>;
@@ -126,10 +142,68 @@ export interface AuditLogListParams extends PageTokenPaginationParams {
   service?: string;
 }
 
+export interface AuditLogExportChunkParams {
+  /**
+   * Upper bound (exclusive) for the audit record timestamp.
+   */
+  end: string;
+
+  /**
+   * Lower bound (inclusive) for the audit record timestamp.
+   */
+  start: string;
+
+  /**
+   * Filter by authentication strategy.
+   */
+  auth_strategy?: string;
+
+  /**
+   * Opaque cursor from X-Next-Cursor for the next chunk of older records.
+   */
+  cursor?: string;
+
+  /**
+   * Filter out results by HTTP method.
+   */
+  exclude_method?: string;
+
+  /**
+   * Encoding for the returned chunk.
+   */
+  format?: 'jsonl' | 'jsonl.gz';
+
+  /**
+   * Maximum number of records to return in this chunk.
+   */
+  limit?: number;
+
+  /**
+   * Filter by HTTP method.
+   */
+  method?: string;
+
+  /**
+   * Free-text search over path, user ID, email, client IP, and status.
+   */
+  search?: string;
+
+  /**
+   * Additional user IDs to OR into free-text search.
+   */
+  search_user_id?: Array<string>;
+
+  /**
+   * Filter by service name.
+   */
+  service?: string;
+}
+
 export declare namespace AuditLogs {
   export {
     type AuditLogEntry as AuditLogEntry,
     type AuditLogEntriesPageTokenPagination as AuditLogEntriesPageTokenPagination,
     type AuditLogListParams as AuditLogListParams,
+    type AuditLogExportChunkParams as AuditLogExportChunkParams,
   };
 }

src/resources/index.ts

@@ -22,6 +22,7 @@ export {
   AuditLogs,
   type AuditLogEntry,
   type AuditLogListParams,
+  type AuditLogExportChunkParams,
   type AuditLogEntriesPageTokenPagination,
 } from './audit-logs';
 export { Auth } from './auth/auth';

tests/api-resources/audit-logs.test.ts

@@ -38,4 +38,21 @@ describe('resource auditLogs', () => {
       service: 'service',
     });
   });
+
+  // Mock server tests are disabled
+  test.skip('exportChunk: required and optional params', async () => {
+    const response = await client.auditLogs.exportChunk({
+      end: '2026-01-02T00:00:00Z',
+      start: '2026-01-01T00:00:00Z',
+      auth_strategy: 'auth_strategy',
+      cursor: 'cursor',
+      exclude_method: 'exclude_method',
+      format: 'jsonl',
+      limit: 1,
+      method: 'method',
+      search: 'search',
+      search_user_id: ['string'],
+      service: 'service',
+    });
+  });
 });