Skip to content

Commit aab704a

Browse files
stainless-app[bot]stainless-app[bot]
committed
chore(api): update composite API spec
1 parent 3b947ea commit aab704a

File tree

10 files changed

+278
-3
lines changed

10 files changed

+278
-3
lines changed

‎.stats.yml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
configured_endpoints: 1993
2-
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-f0c3645a37032449aee08f0bfc7f373ce8ebe0bdaa2c6964b4c9328f712bbae9.yml
3-
openapi_spec_hash: ab3368c4c9aa05dff33b51f542fb7786
2+
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-0d52971b01c25a36f6fcfb4f73b19445b8fd83818763a6fd66f5616b49f6dd81.yml
3+
openapi_spec_hash: c389912f9fa531e76127e9d8a2500f22
44
config_hash: ef319a79ff462ce842b47460e889e37b

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

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -358,6 +358,11 @@ export interface ThreatEventBulkCreateResponse {
358358
*/
359359
queuedIndicatorsCount: number;
360360

361+
/**
362+
* Number of events skipped due to duplicate UUID (only when preserveUuid=true)
363+
*/
364+
skippedEventsCount: number;
365+
361366
/**
362367
* Correlation ID for async indicator processing
363368
*/
@@ -573,6 +578,12 @@ export interface ThreatEventCreateParams {
573578
* Body param:
574579
*/
575580
targetIndustry?: string;
581+
582+
/**
583+
* Body param: Optional UUID for the event. Only used when preserveUuid=true in
584+
* bulk create. Must be a valid UUID format.
585+
*/
586+
uuid?: string;
576587
}
577588

578589
export namespace ThreatEventCreateParams {
@@ -613,6 +624,11 @@ export interface ThreatEventListParams {
613624
*/
614625
forceRefresh?: boolean;
615626

627+
/**
628+
* Query param:
629+
*/
630+
format?: 'json' | 'stix2';
631+
616632
/**
617633
* Query param:
618634
*/
@@ -683,6 +699,13 @@ export interface ThreatEventBulkCreateParams {
683699
* Body param:
684700
*/
685701
datasetId: string;
702+
703+
/**
704+
* Body param: When true, use provided UUIDs from event data instead of generating
705+
* new ones. Used for migration scenarios where original UUIDs must be preserved.
706+
* Duplicate UUIDs will be skipped.
707+
*/
708+
preserveUuid?: boolean;
686709
}
687710

688711
export namespace ThreatEventBulkCreateParams {
@@ -722,6 +745,12 @@ export namespace ThreatEventBulkCreateParams {
722745
targetCountry?: string;
723746

724747
targetIndustry?: string;
748+
749+
/**
750+
* Optional UUID for the event. Only used when preserveUuid=true in bulk create.
751+
* Must be a valid UUID format.
752+
*/
753+
uuid?: string;
725754
}
726755

727756
export namespace Data {

‎src/resources/email-security/investigate/investigate.ts‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,9 @@ export class Investigate extends APIResource {
4242
release: ReleaseAPI.Release = new ReleaseAPI.Release(this._client);
4343

4444
/**
45-
* Returns information for each email that matches the search parameter(s).
45+
* Returns information for each email that matches the search parameter(s). If the
46+
* search takes too long, the endpoint returns 202 with a Location header pointing
47+
* to a polling endpoint where results can be retrieved once ready.
4648
*
4749
* @example
4850
* ```ts

‎src/resources/email-security/investigate/move.ts‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -72,8 +72,13 @@ export class MoveBulkResponsesSinglePage extends SinglePage<MoveBulkResponse> {}
7272
export interface MoveCreateResponse {
7373
completed_timestamp: string;
7474

75+
/**
76+
* @deprecated
77+
*/
7578
item_count: number;
7679

80+
success: boolean;
81+
7782
destination?: string | null;
7883

7984
message_id?: string | null;
@@ -88,8 +93,13 @@ export interface MoveCreateResponse {
8893
export interface MoveBulkResponse {
8994
completed_timestamp: string;
9095

96+
/**
97+
* @deprecated
98+
*/
9199
item_count: number;
92100

101+
success: boolean;
102+
93103
destination?: string | null;
94104

95105
message_id?: string | null;

‎src/resources/r2-data-catalog/maintenance-configs.ts‎

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,11 @@ export class MaintenanceConfigs extends APIResource {
1919
* state: 'enabled',
2020
* target_size_mb: '256',
2121
* },
22+
* snapshot_expiration: {
23+
* max_snapshot_age: '14d',
24+
* min_snapshots_to_keep: 5,
25+
* state: 'enabled',
26+
* },
2227
* },
2328
* );
2429
* ```
@@ -73,6 +78,11 @@ export interface MaintenanceConfigUpdateResponse {
7378
* Configures compaction for catalog maintenance.
7479
*/
7580
compaction?: MaintenanceConfigUpdateResponse.Compaction;
81+
82+
/**
83+
* Configures snapshot expiration settings.
84+
*/
85+
snapshot_expiration?: MaintenanceConfigUpdateResponse.SnapshotExpiration;
7686
}
7787

7888
export namespace MaintenanceConfigUpdateResponse {
@@ -90,6 +100,29 @@ export namespace MaintenanceConfigUpdateResponse {
90100
*/
91101
target_size_mb: '64' | '128' | '256' | '512';
92102
}
103+
104+
/**
105+
* Configures snapshot expiration settings.
106+
*/
107+
export interface SnapshotExpiration {
108+
/**
109+
* Specifies the maximum age for snapshots. The system deletes snapshots older than
110+
* this age. Format: <number><unit> where unit is d (days), h (hours), m (minutes),
111+
* or s (seconds). Examples: "7d" (7 days), "48h" (48 hours), "2880m" (2,880
112+
* minutes).
113+
*/
114+
max_snapshot_age: string;
115+
116+
/**
117+
* Specifies the minimum number of snapshots to retain.
118+
*/
119+
min_snapshots_to_keep: number;
120+
121+
/**
122+
* Specifies the state of maintenance operations.
123+
*/
124+
state: 'enabled' | 'disabled';
125+
}
93126
}
94127

95128
/**
@@ -116,6 +149,11 @@ export namespace MaintenanceConfigGetResponse {
116149
* Configures compaction for catalog maintenance.
117150
*/
118151
compaction?: MaintenanceConfig.Compaction;
152+
153+
/**
154+
* Configures snapshot expiration settings.
155+
*/
156+
snapshot_expiration?: MaintenanceConfig.SnapshotExpiration;
119157
}
120158

121159
export namespace MaintenanceConfig {
@@ -133,6 +171,29 @@ export namespace MaintenanceConfigGetResponse {
133171
*/
134172
target_size_mb: '64' | '128' | '256' | '512';
135173
}
174+
175+
/**
176+
* Configures snapshot expiration settings.
177+
*/
178+
export interface SnapshotExpiration {
179+
/**
180+
* Specifies the maximum age for snapshots. The system deletes snapshots older than
181+
* this age. Format: <number><unit> where unit is d (days), h (hours), m (minutes),
182+
* or s (seconds). Examples: "7d" (7 days), "48h" (48 hours), "2880m" (2,880
183+
* minutes).
184+
*/
185+
max_snapshot_age: string;
186+
187+
/**
188+
* Specifies the minimum number of snapshots to retain.
189+
*/
190+
min_snapshots_to_keep: number;
191+
192+
/**
193+
* Specifies the state of maintenance operations.
194+
*/
195+
state: 'enabled' | 'disabled';
196+
}
136197
}
137198
}
138199

@@ -146,6 +207,11 @@ export interface MaintenanceConfigUpdateParams {
146207
* Body param: Updates compaction configuration (all fields optional).
147208
*/
148209
compaction?: MaintenanceConfigUpdateParams.Compaction;
210+
211+
/**
212+
* Body param: Updates snapshot expiration configuration (all fields optional).
213+
*/
214+
snapshot_expiration?: MaintenanceConfigUpdateParams.SnapshotExpiration;
149215
}
150216

151217
export namespace MaintenanceConfigUpdateParams {
@@ -163,6 +229,26 @@ export namespace MaintenanceConfigUpdateParams {
163229
*/
164230
target_size_mb?: '64' | '128' | '256' | '512';
165231
}
232+
233+
/**
234+
* Updates snapshot expiration configuration (all fields optional).
235+
*/
236+
export interface SnapshotExpiration {
237+
/**
238+
* Updates the maximum age for snapshots optionally.
239+
*/
240+
max_snapshot_age?: string;
241+
242+
/**
243+
* Updates the minimum number of snapshots to retain optionally.
244+
*/
245+
min_snapshots_to_keep?: number;
246+
247+
/**
248+
* Updates the state optionally.
249+
*/
250+
state?: 'enabled' | 'disabled';
251+
}
166252
}
167253

168254
export interface MaintenanceConfigGetParams {

‎src/resources/r2-data-catalog/namespaces/tables/maintenance-configs.ts‎

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,11 @@ export class MaintenanceConfigs extends APIResource {
2121
* state: 'enabled',
2222
* target_size_mb: '256',
2323
* },
24+
* snapshot_expiration: {
25+
* max_snapshot_age: '14d',
26+
* min_snapshots_to_keep: 5,
27+
* state: 'enabled',
28+
* },
2429
* },
2530
* );
2631
* ```
@@ -81,6 +86,11 @@ export interface MaintenanceConfigUpdateResponse {
8186
* Configures compaction settings for table optimization.
8287
*/
8388
compaction?: MaintenanceConfigUpdateResponse.Compaction;
89+
90+
/**
91+
* Configures snapshot expiration settings.
92+
*/
93+
snapshot_expiration?: MaintenanceConfigUpdateResponse.SnapshotExpiration;
8494
}
8595

8696
export namespace MaintenanceConfigUpdateResponse {
@@ -98,6 +108,29 @@ export namespace MaintenanceConfigUpdateResponse {
98108
*/
99109
target_size_mb: '64' | '128' | '256' | '512';
100110
}
111+
112+
/**
113+
* Configures snapshot expiration settings.
114+
*/
115+
export interface SnapshotExpiration {
116+
/**
117+
* Specifies the maximum age for snapshots. The system deletes snapshots older than
118+
* this age. Format: <number><unit> where unit is d (days), h (hours), m (minutes),
119+
* or s (seconds). Examples: "7d" (7 days), "48h" (48 hours), "2880m" (2,880
120+
* minutes).
121+
*/
122+
max_snapshot_age: string;
123+
124+
/**
125+
* Specifies the minimum number of snapshots to retain.
126+
*/
127+
min_snapshots_to_keep: number;
128+
129+
/**
130+
* Specifies the state of maintenance operations.
131+
*/
132+
state: 'enabled' | 'disabled';
133+
}
101134
}
102135

103136
/**
@@ -119,6 +152,11 @@ export namespace MaintenanceConfigGetResponse {
119152
* Configures compaction settings for table optimization.
120153
*/
121154
compaction?: MaintenanceConfig.Compaction;
155+
156+
/**
157+
* Configures snapshot expiration settings.
158+
*/
159+
snapshot_expiration?: MaintenanceConfig.SnapshotExpiration;
122160
}
123161

124162
export namespace MaintenanceConfig {
@@ -136,6 +174,29 @@ export namespace MaintenanceConfigGetResponse {
136174
*/
137175
target_size_mb: '64' | '128' | '256' | '512';
138176
}
177+
178+
/**
179+
* Configures snapshot expiration settings.
180+
*/
181+
export interface SnapshotExpiration {
182+
/**
183+
* Specifies the maximum age for snapshots. The system deletes snapshots older than
184+
* this age. Format: <number><unit> where unit is d (days), h (hours), m (minutes),
185+
* or s (seconds). Examples: "7d" (7 days), "48h" (48 hours), "2880m" (2,880
186+
* minutes).
187+
*/
188+
max_snapshot_age: string;
189+
190+
/**
191+
* Specifies the minimum number of snapshots to retain.
192+
*/
193+
min_snapshots_to_keep: number;
194+
195+
/**
196+
* Specifies the state of maintenance operations.
197+
*/
198+
state: 'enabled' | 'disabled';
199+
}
139200
}
140201
}
141202

@@ -149,6 +210,11 @@ export interface MaintenanceConfigUpdateParams {
149210
* Body param: Updates compaction configuration (all fields optional).
150211
*/
151212
compaction?: MaintenanceConfigUpdateParams.Compaction;
213+
214+
/**
215+
* Body param: Updates snapshot expiration configuration (all fields optional).
216+
*/
217+
snapshot_expiration?: MaintenanceConfigUpdateParams.SnapshotExpiration;
152218
}
153219

154220
export namespace MaintenanceConfigUpdateParams {
@@ -166,6 +232,26 @@ export namespace MaintenanceConfigUpdateParams {
166232
*/
167233
target_size_mb?: '64' | '128' | '256' | '512';
168234
}
235+
236+
/**
237+
* Updates snapshot expiration configuration (all fields optional).
238+
*/
239+
export interface SnapshotExpiration {
240+
/**
241+
* Updates the maximum age for snapshots optionally.
242+
*/
243+
max_snapshot_age?: string;
244+
245+
/**
246+
* Updates the minimum number of snapshots to retain optionally.
247+
*/
248+
min_snapshots_to_keep?: number;
249+
250+
/**
251+
* Updates the state optionally.
252+
*/
253+
state?: 'enabled' | 'disabled';
254+
}
169255
}
170256

171257
export interface MaintenanceConfigGetParams {

0 commit comments

Comments
 (0)