@cloudfleet/sdk 0.0.1-2791829 → 0.0.1-2854ca2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/README.md +26 -2
  2. package/dist/@tanstack/react-query.gen.d.ts +1199 -0
  3. package/dist/@tanstack/react-query.gen.d.ts.map +1 -0
  4. package/dist/@tanstack/react-query.gen.js +1215 -0
  5. package/dist/@tanstack/react-query.gen.js.map +1 -0
  6. package/dist/client/client.gen.d.ts.map +1 -1
  7. package/dist/client/client.gen.js +114 -102
  8. package/dist/client/client.gen.js.map +1 -1
  9. package/dist/client/index.d.ts +1 -1
  10. package/dist/client/index.d.ts.map +1 -1
  11. package/dist/client/index.js.map +1 -1
  12. package/dist/client/types.gen.d.ts +9 -13
  13. package/dist/client/types.gen.d.ts.map +1 -1
  14. package/dist/client/utils.gen.d.ts +8 -4
  15. package/dist/client/utils.gen.d.ts.map +1 -1
  16. package/dist/client/utils.gen.js +13 -15
  17. package/dist/client/utils.gen.js.map +1 -1
  18. package/dist/client.gen.d.ts.map +1 -1
  19. package/dist/client.gen.js +1 -3
  20. package/dist/client.gen.js.map +1 -1
  21. package/dist/core/auth.gen.d.ts.map +1 -1
  22. package/dist/core/auth.gen.js.map +1 -1
  23. package/dist/core/bodySerializer.gen.d.ts +16 -8
  24. package/dist/core/bodySerializer.gen.d.ts.map +1 -1
  25. package/dist/core/bodySerializer.gen.js +1 -1
  26. package/dist/core/bodySerializer.gen.js.map +1 -1
  27. package/dist/core/params.gen.d.ts +10 -0
  28. package/dist/core/params.gen.d.ts.map +1 -1
  29. package/dist/core/params.gen.js +22 -10
  30. package/dist/core/params.gen.js.map +1 -1
  31. package/dist/core/pathSerializer.gen.d.ts.map +1 -1
  32. package/dist/core/pathSerializer.gen.js +3 -11
  33. package/dist/core/pathSerializer.gen.js.map +1 -1
  34. package/dist/core/queryKeySerializer.gen.d.ts.map +1 -1
  35. package/dist/core/queryKeySerializer.gen.js +4 -11
  36. package/dist/core/queryKeySerializer.gen.js.map +1 -1
  37. package/dist/core/serverSentEvents.gen.d.ts +1 -1
  38. package/dist/core/serverSentEvents.gen.d.ts.map +1 -1
  39. package/dist/core/serverSentEvents.gen.js +6 -9
  40. package/dist/core/serverSentEvents.gen.js.map +1 -1
  41. package/dist/core/types.gen.d.ts +1 -1
  42. package/dist/core/types.gen.d.ts.map +1 -1
  43. package/dist/core/utils.gen.d.ts.map +1 -1
  44. package/dist/core/utils.gen.js +1 -1
  45. package/dist/core/utils.gen.js.map +1 -1
  46. package/dist/schemas.gen.d.ts +1471 -227
  47. package/dist/schemas.gen.d.ts.map +1 -1
  48. package/dist/schemas.gen.js +2877 -326
  49. package/dist/schemas.gen.js.map +1 -1
  50. package/dist/sdk.gen.d.ts +282 -166
  51. package/dist/sdk.gen.d.ts.map +1 -1
  52. package/dist/sdk.gen.js +399 -315
  53. package/dist/sdk.gen.js.map +1 -1
  54. package/dist/services/kubernetes/api.d.ts +8 -8
  55. package/dist/types.gen.d.ts +1839 -601
  56. package/dist/types.gen.d.ts.map +1 -1
  57. package/dist/zod.gen.d.ts +3550 -1367
  58. package/dist/zod.gen.d.ts.map +1 -1
  59. package/dist/zod.gen.js +1457 -573
  60. package/dist/zod.gen.js.map +1 -1
  61. package/package.json +28 -8
@@ -1,7 +1,65 @@
1
1
  // This file is auto-generated by @hey-api/openapi-ts
2
+ export const BasicPriceConsentInputSchema = {
3
+ type: 'object',
4
+ properties: {
5
+ decision: {
6
+ type: 'string',
7
+ description: 'The administrator\'s decision on the new Basic price. `accepted` continues to paid billing when the signup credit runs out; `rejected` opts out (clusters are suspended, never charged). A `rejected` org can later be flipped back to `accepted`.',
8
+ example: 'accepted',
9
+ enum: [
10
+ 'accepted',
11
+ 'rejected'
12
+ ]
13
+ }
14
+ },
15
+ required: [
16
+ 'decision'
17
+ ],
18
+ additionalProperties: false
19
+ };
20
+ export const BasicPriceConsentSchema = {
21
+ type: 'object',
22
+ properties: {
23
+ status: {
24
+ type: 'string',
25
+ description: 'Consent status for the new Basic price. `not_applicable` when the organization is not in scope for the migration. `pending` when the organization must opt in but no admin has decided yet. `accepted` / `rejected` reflect the recorded decision.',
26
+ example: 'pending',
27
+ enum: [
28
+ 'not_applicable',
29
+ 'pending',
30
+ 'accepted',
31
+ 'rejected'
32
+ ]
33
+ },
34
+ decided_at: {
35
+ type: 'string',
36
+ format: 'date-time',
37
+ description: 'When the current decision was recorded. Absent while `not_applicable` or `pending`.',
38
+ example: '2026-09-05T10:12:00.000Z'
39
+ },
40
+ decided_by: {
41
+ type: 'string',
42
+ description: 'User id of the administrator who recorded the current decision. Absent while `not_applicable` or `pending`.',
43
+ example: '2b7a5c9e-1f4d-4a1b-9c3e-8d2f6a0b1c2d'
44
+ }
45
+ },
46
+ required: [
47
+ 'status'
48
+ ],
49
+ additionalProperties: false
50
+ };
2
51
  export const BillingContactSchema = {
3
52
  type: 'object',
4
53
  properties: {
54
+ type: {
55
+ type: 'string',
56
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
57
+ example: 'business',
58
+ enum: [
59
+ 'business',
60
+ 'personal'
61
+ ]
62
+ },
5
63
  company: {
6
64
  type: 'string',
7
65
  maxLength: 120,
@@ -74,10 +132,143 @@ export const BillingContactSchema = {
74
132
  nullable: true,
75
133
  description: 'Type of the tax ID.',
76
134
  example: 'de_vat',
77
- enum: ['ad_nrt', 'ae_trn', 'al_tin', 'am_tin', 'ao_tin', 'ar_cuit', 'at_vat', 'au_abn', 'au_arn', 'ba_tin', 'bb_tin', 'be_vat', 'bg_uic', 'bg_vat', 'bh_vat', 'bo_tin', 'br_cnpj', 'br_cpf', 'bs_tin', 'by_tin', 'ca_bn', 'ca_gst_hst', 'ca_pst_bc', 'ca_pst_mb', 'ca_pst_sk', 'ca_qst', 'cd_nif', 'ch_uid', 'ch_vat', 'cl_tin', 'cn_tin', 'co_nit', 'cr_tin', 'cy_vat', 'cz_vat', 'de_stn', 'de_vat', 'dk_vat', 'do_rcn', 'ec_ruc', 'ee_vat', 'eg_tin', 'es_cif', 'es_vat', 'eu_oss_vat', 'fi_vat', 'fr_vat', 'gb_vat', 'ge_vat', 'gn_nif', 'gr_vat', 'hk_br', 'hr_oib', 'hr_vat', 'hu_tin', 'hu_vat', 'id_npwp', 'ie_vat', 'il_vat', 'in_gst', 'is_vat', 'it_vat', 'jp_cn', 'jp_rn', 'jp_trn', 'ke_pin', 'kh_tin', 'kr_brn', 'kz_bin', 'li_uid', 'li_vat', 'lt_vat', 'lu_vat', 'lv_vat', 'ma_vat', 'md_vat', 'me_pib', 'mk_vat', 'mr_nif', 'mt_vat', 'mx_rfc', 'my_frp', 'my_itn', 'my_sst', 'ng_tin', 'nl_vat', 'no_vat', 'no_voec', 'np_pan', 'nz_gst', 'om_vat', 'pe_ruc', 'ph_tin', 'pl_vat', 'pt_vat', 'ro_tin', 'ro_vat', 'rs_pib', 'ru_inn', 'ru_kpp', 'sa_vat', 'se_vat', 'sg_gst', 'sg_uen', 'si_tin', 'si_vat', 'sk_vat', 'sn_ninea', 'sr_fin', 'sv_nit', 'th_vat', 'tj_tin', 'tr_tin', 'tw_vat', 'tz_vat', 'ua_vat', 'ug_tin', 'us_ein', 'uy_ruc', 'uz_tin', 'uz_vat', 've_rif', 'vn_tin', 'xi_vat', 'za_vat', 'zm_tin', 'zw_tin', '']
135
+ enum: [
136
+ 'ad_nrt',
137
+ 'ae_trn',
138
+ 'al_tin',
139
+ 'am_tin',
140
+ 'ao_tin',
141
+ 'ar_cuit',
142
+ 'at_vat',
143
+ 'au_abn',
144
+ 'au_arn',
145
+ 'ba_tin',
146
+ 'bb_tin',
147
+ 'be_vat',
148
+ 'bg_uic',
149
+ 'bg_vat',
150
+ 'bh_vat',
151
+ 'bo_tin',
152
+ 'br_cnpj',
153
+ 'br_cpf',
154
+ 'bs_tin',
155
+ 'by_tin',
156
+ 'ca_bn',
157
+ 'ca_gst_hst',
158
+ 'ca_pst_bc',
159
+ 'ca_pst_mb',
160
+ 'ca_pst_sk',
161
+ 'ca_qst',
162
+ 'cd_nif',
163
+ 'ch_uid',
164
+ 'ch_vat',
165
+ 'cl_tin',
166
+ 'cn_tin',
167
+ 'co_nit',
168
+ 'cr_tin',
169
+ 'cy_vat',
170
+ 'cz_vat',
171
+ 'de_stn',
172
+ 'de_vat',
173
+ 'dk_vat',
174
+ 'do_rcn',
175
+ 'ec_ruc',
176
+ 'ee_vat',
177
+ 'eg_tin',
178
+ 'es_cif',
179
+ 'es_vat',
180
+ 'eu_oss_vat',
181
+ 'fi_vat',
182
+ 'fr_vat',
183
+ 'gb_vat',
184
+ 'ge_vat',
185
+ 'gn_nif',
186
+ 'gr_vat',
187
+ 'hk_br',
188
+ 'hr_oib',
189
+ 'hr_vat',
190
+ 'hu_tin',
191
+ 'hu_vat',
192
+ 'id_npwp',
193
+ 'ie_vat',
194
+ 'il_vat',
195
+ 'in_gst',
196
+ 'is_vat',
197
+ 'it_vat',
198
+ 'jp_cn',
199
+ 'jp_rn',
200
+ 'jp_trn',
201
+ 'ke_pin',
202
+ 'kh_tin',
203
+ 'kr_brn',
204
+ 'kz_bin',
205
+ 'li_uid',
206
+ 'li_vat',
207
+ 'lt_vat',
208
+ 'lu_vat',
209
+ 'lv_vat',
210
+ 'ma_vat',
211
+ 'md_vat',
212
+ 'me_pib',
213
+ 'mk_vat',
214
+ 'mr_nif',
215
+ 'mt_vat',
216
+ 'mx_rfc',
217
+ 'my_frp',
218
+ 'my_itn',
219
+ 'my_sst',
220
+ 'ng_tin',
221
+ 'nl_vat',
222
+ 'no_vat',
223
+ 'no_voec',
224
+ 'np_pan',
225
+ 'nz_gst',
226
+ 'om_vat',
227
+ 'pe_ruc',
228
+ 'ph_tin',
229
+ 'pl_vat',
230
+ 'pt_vat',
231
+ 'ro_tin',
232
+ 'ro_vat',
233
+ 'rs_pib',
234
+ 'ru_inn',
235
+ 'ru_kpp',
236
+ 'sa_vat',
237
+ 'se_vat',
238
+ 'sg_gst',
239
+ 'sg_uen',
240
+ 'si_tin',
241
+ 'si_vat',
242
+ 'sk_vat',
243
+ 'sn_ninea',
244
+ 'sr_fin',
245
+ 'sv_nit',
246
+ 'th_vat',
247
+ 'tj_tin',
248
+ 'tr_tin',
249
+ 'tw_vat',
250
+ 'tz_vat',
251
+ 'ua_vat',
252
+ 'ug_tin',
253
+ 'us_ein',
254
+ 'uy_ruc',
255
+ 'uz_tin',
256
+ 'uz_vat',
257
+ 've_rif',
258
+ 'vn_tin',
259
+ 'xi_vat',
260
+ 'za_vat',
261
+ 'zm_tin',
262
+ 'zw_tin',
263
+ ''
264
+ ]
78
265
  }
79
266
  },
80
- required: ['email', 'individual_name'],
267
+ required: [
268
+ 'type',
269
+ 'email',
270
+ 'individual_name'
271
+ ],
81
272
  additionalProperties: false
82
273
  };
83
274
  export const BillingCreditsSchema = {
@@ -92,7 +283,10 @@ export const BillingCreditsSchema = {
92
283
  type: 'string',
93
284
  description: 'Type of the promotional code.',
94
285
  example: 'credit',
95
- enum: ['credit', 'discount']
286
+ enum: [
287
+ 'credit',
288
+ 'discount'
289
+ ]
96
290
  },
97
291
  date_start: {
98
292
  type: 'string',
@@ -129,7 +323,12 @@ export const BillingCreditsSchema = {
129
323
  example: 8
130
324
  }
131
325
  },
132
- required: ['type', 'date_start', 'code', 'value_total'],
326
+ required: [
327
+ 'type',
328
+ 'date_start',
329
+ 'code',
330
+ 'value_total'
331
+ ],
133
332
  additionalProperties: false
134
333
  };
135
334
  export const ChartCreateInputSchema = {
@@ -170,7 +369,13 @@ export const ChartCreateInputSchema = {
170
369
  example: 'postgresql'
171
370
  }
172
371
  },
173
- required: ['values', 'version_channel', 'name', 'namespace', 'chart'],
372
+ required: [
373
+ 'values',
374
+ 'version_channel',
375
+ 'name',
376
+ 'namespace',
377
+ 'chart'
378
+ ],
174
379
  additionalProperties: false
175
380
  };
176
381
  export const ChartSchema = {
@@ -212,9 +417,8 @@ export const ChartSchema = {
212
417
  },
213
418
  status: {
214
419
  type: 'string',
215
- description: 'Status of the chart deployment.',
216
- example: 'active',
217
- enum: ['InstallSucceeded', 'InstallFailed', 'UpgradeSucceeded', 'UpgradeFailed', 'TestSucceeded', 'TestFailed', 'RollbackSucceeded', 'RollbackFailed', 'UninstallSucceeded', 'UninstallFailed', 'ArtifactFailed', 'DependencyNotReady', 'Progressing', 'SourceNotReady']
420
+ description: 'Status of the chart deployment (Flux HelmRelease Ready condition reason, e.g. InstallSucceeded, UpgradeFailed, Progressing).',
421
+ example: 'InstallSucceeded'
218
422
  },
219
423
  version_current: {
220
424
  type: 'string',
@@ -237,7 +441,18 @@ export const ChartSchema = {
237
441
  example: true
238
442
  }
239
443
  },
240
- required: ['values', 'version_channel', 'name', 'namespace', 'chart', 'status', 'version_current', 'created_at', 'updated_at', 'ready'],
444
+ required: [
445
+ 'values',
446
+ 'version_channel',
447
+ 'name',
448
+ 'namespace',
449
+ 'chart',
450
+ 'status',
451
+ 'version_current',
452
+ 'created_at',
453
+ 'updated_at',
454
+ 'ready'
455
+ ],
241
456
  additionalProperties: false
242
457
  };
243
458
  export const ChartUpdateInputSchema = {
@@ -254,7 +469,10 @@ export const ChartUpdateInputSchema = {
254
469
  example: '2.x.x-cfke.x'
255
470
  }
256
471
  },
257
- required: ['values', 'version_channel'],
472
+ required: [
473
+ 'values',
474
+ 'version_channel'
475
+ ],
258
476
  additionalProperties: false
259
477
  };
260
478
  export const ClusterCreateInputSchema = {
@@ -271,26 +489,118 @@ export const ClusterCreateInputSchema = {
271
489
  tier: {
272
490
  type: 'string',
273
491
  description: 'Tier of the cluster.',
492
+ default: 'basic',
274
493
  example: 'pro',
275
- enum: ['basic', 'pro']
276
- },
277
- region: {
278
- type: 'string',
279
- description: 'Cloudfleet control plane region. One of "staging", "northamerica-central-1", "europe-central-1a", "northamerica-central-1a". This field can not be updated after creation.',
280
- default: 'staging',
281
- example: 'northamerica-central-1a',
282
- enum: ['staging', 'northamerica-central-1', 'europe-central-1a', 'northamerica-central-1a']
494
+ enum: [
495
+ 'basic',
496
+ 'pro',
497
+ 'enterprise'
498
+ ]
283
499
  },
284
500
  version_channel: {
285
501
  type: 'string',
286
502
  pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
287
503
  description: 'Version of the kubernetes cluster.',
288
504
  default: '1.x.x-cfke.x',
289
- example: '1.29.x-cfke.x'
505
+ example: '1.x.x-cfke.x'
506
+ },
507
+ release_channel: {
508
+ type: 'string',
509
+ description: 'Release channel for the cluster\'s control plane.',
510
+ default: 'rapid',
511
+ example: 'rapid',
512
+ enum: [
513
+ 'rapid',
514
+ 'stable',
515
+ 'extended'
516
+ ]
517
+ },
518
+ features: {
519
+ type: 'object',
520
+ properties: {
521
+ gpu_sharing_strategy: {
522
+ type: 'string',
523
+ description: 'GPU sharing strategy.',
524
+ default: 'none',
525
+ example: 'none',
526
+ enum: [
527
+ 'none',
528
+ 'mps',
529
+ 'time_slicing'
530
+ ]
531
+ },
532
+ gpu_max_shared_clients_per_gpu: {
533
+ type: 'integer',
534
+ minimum: 2,
535
+ maximum: 48,
536
+ description: 'Maximum number of pods that may share a single GPU.',
537
+ default: 4,
538
+ example: 10
539
+ },
540
+ cilium_socket_lb_host_namespace_only: {
541
+ type: 'boolean',
542
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
543
+ example: false
544
+ }
545
+ },
546
+ additionalProperties: false,
547
+ description: 'Cluster feature toggles.',
548
+ default: {
549
+ gpu_sharing_strategy: 'none',
550
+ gpu_max_shared_clients_per_gpu: 4,
551
+ cilium_socket_lb_host_namespace_only: false
552
+ }
553
+ },
554
+ region: {
555
+ type: 'string',
556
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
557
+ example: 'europe-central-1a'
558
+ },
559
+ networking: {
560
+ type: 'object',
561
+ properties: {
562
+ pod_cidr: {
563
+ type: 'string',
564
+ description: 'CIDR block for pod IPs.',
565
+ default: '10.244.0.0/16'
566
+ },
567
+ service_cidr: {
568
+ type: 'string',
569
+ description: 'CIDR block for service IPs.',
570
+ default: '10.96.0.0/12'
571
+ },
572
+ dual_stack: {
573
+ type: 'boolean',
574
+ description: 'Enable IPv4+IPv6 dual-stack networking.'
575
+ },
576
+ pod_cidr_v6: {
577
+ type: 'string',
578
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
579
+ default: '2001:db8:1:2::/48'
580
+ },
581
+ service_cidr_v6: {
582
+ type: 'string',
583
+ description: 'IPv6 service CIDR. Requires dual_stack.',
584
+ default: '2001:db8:1:1::/112'
585
+ }
586
+ },
587
+ additionalProperties: false,
588
+ description: 'Cluster networking configuration. Immutable after creation.',
589
+ default: {
590
+ pod_cidr: '10.244.0.0/16',
591
+ service_cidr: '10.96.0.0/12',
592
+ dual_stack: false,
593
+ pod_cidr_v6: '2001:db8:1:2::/48',
594
+ service_cidr_v6: '2001:db8:1:1::/112'
595
+ }
290
596
  }
291
597
  },
292
- required: ['name', 'tier'],
293
- additionalProperties: false
598
+ required: [
599
+ 'name',
600
+ 'region'
601
+ ],
602
+ additionalProperties: false,
603
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
294
604
  };
295
605
  export const ClusterJoinInformationSchema = {
296
606
  type: 'object',
@@ -298,8 +608,7 @@ export const ClusterJoinInformationSchema = {
298
608
  certificate_authority: {
299
609
  type: 'string',
300
610
  description: 'Certificate authority data for the kubernetes cluster. This is the root certificate authority for the cluster.',
301
- example: `-----BEGIN CERTIFICATE-----
302
- MIIC0DCCAbigAwIBAgI...`
611
+ example: '-----BEGIN CERTIFICATE-----\nMIIC0DCCAbigAwIBAgI...'
303
612
  },
304
613
  endpoint: {
305
614
  type: 'string',
@@ -307,6 +616,16 @@ MIIC0DCCAbigAwIBAgI...`
307
616
  description: 'Internal URL of the Kubernetes cluster control plane. This is the endpoint that kubelet uses to connect to the cluster.',
308
617
  example: 'https://10.31.64.7:6443'
309
618
  },
619
+ cluster_dns: {
620
+ type: 'string',
621
+ description: 'Cluster DNS IP address. This is the IP address of the kube-dns service in the cluster.',
622
+ example: '10.96.0.10'
623
+ },
624
+ pod_cidr: {
625
+ type: 'string',
626
+ description: 'Pod CIDR for the cluster. Used to configure iptables rules on nodes to prevent Tailscale routing loops.',
627
+ example: '10.244.0.0/16'
628
+ },
310
629
  auth_key: {
311
630
  type: 'string',
312
631
  description: 'Authentication key for the cluster.',
@@ -323,7 +642,7 @@ MIIC0DCCAbigAwIBAgI...`
323
642
  kubernetes: {
324
643
  type: 'string',
325
644
  description: 'Kubernetes version of the cluster.',
326
- example: '1.29.3'
645
+ example: '1.33.7'
327
646
  },
328
647
  tailscale: {
329
648
  type: 'string',
@@ -341,7 +660,12 @@ MIIC0DCCAbigAwIBAgI...`
341
660
  example: '565.0.0'
342
661
  }
343
662
  },
344
- required: ['kubernetes', 'tailscale', 'containerd', 'nvidia_driver'],
663
+ required: [
664
+ 'kubernetes',
665
+ 'tailscale',
666
+ 'containerd',
667
+ 'nvidia_driver'
668
+ ],
345
669
  additionalProperties: false,
346
670
  description: 'Versions of the different components of the cluster.'
347
671
  },
@@ -364,12 +688,25 @@ MIIC0DCCAbigAwIBAgI...`
364
688
  example: '//iam.googleapis.com/projects/89014267864/locations/global/workloadIdentityPools/cfke/providers/oidc'
365
689
  }
366
690
  },
367
- required: ['metadata_url', 'aws_role_arn', 'gcp_workload_identity_provider'],
691
+ required: [
692
+ 'metadata_url',
693
+ 'aws_role_arn',
694
+ 'gcp_workload_identity_provider'
695
+ ],
368
696
  additionalProperties: false,
369
- description: "OIDC Information for hosts to access to third party API's."
697
+ description: 'OIDC Information for hosts to access to third party API\'s.'
370
698
  }
371
699
  },
372
- required: ['certificate_authority', 'endpoint', 'auth_key', 'bootstrap_token', 'versions', 'third_party_api_access_config'],
700
+ required: [
701
+ 'certificate_authority',
702
+ 'endpoint',
703
+ 'cluster_dns',
704
+ 'pod_cidr',
705
+ 'auth_key',
706
+ 'bootstrap_token',
707
+ 'versions',
708
+ 'third_party_api_access_config'
709
+ ],
373
710
  additionalProperties: false
374
711
  };
375
712
  export const ClusterSchema = {
@@ -386,22 +723,122 @@ export const ClusterSchema = {
386
723
  tier: {
387
724
  type: 'string',
388
725
  description: 'Tier of the cluster.',
726
+ default: 'basic',
389
727
  example: 'pro',
390
- enum: ['basic', 'pro']
391
- },
392
- region: {
393
- type: 'string',
394
- description: 'Cloudfleet control plane region. One of "staging", "northamerica-central-1", "europe-central-1a", "northamerica-central-1a". This field can not be updated after creation.',
395
- default: 'staging',
396
- example: 'northamerica-central-1a',
397
- enum: ['staging', 'northamerica-central-1', 'europe-central-1a', 'northamerica-central-1a']
728
+ enum: [
729
+ 'basic',
730
+ 'pro',
731
+ 'enterprise'
732
+ ]
398
733
  },
399
734
  version_channel: {
400
735
  type: 'string',
401
736
  pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
402
737
  description: 'Version of the kubernetes cluster.',
403
738
  default: '1.x.x-cfke.x',
404
- example: '1.29.x-cfke.x'
739
+ example: '1.x.x-cfke.x'
740
+ },
741
+ release_channel: {
742
+ type: 'string',
743
+ description: 'Release channel for the cluster\'s control plane.',
744
+ default: 'rapid',
745
+ example: 'rapid',
746
+ enum: [
747
+ 'rapid',
748
+ 'stable',
749
+ 'extended'
750
+ ]
751
+ },
752
+ features: {
753
+ type: 'object',
754
+ properties: {
755
+ gpu_sharing_strategy: {
756
+ type: 'string',
757
+ description: 'GPU sharing strategy.',
758
+ default: 'none',
759
+ example: 'none',
760
+ enum: [
761
+ 'none',
762
+ 'mps',
763
+ 'time_slicing'
764
+ ]
765
+ },
766
+ gpu_max_shared_clients_per_gpu: {
767
+ type: 'integer',
768
+ minimum: 2,
769
+ maximum: 48,
770
+ description: 'Maximum number of pods that may share a single GPU.',
771
+ default: 4,
772
+ example: 10
773
+ },
774
+ cilium_socket_lb_host_namespace_only: {
775
+ type: 'boolean',
776
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
777
+ example: false
778
+ }
779
+ },
780
+ required: [
781
+ 'gpu_sharing_strategy',
782
+ 'gpu_max_shared_clients_per_gpu',
783
+ 'cilium_socket_lb_host_namespace_only'
784
+ ],
785
+ additionalProperties: false,
786
+ description: 'Cluster feature toggles.',
787
+ default: {
788
+ gpu_sharing_strategy: 'none',
789
+ gpu_max_shared_clients_per_gpu: 4,
790
+ cilium_socket_lb_host_namespace_only: false
791
+ }
792
+ },
793
+ region: {
794
+ type: 'string',
795
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
796
+ example: 'europe-central-1a'
797
+ },
798
+ networking: {
799
+ type: 'object',
800
+ properties: {
801
+ pod_cidr: {
802
+ type: 'string',
803
+ description: 'CIDR block for pod IPs.',
804
+ default: '10.244.0.0/16'
805
+ },
806
+ service_cidr: {
807
+ type: 'string',
808
+ description: 'CIDR block for service IPs.',
809
+ default: '10.96.0.0/12'
810
+ },
811
+ dual_stack: {
812
+ type: 'boolean',
813
+ description: 'Enable IPv4+IPv6 dual-stack networking.'
814
+ },
815
+ pod_cidr_v6: {
816
+ type: 'string',
817
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
818
+ default: '2001:db8:1:2::/48'
819
+ },
820
+ service_cidr_v6: {
821
+ type: 'string',
822
+ description: 'IPv6 service CIDR. Requires dual_stack.',
823
+ default: '2001:db8:1:1::/112'
824
+ }
825
+ },
826
+ required: [
827
+ 'pod_cidr',
828
+ 'service_cidr',
829
+ 'dual_stack',
830
+ 'pod_cidr_v6',
831
+ 'service_cidr_v6'
832
+ ],
833
+ additionalProperties: false,
834
+ description: 'Cluster networking configuration. Immutable after creation.',
835
+ default: {
836
+ pod_cidr: '10.244.0.0/16',
837
+ service_cidr: '10.96.0.0/12',
838
+ dual_stack: false,
839
+ pod_cidr_v6: '2001:db8:1:2::/48',
840
+ service_cidr_v6: '2001:db8:1:1::/112'
841
+ }
405
842
  },
406
843
  id: {
407
844
  type: 'string',
@@ -411,34 +848,56 @@ export const ClusterSchema = {
411
848
  },
412
849
  status: {
413
850
  type: 'string',
414
- description: 'Status of the cluster. When creating a new cluster, set to `active`. When deleting a clusters, set to `deleted`.',
415
- example: 'active',
416
- enum: ['active', 'disabled', 'deleted', 'creating', 'deployed', 'failed', 'updating']
851
+ description: 'Status of the cluster.',
852
+ example: 'deployed',
853
+ enum: [
854
+ 'creating',
855
+ 'deployed',
856
+ 'updating',
857
+ 'disabled'
858
+ ]
417
859
  },
418
860
  endpoint: {
419
861
  anyOf: [
420
862
  {
421
863
  type: 'string',
422
864
  format: 'uri',
423
- description: 'URL of the Kubernetes cluster control plane. This is the endpoint that kubectl uses to connect to the cluster.',
424
- example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.cloudfleet.dev:6443'
865
+ description: 'URL signed by a public CA of the Kubernetes cluster control plane. This is the endpoint that kubectl uses to connect to the cluster.',
866
+ example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
425
867
  },
426
868
  {
427
869
  type: 'string',
428
- enum: ['']
870
+ enum: [
871
+ ''
872
+ ]
873
+ }
874
+ ]
875
+ },
876
+ endpoint_public: {
877
+ anyOf: [
878
+ {
879
+ type: 'string',
880
+ format: 'uri',
881
+ description: 'Deprecated alias of `endpoint`; retained for backward compatibility.',
882
+ example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
883
+ },
884
+ {
885
+ type: 'string',
886
+ enum: [
887
+ ''
888
+ ]
429
889
  }
430
890
  ]
431
891
  },
432
892
  certificate_ca: {
433
893
  type: 'string',
434
894
  description: 'Certificate authority data for the kubernetes cluster. This is the root certificate authority for the cluster.',
435
- example: `-----BEGIN CERTIFICATE-----
436
- MIIC0DCCAbigAwIBAgI...`
895
+ example: '-----BEGIN CERTIFICATE-----\nMIIC0DCCAbigAwIBAgI...'
437
896
  },
438
897
  version_current: {
439
898
  type: 'string',
440
899
  description: 'Current version of the cluster.',
441
- example: '1.29.3-cfke.52'
900
+ example: '1.33.7-cfke.264'
442
901
  },
443
902
  created_at: {
444
903
  type: 'string',
@@ -456,8 +915,20 @@ MIIC0DCCAbigAwIBAgI...`
456
915
  example: true
457
916
  }
458
917
  },
459
- required: ['name', 'tier', 'id', 'status'],
460
- additionalProperties: false
918
+ required: [
919
+ 'name',
920
+ 'tier',
921
+ 'version_channel',
922
+ 'release_channel',
923
+ 'features',
924
+ 'region',
925
+ 'networking',
926
+ 'id',
927
+ 'status',
928
+ 'ready'
929
+ ],
930
+ additionalProperties: false,
931
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
461
932
  };
462
933
  export const ClusterUpdateInputSchema = {
463
934
  type: 'object',
@@ -473,18 +944,74 @@ export const ClusterUpdateInputSchema = {
473
944
  tier: {
474
945
  type: 'string',
475
946
  description: 'Tier of the cluster.',
947
+ default: 'basic',
476
948
  example: 'pro',
477
- enum: ['basic', 'pro']
949
+ enum: [
950
+ 'basic',
951
+ 'pro',
952
+ 'enterprise'
953
+ ]
478
954
  },
479
955
  version_channel: {
480
956
  type: 'string',
481
957
  pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
482
958
  description: 'Version of the kubernetes cluster.',
483
- example: '1.29.x-cfke.x'
959
+ default: '1.x.x-cfke.x',
960
+ example: '1.x.x-cfke.x'
961
+ },
962
+ release_channel: {
963
+ type: 'string',
964
+ description: 'Release channel for the cluster\'s control plane.',
965
+ default: 'rapid',
966
+ example: 'rapid',
967
+ enum: [
968
+ 'rapid',
969
+ 'stable',
970
+ 'extended'
971
+ ]
972
+ },
973
+ features: {
974
+ type: 'object',
975
+ properties: {
976
+ gpu_sharing_strategy: {
977
+ type: 'string',
978
+ description: 'GPU sharing strategy.',
979
+ default: 'none',
980
+ example: 'none',
981
+ enum: [
982
+ 'none',
983
+ 'mps',
984
+ 'time_slicing'
985
+ ]
986
+ },
987
+ gpu_max_shared_clients_per_gpu: {
988
+ type: 'integer',
989
+ minimum: 2,
990
+ maximum: 48,
991
+ description: 'Maximum number of pods that may share a single GPU.',
992
+ default: 4,
993
+ example: 10
994
+ },
995
+ cilium_socket_lb_host_namespace_only: {
996
+ type: 'boolean',
997
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
998
+ example: false
999
+ }
1000
+ },
1001
+ additionalProperties: false,
1002
+ description: 'Cluster feature toggles.',
1003
+ default: {
1004
+ gpu_sharing_strategy: 'none',
1005
+ gpu_max_shared_clients_per_gpu: 4,
1006
+ cilium_socket_lb_host_namespace_only: false
1007
+ }
484
1008
  }
485
1009
  },
486
- required: ['tier'],
487
- additionalProperties: false
1010
+ required: [
1011
+ 'name'
1012
+ ],
1013
+ additionalProperties: false,
1014
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
488
1015
  };
489
1016
  export const FleetCreateInputSchema = {
490
1017
  type: 'object',
@@ -493,13 +1020,12 @@ export const FleetCreateInputSchema = {
493
1020
  type: 'object',
494
1021
  properties: {
495
1022
  cpu: {
496
- type: 'number',
497
- format: 'float',
1023
+ type: 'integer',
498
1024
  minimum: 0,
499
- description: 'CPU limit in cores.'
1025
+ maximum: 100000,
1026
+ description: 'CPU limit in cores. Maximum 100,000.'
500
1027
  }
501
1028
  },
502
- required: ['cpu'],
503
1029
  additionalProperties: false,
504
1030
  description: 'Limits define a set of bounds for provisioning capacity.'
505
1031
  },
@@ -507,47 +1033,358 @@ export const FleetCreateInputSchema = {
507
1033
  type: 'object',
508
1034
  properties: {
509
1035
  enabled: {
510
- type: 'boolean',
511
- default: true
1036
+ type: 'boolean'
512
1037
  },
513
1038
  project: {
514
1039
  type: 'string',
515
- description: 'Project GCP Project id to deploy instances into'
1040
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1041
+ description: 'GCP project ID to deploy instances into. 6-30 chars, lowercase letters/digits/hyphens, must start with a letter and not end with a hyphen. Omit when GCP is disabled.',
1042
+ example: 'my-cloudfleet-project'
516
1043
  }
517
1044
  },
518
- required: ['project'],
1045
+ required: [
1046
+ 'enabled'
1047
+ ],
519
1048
  additionalProperties: false
520
1049
  },
521
1050
  hetzner: {
522
1051
  type: 'object',
523
1052
  properties: {
524
1053
  enabled: {
525
- type: 'boolean',
526
- default: true
1054
+ type: 'boolean'
527
1055
  },
528
1056
  apiKey: {
529
1057
  type: 'string',
530
- description: 'Hetzner Cloud API key with read / write access'
1058
+ maxLength: 64,
1059
+ minLength: 64,
1060
+ pattern: '^([A-Za-z0-9]{64}|\\*{64})$',
1061
+ description: 'Hetzner Cloud API token with read/write access (64 alphanumeric characters). Write-only: reads return a redacted placeholder, never the token. Omit the field, or send the placeholder back unchanged, to keep the existing key. Send a new value to rotate it.'
531
1062
  }
532
1063
  },
533
- required: ['apiKey'],
1064
+ required: [
1065
+ 'enabled'
1066
+ ],
534
1067
  additionalProperties: false
535
1068
  },
536
1069
  aws: {
537
1070
  type: 'object',
538
1071
  properties: {
539
1072
  enabled: {
540
- type: 'boolean',
541
- default: true
1073
+ type: 'boolean'
542
1074
  },
543
1075
  controllerRoleArn: {
544
1076
  type: 'string',
545
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1077
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1078
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1079
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
546
1080
  }
547
1081
  },
548
- required: ['controllerRoleArn'],
1082
+ required: [
1083
+ 'enabled'
1084
+ ],
549
1085
  additionalProperties: false
550
1086
  },
1087
+ constraints: {
1088
+ type: 'object',
1089
+ properties: {
1090
+ 'karpenter.sh/capacity-type': {
1091
+ type: 'array',
1092
+ items: {
1093
+ type: 'string',
1094
+ enum: [
1095
+ 'on-demand',
1096
+ 'spot'
1097
+ ]
1098
+ },
1099
+ minItems: 1,
1100
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1101
+ default: [
1102
+ 'on-demand',
1103
+ 'spot'
1104
+ ]
1105
+ },
1106
+ 'kubernetes.io/arch': {
1107
+ type: 'array',
1108
+ items: {
1109
+ type: 'string',
1110
+ enum: [
1111
+ 'amd64',
1112
+ 'arm64'
1113
+ ]
1114
+ },
1115
+ minItems: 1,
1116
+ description: 'Allowed values for `kubernetes.io/arch`.',
1117
+ default: [
1118
+ 'amd64'
1119
+ ]
1120
+ },
1121
+ 'cfke.io/instance-family': {
1122
+ type: 'array',
1123
+ items: {
1124
+ type: 'string',
1125
+ enum: [
1126
+ 'a1',
1127
+ 'a2',
1128
+ 'a3',
1129
+ 'a4',
1130
+ 'c1',
1131
+ 'c2',
1132
+ 'c2d',
1133
+ 'c3',
1134
+ 'c3d',
1135
+ 'c4',
1136
+ 'c4a',
1137
+ 'c4d',
1138
+ 'c5',
1139
+ 'c5a',
1140
+ 'c5ad',
1141
+ 'c5d',
1142
+ 'c5n',
1143
+ 'c6a',
1144
+ 'c6g',
1145
+ 'c6gd',
1146
+ 'c6gn',
1147
+ 'c6i',
1148
+ 'c6id',
1149
+ 'c6in',
1150
+ 'c7a',
1151
+ 'c7g',
1152
+ 'c7gd',
1153
+ 'c7gn',
1154
+ 'c7i',
1155
+ 'c7i-flex',
1156
+ 'c8g',
1157
+ 'c8gd',
1158
+ 'cax',
1159
+ 'ccx',
1160
+ 'cpx',
1161
+ 'cx',
1162
+ 'd2',
1163
+ 'd3',
1164
+ 'd3en',
1165
+ 'dl1',
1166
+ 'dl2q',
1167
+ 'e2',
1168
+ 'f1',
1169
+ 'f2',
1170
+ 'g1',
1171
+ 'g2',
1172
+ 'g4ad',
1173
+ 'g4dn',
1174
+ 'g5',
1175
+ 'g5g',
1176
+ 'g6',
1177
+ 'g6e',
1178
+ 'gr6',
1179
+ 'h1',
1180
+ 'h3',
1181
+ 'hpc6a',
1182
+ 'hpc6id',
1183
+ 'hpc7a',
1184
+ 'hpc7g',
1185
+ 'i2',
1186
+ 'i3',
1187
+ 'i3en',
1188
+ 'i4g',
1189
+ 'i4i',
1190
+ 'i7i',
1191
+ 'i7ie',
1192
+ 'i8g',
1193
+ 'im4gn',
1194
+ 'inf1',
1195
+ 'inf2',
1196
+ 'is4gen',
1197
+ 'm1',
1198
+ 'm2',
1199
+ 'm3',
1200
+ 'm4',
1201
+ 'm5',
1202
+ 'm5a',
1203
+ 'm5ad',
1204
+ 'm5d',
1205
+ 'm5dn',
1206
+ 'm5n',
1207
+ 'm5zn',
1208
+ 'm6a',
1209
+ 'm6g',
1210
+ 'm6gd',
1211
+ 'm6i',
1212
+ 'm6id',
1213
+ 'm6idn',
1214
+ 'm6in',
1215
+ 'm7a',
1216
+ 'm7g',
1217
+ 'm7gd',
1218
+ 'm7i',
1219
+ 'm7i-flex',
1220
+ 'm8g',
1221
+ 'm8gd',
1222
+ 'n1',
1223
+ 'n2',
1224
+ 'n2d',
1225
+ 'n4',
1226
+ 'p3',
1227
+ 'p3dn',
1228
+ 'p4d',
1229
+ 'p4de',
1230
+ 'p5',
1231
+ 'p5e',
1232
+ 'p5en',
1233
+ 'p6-b200',
1234
+ 'r3',
1235
+ 'r4',
1236
+ 'r5',
1237
+ 'r5a',
1238
+ 'r5ad',
1239
+ 'r5b',
1240
+ 'r5d',
1241
+ 'r5dn',
1242
+ 'r5n',
1243
+ 'r6a',
1244
+ 'r6g',
1245
+ 'r6gd',
1246
+ 'r6i',
1247
+ 'r6id',
1248
+ 'r6idn',
1249
+ 'r6in',
1250
+ 'r7a',
1251
+ 'r7g',
1252
+ 'r7gd',
1253
+ 'r7i',
1254
+ 'r7iz',
1255
+ 'r8g',
1256
+ 'r8gd',
1257
+ 't2',
1258
+ 't2a',
1259
+ 't2d',
1260
+ 't3',
1261
+ 't3a',
1262
+ 't4g',
1263
+ 'trn1',
1264
+ 'trn1n',
1265
+ 'u-3tb1',
1266
+ 'u-6tb1',
1267
+ 'u7i-12tb',
1268
+ 'u7i-6tb',
1269
+ 'u7i-8tb',
1270
+ 'u7in-16tb',
1271
+ 'u7in-24tb',
1272
+ 'u7in-32tb',
1273
+ 'vt1',
1274
+ 'x1',
1275
+ 'x1e',
1276
+ 'x2gd',
1277
+ 'x2idn',
1278
+ 'x2iedn',
1279
+ 'x2iezn',
1280
+ 'x4',
1281
+ 'x8g',
1282
+ 'z1d',
1283
+ 'z3'
1284
+ ]
1285
+ },
1286
+ description: 'Allowed values for `cfke.io/instance-family`.',
1287
+ default: []
1288
+ },
1289
+ 'topology.kubernetes.io/region': {
1290
+ type: 'array',
1291
+ items: {
1292
+ type: 'string',
1293
+ enum: [
1294
+ 'africa-south1',
1295
+ 'ap-northeast-1',
1296
+ 'ap-northeast-2',
1297
+ 'ap-northeast-3',
1298
+ 'ap-south-1',
1299
+ 'ap-southeast-1',
1300
+ 'ap-southeast-2',
1301
+ 'ash',
1302
+ 'asia-east1',
1303
+ 'asia-east2',
1304
+ 'asia-northeast1',
1305
+ 'asia-northeast2',
1306
+ 'asia-northeast3',
1307
+ 'asia-south1',
1308
+ 'asia-south2',
1309
+ 'asia-southeast1',
1310
+ 'asia-southeast2',
1311
+ 'australia-southeast1',
1312
+ 'australia-southeast2',
1313
+ 'ca-central-1',
1314
+ 'eu-central-1',
1315
+ 'eu-central-2',
1316
+ 'eu-north-1',
1317
+ 'eu-west-1',
1318
+ 'eu-west-2',
1319
+ 'eu-west-3',
1320
+ 'europe-central2',
1321
+ 'europe-north1',
1322
+ 'europe-southwest1',
1323
+ 'europe-west1',
1324
+ 'europe-west10',
1325
+ 'europe-west12',
1326
+ 'europe-west2',
1327
+ 'europe-west3',
1328
+ 'europe-west4',
1329
+ 'europe-west6',
1330
+ 'europe-west8',
1331
+ 'europe-west9',
1332
+ 'fsn1',
1333
+ 'hel1',
1334
+ 'hil',
1335
+ 'me-central1',
1336
+ 'me-central2',
1337
+ 'me-west1',
1338
+ 'nbg1',
1339
+ 'northamerica-northeast1',
1340
+ 'northamerica-northeast2',
1341
+ 'sa-east-1',
1342
+ 'sin',
1343
+ 'southamerica-east1',
1344
+ 'southamerica-west1',
1345
+ 'us-central1',
1346
+ 'us-east-1',
1347
+ 'us-east-2',
1348
+ 'us-east1',
1349
+ 'us-east4',
1350
+ 'us-east5',
1351
+ 'us-south1',
1352
+ 'us-west-1',
1353
+ 'us-west-2',
1354
+ 'us-west1',
1355
+ 'us-west2',
1356
+ 'us-west3',
1357
+ 'us-west4'
1358
+ ]
1359
+ },
1360
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
1361
+ default: []
1362
+ }
1363
+ },
1364
+ additionalProperties: false,
1365
+ description: 'Constraints define scheduling and provisioning requirements for the fleet. Each field restricts the values allowed for a given Kubernetes label key. Multiple constraints are ANDed together.',
1366
+ default: {
1367
+ 'karpenter.sh/capacity-type': [
1368
+ 'on-demand',
1369
+ 'spot'
1370
+ ],
1371
+ 'kubernetes.io/arch': [
1372
+ 'amd64'
1373
+ ],
1374
+ 'cfke.io/instance-family': [],
1375
+ 'topology.kubernetes.io/region': []
1376
+ }
1377
+ },
1378
+ scalingProfile: {
1379
+ type: 'string',
1380
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet. Full-overwrite: omit to reset to the default (`conservative`).',
1381
+ default: 'conservative',
1382
+ example: 'conservative',
1383
+ enum: [
1384
+ 'aggressive',
1385
+ 'conservative'
1386
+ ]
1387
+ },
551
1388
  id: {
552
1389
  type: 'string',
553
1390
  maxLength: 63,
@@ -557,8 +1394,11 @@ export const FleetCreateInputSchema = {
557
1394
  example: 'new-clouds-fleet'
558
1395
  }
559
1396
  },
560
- required: ['id'],
561
- additionalProperties: false
1397
+ required: [
1398
+ 'id'
1399
+ ],
1400
+ additionalProperties: false,
1401
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
562
1402
  };
563
1403
  export const FleetSchema = {
564
1404
  type: 'object',
@@ -567,13 +1407,12 @@ export const FleetSchema = {
567
1407
  type: 'object',
568
1408
  properties: {
569
1409
  cpu: {
570
- type: 'number',
571
- format: 'float',
1410
+ type: 'integer',
572
1411
  minimum: 0,
573
- description: 'CPU limit in cores.'
1412
+ maximum: 100000,
1413
+ description: 'CPU limit in cores. Maximum 100,000.'
574
1414
  }
575
1415
  },
576
- required: ['cpu'],
577
1416
  additionalProperties: false,
578
1417
  description: 'Limits define a set of bounds for provisioning capacity.'
579
1418
  },
@@ -581,47 +1420,360 @@ export const FleetSchema = {
581
1420
  type: 'object',
582
1421
  properties: {
583
1422
  enabled: {
584
- type: 'boolean',
585
- default: true
1423
+ type: 'boolean'
586
1424
  },
587
1425
  project: {
588
1426
  type: 'string',
589
- description: 'Project GCP Project id to deploy instances into'
1427
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1428
+ description: 'GCP project ID to deploy instances into. 6-30 chars, lowercase letters/digits/hyphens, must start with a letter and not end with a hyphen. Omit when GCP is disabled.',
1429
+ example: 'my-cloudfleet-project'
590
1430
  }
591
1431
  },
592
- required: ['project'],
1432
+ required: [
1433
+ 'enabled'
1434
+ ],
593
1435
  additionalProperties: false
594
1436
  },
595
1437
  hetzner: {
596
1438
  type: 'object',
597
1439
  properties: {
598
1440
  enabled: {
599
- type: 'boolean',
600
- default: true
1441
+ type: 'boolean'
601
1442
  },
602
1443
  apiKey: {
603
1444
  type: 'string',
604
- description: 'Hetzner Cloud API key with read / write access'
1445
+ pattern: '^\\*{64}$',
1446
+ description: 'Redacted Hetzner API token. Returned as 64 asterisks when a token is configured; omitted otherwise. The real value is never echoed by the API.'
605
1447
  }
606
1448
  },
607
- required: ['apiKey'],
1449
+ required: [
1450
+ 'enabled'
1451
+ ],
608
1452
  additionalProperties: false
609
1453
  },
610
1454
  aws: {
611
1455
  type: 'object',
612
1456
  properties: {
613
1457
  enabled: {
614
- type: 'boolean',
615
- default: true
1458
+ type: 'boolean'
616
1459
  },
617
1460
  controllerRoleArn: {
618
1461
  type: 'string',
619
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1462
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1463
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1464
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
620
1465
  }
621
1466
  },
622
- required: ['controllerRoleArn'],
1467
+ required: [
1468
+ 'enabled'
1469
+ ],
623
1470
  additionalProperties: false
624
1471
  },
1472
+ constraints: {
1473
+ type: 'object',
1474
+ properties: {
1475
+ 'karpenter.sh/capacity-type': {
1476
+ type: 'array',
1477
+ items: {
1478
+ type: 'string',
1479
+ enum: [
1480
+ 'on-demand',
1481
+ 'spot'
1482
+ ]
1483
+ },
1484
+ minItems: 1,
1485
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1486
+ default: [
1487
+ 'on-demand',
1488
+ 'spot'
1489
+ ]
1490
+ },
1491
+ 'kubernetes.io/arch': {
1492
+ type: 'array',
1493
+ items: {
1494
+ type: 'string',
1495
+ enum: [
1496
+ 'amd64',
1497
+ 'arm64'
1498
+ ]
1499
+ },
1500
+ minItems: 1,
1501
+ description: 'Allowed values for `kubernetes.io/arch`.',
1502
+ default: [
1503
+ 'amd64'
1504
+ ]
1505
+ },
1506
+ 'cfke.io/instance-family': {
1507
+ type: 'array',
1508
+ items: {
1509
+ type: 'string',
1510
+ enum: [
1511
+ 'a1',
1512
+ 'a2',
1513
+ 'a3',
1514
+ 'a4',
1515
+ 'c1',
1516
+ 'c2',
1517
+ 'c2d',
1518
+ 'c3',
1519
+ 'c3d',
1520
+ 'c4',
1521
+ 'c4a',
1522
+ 'c4d',
1523
+ 'c5',
1524
+ 'c5a',
1525
+ 'c5ad',
1526
+ 'c5d',
1527
+ 'c5n',
1528
+ 'c6a',
1529
+ 'c6g',
1530
+ 'c6gd',
1531
+ 'c6gn',
1532
+ 'c6i',
1533
+ 'c6id',
1534
+ 'c6in',
1535
+ 'c7a',
1536
+ 'c7g',
1537
+ 'c7gd',
1538
+ 'c7gn',
1539
+ 'c7i',
1540
+ 'c7i-flex',
1541
+ 'c8g',
1542
+ 'c8gd',
1543
+ 'cax',
1544
+ 'ccx',
1545
+ 'cpx',
1546
+ 'cx',
1547
+ 'd2',
1548
+ 'd3',
1549
+ 'd3en',
1550
+ 'dl1',
1551
+ 'dl2q',
1552
+ 'e2',
1553
+ 'f1',
1554
+ 'f2',
1555
+ 'g1',
1556
+ 'g2',
1557
+ 'g4ad',
1558
+ 'g4dn',
1559
+ 'g5',
1560
+ 'g5g',
1561
+ 'g6',
1562
+ 'g6e',
1563
+ 'gr6',
1564
+ 'h1',
1565
+ 'h3',
1566
+ 'hpc6a',
1567
+ 'hpc6id',
1568
+ 'hpc7a',
1569
+ 'hpc7g',
1570
+ 'i2',
1571
+ 'i3',
1572
+ 'i3en',
1573
+ 'i4g',
1574
+ 'i4i',
1575
+ 'i7i',
1576
+ 'i7ie',
1577
+ 'i8g',
1578
+ 'im4gn',
1579
+ 'inf1',
1580
+ 'inf2',
1581
+ 'is4gen',
1582
+ 'm1',
1583
+ 'm2',
1584
+ 'm3',
1585
+ 'm4',
1586
+ 'm5',
1587
+ 'm5a',
1588
+ 'm5ad',
1589
+ 'm5d',
1590
+ 'm5dn',
1591
+ 'm5n',
1592
+ 'm5zn',
1593
+ 'm6a',
1594
+ 'm6g',
1595
+ 'm6gd',
1596
+ 'm6i',
1597
+ 'm6id',
1598
+ 'm6idn',
1599
+ 'm6in',
1600
+ 'm7a',
1601
+ 'm7g',
1602
+ 'm7gd',
1603
+ 'm7i',
1604
+ 'm7i-flex',
1605
+ 'm8g',
1606
+ 'm8gd',
1607
+ 'n1',
1608
+ 'n2',
1609
+ 'n2d',
1610
+ 'n4',
1611
+ 'p3',
1612
+ 'p3dn',
1613
+ 'p4d',
1614
+ 'p4de',
1615
+ 'p5',
1616
+ 'p5e',
1617
+ 'p5en',
1618
+ 'p6-b200',
1619
+ 'r3',
1620
+ 'r4',
1621
+ 'r5',
1622
+ 'r5a',
1623
+ 'r5ad',
1624
+ 'r5b',
1625
+ 'r5d',
1626
+ 'r5dn',
1627
+ 'r5n',
1628
+ 'r6a',
1629
+ 'r6g',
1630
+ 'r6gd',
1631
+ 'r6i',
1632
+ 'r6id',
1633
+ 'r6idn',
1634
+ 'r6in',
1635
+ 'r7a',
1636
+ 'r7g',
1637
+ 'r7gd',
1638
+ 'r7i',
1639
+ 'r7iz',
1640
+ 'r8g',
1641
+ 'r8gd',
1642
+ 't2',
1643
+ 't2a',
1644
+ 't2d',
1645
+ 't3',
1646
+ 't3a',
1647
+ 't4g',
1648
+ 'trn1',
1649
+ 'trn1n',
1650
+ 'u-3tb1',
1651
+ 'u-6tb1',
1652
+ 'u7i-12tb',
1653
+ 'u7i-6tb',
1654
+ 'u7i-8tb',
1655
+ 'u7in-16tb',
1656
+ 'u7in-24tb',
1657
+ 'u7in-32tb',
1658
+ 'vt1',
1659
+ 'x1',
1660
+ 'x1e',
1661
+ 'x2gd',
1662
+ 'x2idn',
1663
+ 'x2iedn',
1664
+ 'x2iezn',
1665
+ 'x4',
1666
+ 'x8g',
1667
+ 'z1d',
1668
+ 'z3'
1669
+ ]
1670
+ },
1671
+ description: 'Allowed values for `cfke.io/instance-family`.',
1672
+ default: []
1673
+ },
1674
+ 'topology.kubernetes.io/region': {
1675
+ type: 'array',
1676
+ items: {
1677
+ type: 'string',
1678
+ enum: [
1679
+ 'africa-south1',
1680
+ 'ap-northeast-1',
1681
+ 'ap-northeast-2',
1682
+ 'ap-northeast-3',
1683
+ 'ap-south-1',
1684
+ 'ap-southeast-1',
1685
+ 'ap-southeast-2',
1686
+ 'ash',
1687
+ 'asia-east1',
1688
+ 'asia-east2',
1689
+ 'asia-northeast1',
1690
+ 'asia-northeast2',
1691
+ 'asia-northeast3',
1692
+ 'asia-south1',
1693
+ 'asia-south2',
1694
+ 'asia-southeast1',
1695
+ 'asia-southeast2',
1696
+ 'australia-southeast1',
1697
+ 'australia-southeast2',
1698
+ 'ca-central-1',
1699
+ 'eu-central-1',
1700
+ 'eu-central-2',
1701
+ 'eu-north-1',
1702
+ 'eu-west-1',
1703
+ 'eu-west-2',
1704
+ 'eu-west-3',
1705
+ 'europe-central2',
1706
+ 'europe-north1',
1707
+ 'europe-southwest1',
1708
+ 'europe-west1',
1709
+ 'europe-west10',
1710
+ 'europe-west12',
1711
+ 'europe-west2',
1712
+ 'europe-west3',
1713
+ 'europe-west4',
1714
+ 'europe-west6',
1715
+ 'europe-west8',
1716
+ 'europe-west9',
1717
+ 'fsn1',
1718
+ 'hel1',
1719
+ 'hil',
1720
+ 'me-central1',
1721
+ 'me-central2',
1722
+ 'me-west1',
1723
+ 'nbg1',
1724
+ 'northamerica-northeast1',
1725
+ 'northamerica-northeast2',
1726
+ 'sa-east-1',
1727
+ 'sin',
1728
+ 'southamerica-east1',
1729
+ 'southamerica-west1',
1730
+ 'us-central1',
1731
+ 'us-east-1',
1732
+ 'us-east-2',
1733
+ 'us-east1',
1734
+ 'us-east4',
1735
+ 'us-east5',
1736
+ 'us-south1',
1737
+ 'us-west-1',
1738
+ 'us-west-2',
1739
+ 'us-west1',
1740
+ 'us-west2',
1741
+ 'us-west3',
1742
+ 'us-west4'
1743
+ ]
1744
+ },
1745
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
1746
+ default: []
1747
+ }
1748
+ },
1749
+ required: [
1750
+ 'karpenter.sh/capacity-type',
1751
+ 'kubernetes.io/arch'
1752
+ ],
1753
+ additionalProperties: false,
1754
+ description: 'Constraints define scheduling and provisioning requirements for the fleet. Each field restricts the values allowed for a given Kubernetes label key. Multiple constraints are ANDed together.',
1755
+ default: {
1756
+ 'karpenter.sh/capacity-type': [
1757
+ 'on-demand',
1758
+ 'spot'
1759
+ ],
1760
+ 'kubernetes.io/arch': [
1761
+ 'amd64'
1762
+ ],
1763
+ 'cfke.io/instance-family': [],
1764
+ 'topology.kubernetes.io/region': []
1765
+ }
1766
+ },
1767
+ scalingProfile: {
1768
+ type: 'string',
1769
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet. Full-overwrite: omit to reset to the default (`conservative`).',
1770
+ default: 'conservative',
1771
+ example: 'conservative',
1772
+ enum: [
1773
+ 'aggressive',
1774
+ 'conservative'
1775
+ ]
1776
+ },
625
1777
  id: {
626
1778
  type: 'string',
627
1779
  maxLength: 63,
@@ -629,10 +1781,38 @@ export const FleetSchema = {
629
1781
  pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
630
1782
  description: 'Unique identifier of the kubernetes fleet.',
631
1783
  example: 'new-clouds-fleet'
1784
+ },
1785
+ ready: {
1786
+ type: 'boolean',
1787
+ description: 'Indicates whether the fleet configuration is healthy.',
1788
+ example: true
1789
+ },
1790
+ status_message: {
1791
+ type: 'string',
1792
+ description: 'Human-readable reason the fleet is not ready. Present only when `ready` is false.',
1793
+ example: 'Invalid provider permissions.'
1794
+ },
1795
+ created_at: {
1796
+ type: 'string',
1797
+ description: 'Creation date and time of the fleet.',
1798
+ example: '2024-09-12T09:11:27Z'
1799
+ },
1800
+ updated_at: {
1801
+ type: 'string',
1802
+ description: 'Date and time the fleet was last updated.',
1803
+ example: '2024-09-12T09:11:27Z'
632
1804
  }
633
1805
  },
634
- required: ['id'],
635
- additionalProperties: false
1806
+ required: [
1807
+ 'constraints',
1808
+ 'scalingProfile',
1809
+ 'id',
1810
+ 'ready',
1811
+ 'created_at',
1812
+ 'updated_at'
1813
+ ],
1814
+ additionalProperties: false,
1815
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
636
1816
  };
637
1817
  export const FleetUpdateInputSchema = {
638
1818
  type: 'object',
@@ -641,13 +1821,12 @@ export const FleetUpdateInputSchema = {
641
1821
  type: 'object',
642
1822
  properties: {
643
1823
  cpu: {
644
- type: 'number',
645
- format: 'float',
1824
+ type: 'integer',
646
1825
  minimum: 0,
647
- description: 'CPU limit in cores.'
1826
+ maximum: 100000,
1827
+ description: 'CPU limit in cores. Maximum 100,000.'
648
1828
  }
649
1829
  },
650
- required: ['cpu'],
651
1830
  additionalProperties: false,
652
1831
  description: 'Limits define a set of bounds for provisioning capacity.'
653
1832
  },
@@ -655,66 +1834,403 @@ export const FleetUpdateInputSchema = {
655
1834
  type: 'object',
656
1835
  properties: {
657
1836
  enabled: {
658
- type: 'boolean',
659
- default: true
1837
+ type: 'boolean'
660
1838
  },
661
1839
  project: {
662
1840
  type: 'string',
663
- description: 'Project GCP Project id to deploy instances into'
1841
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1842
+ description: 'GCP project ID to deploy instances into. 6-30 chars, lowercase letters/digits/hyphens, must start with a letter and not end with a hyphen. Omit when GCP is disabled.',
1843
+ example: 'my-cloudfleet-project'
664
1844
  }
665
1845
  },
666
- required: ['project'],
1846
+ required: [
1847
+ 'enabled'
1848
+ ],
667
1849
  additionalProperties: false
668
1850
  },
669
1851
  hetzner: {
670
1852
  type: 'object',
671
1853
  properties: {
672
1854
  enabled: {
673
- type: 'boolean',
674
- default: true
1855
+ type: 'boolean'
675
1856
  },
676
1857
  apiKey: {
677
1858
  type: 'string',
678
- description: 'Hetzner Cloud API key with read / write access'
1859
+ maxLength: 64,
1860
+ minLength: 64,
1861
+ pattern: '^([A-Za-z0-9]{64}|\\*{64})$',
1862
+ description: 'Hetzner Cloud API token with read/write access (64 alphanumeric characters). Write-only: reads return a redacted placeholder, never the token. Omit the field, or send the placeholder back unchanged, to keep the existing key. Send a new value to rotate it.'
679
1863
  }
680
1864
  },
681
- required: ['apiKey'],
1865
+ required: [
1866
+ 'enabled'
1867
+ ],
682
1868
  additionalProperties: false
683
1869
  },
684
1870
  aws: {
685
1871
  type: 'object',
686
1872
  properties: {
687
1873
  enabled: {
688
- type: 'boolean',
689
- default: true
1874
+ type: 'boolean'
690
1875
  },
691
1876
  controllerRoleArn: {
692
1877
  type: 'string',
693
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1878
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1879
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1880
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
694
1881
  }
695
1882
  },
696
- required: ['controllerRoleArn'],
1883
+ required: [
1884
+ 'enabled'
1885
+ ],
697
1886
  additionalProperties: false
698
- }
699
- },
700
- additionalProperties: false
701
- };
702
- export const InviteSchema = {
703
- type: 'object',
704
- properties: {
705
- id: {
706
- type: 'string',
707
- description: 'Unique identifier of the invitation.',
708
- example: '65831dd20d20165489cbb868'
709
1887
  },
710
- organization_id: {
711
- type: 'string',
712
- format: 'uuid',
713
- description: 'Unique identifier of the organization the project belongs to. UUID v4 string in canonical form',
714
- example: 'e94d30ec-a2dd-4dcb-832c-ac2be144ba91'
715
- },
716
- date_created: {
717
- type: 'string',
1888
+ constraints: {
1889
+ type: 'object',
1890
+ properties: {
1891
+ 'karpenter.sh/capacity-type': {
1892
+ type: 'array',
1893
+ items: {
1894
+ type: 'string',
1895
+ enum: [
1896
+ 'on-demand',
1897
+ 'spot'
1898
+ ]
1899
+ },
1900
+ minItems: 1,
1901
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1902
+ default: [
1903
+ 'on-demand',
1904
+ 'spot'
1905
+ ]
1906
+ },
1907
+ 'kubernetes.io/arch': {
1908
+ type: 'array',
1909
+ items: {
1910
+ type: 'string',
1911
+ enum: [
1912
+ 'amd64',
1913
+ 'arm64'
1914
+ ]
1915
+ },
1916
+ minItems: 1,
1917
+ description: 'Allowed values for `kubernetes.io/arch`.',
1918
+ default: [
1919
+ 'amd64'
1920
+ ]
1921
+ },
1922
+ 'cfke.io/instance-family': {
1923
+ type: 'array',
1924
+ items: {
1925
+ type: 'string',
1926
+ enum: [
1927
+ 'a1',
1928
+ 'a2',
1929
+ 'a3',
1930
+ 'a4',
1931
+ 'c1',
1932
+ 'c2',
1933
+ 'c2d',
1934
+ 'c3',
1935
+ 'c3d',
1936
+ 'c4',
1937
+ 'c4a',
1938
+ 'c4d',
1939
+ 'c5',
1940
+ 'c5a',
1941
+ 'c5ad',
1942
+ 'c5d',
1943
+ 'c5n',
1944
+ 'c6a',
1945
+ 'c6g',
1946
+ 'c6gd',
1947
+ 'c6gn',
1948
+ 'c6i',
1949
+ 'c6id',
1950
+ 'c6in',
1951
+ 'c7a',
1952
+ 'c7g',
1953
+ 'c7gd',
1954
+ 'c7gn',
1955
+ 'c7i',
1956
+ 'c7i-flex',
1957
+ 'c8g',
1958
+ 'c8gd',
1959
+ 'cax',
1960
+ 'ccx',
1961
+ 'cpx',
1962
+ 'cx',
1963
+ 'd2',
1964
+ 'd3',
1965
+ 'd3en',
1966
+ 'dl1',
1967
+ 'dl2q',
1968
+ 'e2',
1969
+ 'f1',
1970
+ 'f2',
1971
+ 'g1',
1972
+ 'g2',
1973
+ 'g4ad',
1974
+ 'g4dn',
1975
+ 'g5',
1976
+ 'g5g',
1977
+ 'g6',
1978
+ 'g6e',
1979
+ 'gr6',
1980
+ 'h1',
1981
+ 'h3',
1982
+ 'hpc6a',
1983
+ 'hpc6id',
1984
+ 'hpc7a',
1985
+ 'hpc7g',
1986
+ 'i2',
1987
+ 'i3',
1988
+ 'i3en',
1989
+ 'i4g',
1990
+ 'i4i',
1991
+ 'i7i',
1992
+ 'i7ie',
1993
+ 'i8g',
1994
+ 'im4gn',
1995
+ 'inf1',
1996
+ 'inf2',
1997
+ 'is4gen',
1998
+ 'm1',
1999
+ 'm2',
2000
+ 'm3',
2001
+ 'm4',
2002
+ 'm5',
2003
+ 'm5a',
2004
+ 'm5ad',
2005
+ 'm5d',
2006
+ 'm5dn',
2007
+ 'm5n',
2008
+ 'm5zn',
2009
+ 'm6a',
2010
+ 'm6g',
2011
+ 'm6gd',
2012
+ 'm6i',
2013
+ 'm6id',
2014
+ 'm6idn',
2015
+ 'm6in',
2016
+ 'm7a',
2017
+ 'm7g',
2018
+ 'm7gd',
2019
+ 'm7i',
2020
+ 'm7i-flex',
2021
+ 'm8g',
2022
+ 'm8gd',
2023
+ 'n1',
2024
+ 'n2',
2025
+ 'n2d',
2026
+ 'n4',
2027
+ 'p3',
2028
+ 'p3dn',
2029
+ 'p4d',
2030
+ 'p4de',
2031
+ 'p5',
2032
+ 'p5e',
2033
+ 'p5en',
2034
+ 'p6-b200',
2035
+ 'r3',
2036
+ 'r4',
2037
+ 'r5',
2038
+ 'r5a',
2039
+ 'r5ad',
2040
+ 'r5b',
2041
+ 'r5d',
2042
+ 'r5dn',
2043
+ 'r5n',
2044
+ 'r6a',
2045
+ 'r6g',
2046
+ 'r6gd',
2047
+ 'r6i',
2048
+ 'r6id',
2049
+ 'r6idn',
2050
+ 'r6in',
2051
+ 'r7a',
2052
+ 'r7g',
2053
+ 'r7gd',
2054
+ 'r7i',
2055
+ 'r7iz',
2056
+ 'r8g',
2057
+ 'r8gd',
2058
+ 't2',
2059
+ 't2a',
2060
+ 't2d',
2061
+ 't3',
2062
+ 't3a',
2063
+ 't4g',
2064
+ 'trn1',
2065
+ 'trn1n',
2066
+ 'u-3tb1',
2067
+ 'u-6tb1',
2068
+ 'u7i-12tb',
2069
+ 'u7i-6tb',
2070
+ 'u7i-8tb',
2071
+ 'u7in-16tb',
2072
+ 'u7in-24tb',
2073
+ 'u7in-32tb',
2074
+ 'vt1',
2075
+ 'x1',
2076
+ 'x1e',
2077
+ 'x2gd',
2078
+ 'x2idn',
2079
+ 'x2iedn',
2080
+ 'x2iezn',
2081
+ 'x4',
2082
+ 'x8g',
2083
+ 'z1d',
2084
+ 'z3'
2085
+ ]
2086
+ },
2087
+ description: 'Allowed values for `cfke.io/instance-family`.',
2088
+ default: []
2089
+ },
2090
+ 'topology.kubernetes.io/region': {
2091
+ type: 'array',
2092
+ items: {
2093
+ type: 'string',
2094
+ enum: [
2095
+ 'africa-south1',
2096
+ 'ap-northeast-1',
2097
+ 'ap-northeast-2',
2098
+ 'ap-northeast-3',
2099
+ 'ap-south-1',
2100
+ 'ap-southeast-1',
2101
+ 'ap-southeast-2',
2102
+ 'ash',
2103
+ 'asia-east1',
2104
+ 'asia-east2',
2105
+ 'asia-northeast1',
2106
+ 'asia-northeast2',
2107
+ 'asia-northeast3',
2108
+ 'asia-south1',
2109
+ 'asia-south2',
2110
+ 'asia-southeast1',
2111
+ 'asia-southeast2',
2112
+ 'australia-southeast1',
2113
+ 'australia-southeast2',
2114
+ 'ca-central-1',
2115
+ 'eu-central-1',
2116
+ 'eu-central-2',
2117
+ 'eu-north-1',
2118
+ 'eu-west-1',
2119
+ 'eu-west-2',
2120
+ 'eu-west-3',
2121
+ 'europe-central2',
2122
+ 'europe-north1',
2123
+ 'europe-southwest1',
2124
+ 'europe-west1',
2125
+ 'europe-west10',
2126
+ 'europe-west12',
2127
+ 'europe-west2',
2128
+ 'europe-west3',
2129
+ 'europe-west4',
2130
+ 'europe-west6',
2131
+ 'europe-west8',
2132
+ 'europe-west9',
2133
+ 'fsn1',
2134
+ 'hel1',
2135
+ 'hil',
2136
+ 'me-central1',
2137
+ 'me-central2',
2138
+ 'me-west1',
2139
+ 'nbg1',
2140
+ 'northamerica-northeast1',
2141
+ 'northamerica-northeast2',
2142
+ 'sa-east-1',
2143
+ 'sin',
2144
+ 'southamerica-east1',
2145
+ 'southamerica-west1',
2146
+ 'us-central1',
2147
+ 'us-east-1',
2148
+ 'us-east-2',
2149
+ 'us-east1',
2150
+ 'us-east4',
2151
+ 'us-east5',
2152
+ 'us-south1',
2153
+ 'us-west-1',
2154
+ 'us-west-2',
2155
+ 'us-west1',
2156
+ 'us-west2',
2157
+ 'us-west3',
2158
+ 'us-west4'
2159
+ ]
2160
+ },
2161
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
2162
+ default: []
2163
+ }
2164
+ },
2165
+ additionalProperties: false,
2166
+ description: 'Constraints define scheduling and provisioning requirements for the fleet. Each field restricts the values allowed for a given Kubernetes label key. Multiple constraints are ANDed together.',
2167
+ default: {
2168
+ 'karpenter.sh/capacity-type': [
2169
+ 'on-demand',
2170
+ 'spot'
2171
+ ],
2172
+ 'kubernetes.io/arch': [
2173
+ 'amd64'
2174
+ ],
2175
+ 'cfke.io/instance-family': [],
2176
+ 'topology.kubernetes.io/region': []
2177
+ }
2178
+ },
2179
+ scalingProfile: {
2180
+ type: 'string',
2181
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet. Full-overwrite: omit to reset to the default (`conservative`).',
2182
+ default: 'conservative',
2183
+ example: 'conservative',
2184
+ enum: [
2185
+ 'aggressive',
2186
+ 'conservative'
2187
+ ]
2188
+ }
2189
+ },
2190
+ additionalProperties: false,
2191
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
2192
+ };
2193
+ export const InviteCreateInputSchema = {
2194
+ type: 'object',
2195
+ properties: {
2196
+ email: {
2197
+ type: 'string',
2198
+ format: 'email',
2199
+ description: 'Email address of the user to invite.',
2200
+ example: 'email@example.com'
2201
+ },
2202
+ role: {
2203
+ type: 'string',
2204
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2205
+ default: 'User',
2206
+ example: 'User',
2207
+ enum: [
2208
+ 'Administrator',
2209
+ 'User'
2210
+ ]
2211
+ }
2212
+ },
2213
+ required: [
2214
+ 'email'
2215
+ ],
2216
+ additionalProperties: false
2217
+ };
2218
+ export const InviteSchema = {
2219
+ type: 'object',
2220
+ properties: {
2221
+ id: {
2222
+ type: 'string',
2223
+ description: 'Unique identifier of the invitation.',
2224
+ example: '65831dd20d20165489cbb868'
2225
+ },
2226
+ organization_id: {
2227
+ type: 'string',
2228
+ format: 'uuid',
2229
+ description: 'Unique identifier of the organization the project belongs to. UUID v4 string in canonical form',
2230
+ example: 'e94d30ec-a2dd-4dcb-832c-ac2be144ba91'
2231
+ },
2232
+ date_created: {
2233
+ type: 'string',
718
2234
  format: 'date-time',
719
2235
  description: 'Creation date of the project. ISO 8601 date string in UTC timezone',
720
2236
  example: '2023-11-02T16:08:14.338Z'
@@ -729,9 +2245,21 @@ export const InviteSchema = {
729
2245
  type: 'string',
730
2246
  description: 'Generated unique invite code.',
731
2247
  example: '7kUZnH7nnKUFfvc4NK2KQF'
2248
+ },
2249
+ role: {
2250
+ type: 'string',
2251
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2252
+ default: 'User',
2253
+ example: 'User',
2254
+ enum: [
2255
+ 'Administrator',
2256
+ 'User'
2257
+ ]
732
2258
  }
733
2259
  },
734
- required: ['date_created'],
2260
+ required: [
2261
+ 'date_created'
2262
+ ],
735
2263
  additionalProperties: false
736
2264
  };
737
2265
  export const InvoiceSchema = {
@@ -739,9 +2267,8 @@ export const InvoiceSchema = {
739
2267
  properties: {
740
2268
  id: {
741
2269
  type: 'string',
742
- format: 'uuid',
743
- description: 'Unique identifier of the invoice. UUID v4 string in canonical form',
744
- example: '415026b6-f00f-44f8-968d-fc6ef4d0fc6d'
2270
+ description: 'Unique identifier of the invoice.',
2271
+ example: 'in_1234567890xCrwxghOTj1234'
745
2272
  },
746
2273
  number: {
747
2274
  type: 'string'
@@ -784,95 +2311,179 @@ export const InvoiceSchema = {
784
2311
  type: 'string'
785
2312
  }
786
2313
  },
787
- required: ['created', 'period_start', 'period_end'],
2314
+ required: [
2315
+ 'created',
2316
+ 'period_start',
2317
+ 'period_end'
2318
+ ],
788
2319
  additionalProperties: false
789
2320
  };
790
- export const MarketplaceListingSchema = {
2321
+ export const MarketplaceListingFilesSchema = {
791
2322
  type: 'object',
792
2323
  properties: {
793
- id: {
794
- type: 'string',
795
- maxLength: 63,
796
- minLength: 1,
797
- pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
798
- description: 'Id of the chart listing',
799
- example: 'portworx-enterprise-disaster-recovery-baremetal'
800
- },
801
- name: {
802
- type: 'string',
803
- description: 'Name of the chart listing',
804
- example: 'Portworx Enterprise + Disaster Recovery - Baremetal'
805
- },
806
- developer: {
2324
+ chartYaml: {
807
2325
  type: 'string',
808
- description: 'Author of the chart listing',
809
- example: 'Portworx'
2326
+ description: 'Raw Chart.yaml content from the Helm chart',
2327
+ example: 'apiVersion: v2\nname: nginx-ingress\nversion: 1.18.2-cfke.45\nappVersion: 1.9.4'
810
2328
  },
811
- description: {
2329
+ valuesYaml: {
812
2330
  type: 'string',
813
- description: 'Short description of the chart listing',
814
- example: 'Run Kubernetes with unmatched scalability, availability, and self-service access to any storage'
2331
+ description: 'Raw values.yaml content from the Helm chart',
2332
+ example: 'replicaCount: 1\nimage:\n repository: nginx\n tag: latest'
815
2333
  },
816
- logoUrl: {
2334
+ valuesSchemaJson: {
817
2335
  type: 'string',
818
- description: 'Logo of the chart listing',
819
- example: 'https://portworx.com/wp-content/themes/portworx/assets/images/header/portworx-logo.png'
820
- },
821
- longDescription: {
2336
+ description: 'JSON schema for values.yaml as a string',
2337
+ example: '{"type":"object","properties":{"replicaCount":{"type":"number"}}}'
2338
+ }
2339
+ },
2340
+ additionalProperties: false
2341
+ };
2342
+ export const MarketplaceListingSchema = {
2343
+ type: 'object',
2344
+ properties: {
2345
+ name: {
822
2346
  type: 'string',
823
- description: 'Long description of the chart listing',
824
- example: 'Portworx-Enterprise is the complete multi-cloud ready Kubernetes storage platform for running mission-critical apps in production....'
2347
+ description: 'Name of the chart',
2348
+ example: 'nginx-ingress'
825
2349
  },
826
- categories: {
2350
+ versions: {
827
2351
  type: 'array',
828
2352
  items: {
829
2353
  type: 'string',
830
- example: 'AI & Machine Learning'
2354
+ pattern: '^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
2355
+ description: 'Specific version of the chart',
2356
+ example: '1.18.2-cfke.45'
831
2357
  },
832
- description: 'Tags of the chart'
2358
+ description: 'Available versions of the chart'
833
2359
  },
834
2360
  version_channels: {
835
2361
  type: 'array',
836
2362
  items: {
837
2363
  type: 'string',
838
2364
  pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
839
- description: 'Version of the chart.',
840
- example: '2.x.x-cfke.x'
841
- }
2365
+ description: 'Version channel pattern',
2366
+ example: '1.18.x-cfke.x'
2367
+ },
2368
+ description: 'Version channels for the chart'
842
2369
  },
843
- value_schemas: {
844
- type: 'array',
845
- items: {
846
- type: 'object',
847
- properties: {
848
- version: {
849
- type: 'string',
850
- pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
851
- description: 'Version of the chart.',
852
- example: '2.1.1-cfke.123'
2370
+ latestVersion: {
2371
+ type: 'string',
2372
+ description: 'Latest version of the chart',
2373
+ example: '1.18.2-cfke.45'
2374
+ },
2375
+ metadata: {
2376
+ type: 'object',
2377
+ properties: {
2378
+ name: {
2379
+ type: 'string',
2380
+ description: 'Chart name from metadata',
2381
+ example: 'nginx-ingress'
2382
+ },
2383
+ version: {
2384
+ type: 'string',
2385
+ description: 'Chart version from metadata',
2386
+ example: '1.18.2-cfke.45'
2387
+ },
2388
+ description: {
2389
+ type: 'string',
2390
+ description: 'Chart description',
2391
+ example: 'NGINX Ingress Controller for Kubernetes'
2392
+ },
2393
+ appVersion: {
2394
+ type: 'string',
2395
+ description: 'Application version',
2396
+ example: '1.9.4'
2397
+ },
2398
+ apiVersion: {
2399
+ type: 'string',
2400
+ description: 'Helm API version',
2401
+ example: 'v2'
2402
+ },
2403
+ keywords: {
2404
+ type: 'array',
2405
+ items: {
2406
+ type: 'string'
853
2407
  },
854
- schema: {
855
- type: 'string',
856
- description: 'Schema of the chart values. JSON Schema as string'
2408
+ description: 'Chart keywords',
2409
+ example: [
2410
+ 'ingress',
2411
+ 'nginx',
2412
+ 'load-balancer'
2413
+ ]
2414
+ },
2415
+ home: {
2416
+ type: 'string',
2417
+ description: 'Chart home URL',
2418
+ example: 'https://kubernetes.github.io/ingress-nginx/'
2419
+ },
2420
+ icon: {
2421
+ type: 'string',
2422
+ description: 'A URL to an SVG or PNG image to be used as an icon',
2423
+ example: 'https://cloudfleet.ai/images/marketplace/icons/ingress-nginx.png'
2424
+ },
2425
+ sources: {
2426
+ type: 'array',
2427
+ items: {
2428
+ type: 'string'
857
2429
  },
858
- placeholder: {
859
- type: 'string',
860
- description: 'Schema of the chart values',
861
- example: `foo: 1
862
- bar: example`
863
- }
2430
+ description: 'Chart source URLs',
2431
+ example: [
2432
+ 'https://github.com/kubernetes/ingress-nginx'
2433
+ ]
864
2434
  },
865
- required: ['version', 'schema', 'placeholder'],
866
- additionalProperties: false
867
- }
2435
+ maintainers: {
2436
+ type: 'array',
2437
+ items: {
2438
+ type: 'object',
2439
+ properties: {
2440
+ name: {
2441
+ type: 'string',
2442
+ description: 'Maintainer name',
2443
+ example: 'NGINX Team'
2444
+ },
2445
+ email: {
2446
+ type: 'string',
2447
+ description: 'Maintainer email',
2448
+ example: 'support@nginx.org'
2449
+ }
2450
+ },
2451
+ required: [
2452
+ 'name'
2453
+ ],
2454
+ additionalProperties: false
2455
+ },
2456
+ description: 'Chart maintainers'
2457
+ }
2458
+ },
2459
+ required: [
2460
+ 'name',
2461
+ 'version'
2462
+ ],
2463
+ additionalProperties: false,
2464
+ description: 'Chart metadata'
868
2465
  }
869
2466
  },
870
- required: ['id', 'name', 'developer', 'description', 'logoUrl', 'longDescription', 'categories', 'version_channels', 'value_schemas'],
2467
+ required: [
2468
+ 'name',
2469
+ 'versions',
2470
+ 'version_channels',
2471
+ 'latestVersion'
2472
+ ],
871
2473
  additionalProperties: false
872
2474
  };
873
2475
  export const OrganizationCreateInputSchema = {
874
2476
  type: 'object',
875
2477
  properties: {
2478
+ type: {
2479
+ type: 'string',
2480
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2481
+ example: 'business',
2482
+ enum: [
2483
+ 'business',
2484
+ 'personal'
2485
+ ]
2486
+ },
876
2487
  email: {
877
2488
  type: 'string',
878
2489
  format: 'email',
@@ -881,11 +2492,13 @@ export const OrganizationCreateInputSchema = {
881
2492
  },
882
2493
  first_name: {
883
2494
  type: 'string',
2495
+ minLength: 1,
884
2496
  description: 'First name of the billing contact person.',
885
2497
  example: 'John'
886
2498
  },
887
2499
  last_name: {
888
2500
  type: 'string',
2501
+ minLength: 1,
889
2502
  description: 'Last name of the billing contact person.',
890
2503
  example: 'Doe'
891
2504
  },
@@ -903,7 +2516,28 @@ export const OrganizationCreateInputSchema = {
903
2516
  description: 'Password for the root account. Must be at least 8 characters long and contain at least one uppercase letter, one lowercase letter, one number and one special character.'
904
2517
  }
905
2518
  },
906
- required: ['email', 'first_name', 'last_name', 'company_name', 'password'],
2519
+ required: [
2520
+ 'type',
2521
+ 'email',
2522
+ 'first_name',
2523
+ 'last_name',
2524
+ 'company_name',
2525
+ 'password'
2526
+ ],
2527
+ additionalProperties: false
2528
+ };
2529
+ export const OrganizationCreateOutputSchema = {
2530
+ type: 'object',
2531
+ properties: {
2532
+ id: {
2533
+ type: 'string',
2534
+ description: 'Unique identifier of the newly created organization. Generated by the API and safe to use for client-side tracking immediately.',
2535
+ example: 'organization-id'
2536
+ }
2537
+ },
2538
+ required: [
2539
+ 'id'
2540
+ ],
907
2541
  additionalProperties: false
908
2542
  };
909
2543
  export const OrganizationSchema = {
@@ -922,6 +2556,15 @@ export const OrganizationSchema = {
922
2556
  description: 'Name of the legal entity. This name will be used in invoices. Use your first and last name for individual accounts.',
923
2557
  example: 'ACME Corp.'
924
2558
  },
2559
+ type: {
2560
+ type: 'string',
2561
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2562
+ example: 'business',
2563
+ enum: [
2564
+ 'business',
2565
+ 'personal'
2566
+ ]
2567
+ },
925
2568
  date_created: {
926
2569
  type: 'string',
927
2570
  format: 'date-time',
@@ -953,6 +2596,17 @@ export const OrganizationSchema = {
953
2596
  description: 'Available number of Pro clusters that can be created.',
954
2597
  example: 999
955
2598
  },
2599
+ enterprise_clusters_max: {
2600
+ type: 'integer',
2601
+ minimum: 0,
2602
+ description: 'Maximum number of Enterprise clusters that can be created.',
2603
+ example: 999
2604
+ },
2605
+ enterprise_clusters_available: {
2606
+ type: 'integer',
2607
+ description: 'Available number of Enterprise clusters that can be created.',
2608
+ example: 999
2609
+ },
956
2610
  fleets_max: {
957
2611
  type: 'integer',
958
2612
  minimum: 0,
@@ -972,7 +2626,7 @@ export const OrganizationSchema = {
972
2626
  type: 'array',
973
2627
  items: {
974
2628
  type: 'string',
975
- example: 'northamerica-central-1'
2629
+ example: 'northamerica-central-1a'
976
2630
  },
977
2631
  minItems: 1,
978
2632
  description: 'List of Cloudfleet control plane regions available for the organization.'
@@ -985,32 +2639,74 @@ export const OrganizationSchema = {
985
2639
  id: {
986
2640
  type: 'string',
987
2641
  description: 'Id of the control plane version. Used in API calls.',
988
- example: '1.29.x-cfke.x'
2642
+ example: '1.33.x-cfke.x'
989
2643
  },
990
2644
  label: {
991
2645
  type: 'string',
992
2646
  description: 'Label of the control plane version. Used in frontent UI.',
993
- example: '1.29.x (Always latest 1.29 patch version)'
2647
+ example: '1.33.x (Always latest 1.33 patch version)'
994
2648
  }
995
2649
  },
996
- required: ['id', 'label'],
2650
+ required: [
2651
+ 'id',
2652
+ 'label'
2653
+ ],
997
2654
  additionalProperties: false
998
2655
  },
999
2656
  minItems: 1,
1000
2657
  description: 'List of CFKE control plane versions available for the organization.'
2658
+ },
2659
+ cfcr_storage_gb: {
2660
+ type: 'integer',
2661
+ minimum: -1,
2662
+ description: 'Organization-level maximum CFCR storage volume in GB. -1 means no limit.',
2663
+ example: 500
1001
2664
  }
1002
2665
  },
1003
- required: ['basic_clusters_max', 'basic_clusters_available', 'pro_clusters_max', 'pro_clusters_available', 'fleets_max', 'cluster_tiers', 'regions', 'versions'],
2666
+ required: [
2667
+ 'basic_clusters_max',
2668
+ 'basic_clusters_available',
2669
+ 'pro_clusters_max',
2670
+ 'pro_clusters_available',
2671
+ 'enterprise_clusters_max',
2672
+ 'enterprise_clusters_available',
2673
+ 'fleets_max',
2674
+ 'cluster_tiers',
2675
+ 'regions',
2676
+ 'versions',
2677
+ 'cfcr_storage_gb'
2678
+ ],
1004
2679
  additionalProperties: false,
1005
2680
  description: 'For security reasons, platform quota is controlled by Cloudfleet and can be updated only by Cloudfleet administrators. Please open a support ticket if you need to change the platform quota.'
1006
2681
  },
1007
2682
  status: {
1008
2683
  type: 'string',
1009
2684
  description: 'Status of the organization. Can be `active` or `closed`, or `suspended`.',
1010
- enum: ['active', 'closed', 'suspended']
2685
+ enum: [
2686
+ 'active',
2687
+ 'closed',
2688
+ 'suspended'
2689
+ ]
2690
+ },
2691
+ verification: {
2692
+ type: 'string',
2693
+ description: 'Verification status of the organization, which determines the assigned quota. `none` when billing information is incomplete, `submitted` when billing information is complete but the organization is not yet verified, `verified` when the organization is verified.',
2694
+ example: 'verified',
2695
+ enum: [
2696
+ 'none',
2697
+ 'submitted',
2698
+ 'verified'
2699
+ ]
1011
2700
  }
1012
2701
  },
1013
- required: ['id', 'date_created', 'quota', 'status'],
2702
+ required: [
2703
+ 'id',
2704
+ 'type',
2705
+ 'date_created',
2706
+ 'quota',
2707
+ 'status',
2708
+ 'verification'
2709
+ ],
1014
2710
  additionalProperties: false
1015
2711
  };
1016
2712
  export const PaymentMethodSchema = {
@@ -1018,26 +2714,23 @@ export const PaymentMethodSchema = {
1018
2714
  properties: {
1019
2715
  id: {
1020
2716
  type: 'string',
1021
- format: 'uuid',
1022
- description: 'Unique identifier of the organization. UUID v4 string in canonical form.',
1023
- example: 'e94d30ec-a2dd-4dcb-832c-ac2be144ba91'
1024
- },
1025
- setup: {
1026
- type: 'boolean',
1027
- description: 'Whether organization payment method was set up and ready to use for payments.',
1028
- example: true
2717
+ description: 'Payment method identifier. Stripe payment method id for cards/SEPA; the constant `bank_transfer` for the invoice/bank-transfer method. Used to set as default or delete the payment method.',
2718
+ example: 'pm_1MtwBwLkdIwHu7ix28a3tqPa'
1029
2719
  },
1030
2720
  type: {
1031
2721
  type: 'string',
1032
- nullable: true,
1033
- description: 'Payment method type type. Only `card` payments supported at the moment.',
2722
+ description: 'Payment method type. `card`, `sepa_debit` for SEPA Direct Debit (business accounts only), or `bank_transfer` for paying invoices by bank transfer.',
1034
2723
  example: 'card',
1035
- enum: ['card']
2724
+ enum: [
2725
+ 'card',
2726
+ 'sepa_debit',
2727
+ 'bank_transfer'
2728
+ ]
1036
2729
  },
1037
2730
  last4: {
1038
2731
  type: 'string',
1039
2732
  nullable: true,
1040
- description: 'Last 4 digits of the payment card number.',
2733
+ description: 'Last 4 digits of the payment card number, of the bank account (IBAN) for SEPA Direct Debit, or of the destination IBAN for bank transfer.',
1041
2734
  example: '4242'
1042
2735
  },
1043
2736
  exp_month: {
@@ -1045,64 +2738,800 @@ export const PaymentMethodSchema = {
1045
2738
  minimum: 1,
1046
2739
  maximum: 12,
1047
2740
  nullable: true,
1048
- description: "Two-digit number representing the card's expiration month.",
1049
- example: '12'
2741
+ description: 'Two-digit number representing the card\'s expiration month. Null for SEPA Direct Debit and bank transfer.',
2742
+ example: 12
1050
2743
  },
1051
2744
  exp_year: {
1052
2745
  type: 'integer',
1053
- minimum: 2024,
1054
2746
  nullable: true,
1055
- description: "Four-digit number representing the card's expiration year.",
1056
- example: '2028'
2747
+ description: 'Four-digit number representing the card\'s expiration year. May be in the past for an expired card still on file. Null for SEPA Direct Debit and bank transfer.',
2748
+ example: 2028
1057
2749
  },
1058
2750
  brand: {
1059
2751
  type: 'string',
1060
2752
  nullable: true,
1061
- description: 'Payment card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.',
1062
- example: 'visa',
1063
- enum: ['amex', 'diners', 'discover', 'eftpos_au', 'jcb', 'mastercard', 'unionpay', 'visa', 'unknown']
2753
+ description: 'Payment card brand as reported by Stripe, e.g. `visa`, `mastercard`, `amex`, `cartes_bancaires`, or `unknown`. Null for SEPA Direct Debit and bank transfer.',
2754
+ example: 'visa'
2755
+ },
2756
+ iban: {
2757
+ type: 'string',
2758
+ nullable: true,
2759
+ description: 'Full destination IBAN to send bank transfers to. Set only for `bank_transfer`; null otherwise. This is Cloudfleet\'s virtual receiving account, shown in full so the customer can pay into it.',
2760
+ example: 'DE11243015658023127510'
2761
+ },
2762
+ bic: {
2763
+ type: 'string',
2764
+ nullable: true,
2765
+ description: 'BIC/SWIFT of the destination bank for bank transfers. Set only for `bank_transfer`; null otherwise.',
2766
+ example: 'SOGEDEFFXXX'
2767
+ },
2768
+ account_holder_name: {
2769
+ type: 'string',
2770
+ nullable: true,
2771
+ description: 'Account holder name of the destination bank account for bank transfers. Set only for `bank_transfer`; null otherwise.',
2772
+ example: 'Cloudfleet GmbH'
2773
+ },
2774
+ is_default: {
2775
+ type: 'boolean',
2776
+ description: 'Whether this payment method is the default used for invoices and active subscriptions. Always false for `bank_transfer` (it cannot be a Stripe default payment method).',
2777
+ example: true
1064
2778
  }
1065
2779
  },
1066
- required: ['id', 'setup', 'type', 'last4', 'exp_month', 'exp_year', 'brand'],
2780
+ required: [
2781
+ 'id',
2782
+ 'type',
2783
+ 'last4',
2784
+ 'exp_month',
2785
+ 'exp_year',
2786
+ 'brand',
2787
+ 'iban',
2788
+ 'bic',
2789
+ 'account_holder_name',
2790
+ 'is_default'
2791
+ ],
1067
2792
  additionalProperties: false
1068
2793
  };
1069
- export const TokenCreateInputSchema = {
2794
+ export const PlatformQuotaSchema = {
2795
+ type: 'object',
2796
+ properties: {
2797
+ basic_clusters_max: {
2798
+ type: 'integer',
2799
+ minimum: 0,
2800
+ description: 'Maximum number of Basic clusters that can be created.',
2801
+ example: 999
2802
+ },
2803
+ basic_clusters_available: {
2804
+ type: 'integer',
2805
+ description: 'Available number of Basic clusters that can be created.',
2806
+ example: 999
2807
+ },
2808
+ pro_clusters_max: {
2809
+ type: 'integer',
2810
+ minimum: 0,
2811
+ description: 'Maximum number of Pro clusters that can be created.',
2812
+ example: 999
2813
+ },
2814
+ pro_clusters_available: {
2815
+ type: 'integer',
2816
+ description: 'Available number of Pro clusters that can be created.',
2817
+ example: 999
2818
+ },
2819
+ enterprise_clusters_max: {
2820
+ type: 'integer',
2821
+ minimum: 0,
2822
+ description: 'Maximum number of Enterprise clusters that can be created.',
2823
+ example: 999
2824
+ },
2825
+ enterprise_clusters_available: {
2826
+ type: 'integer',
2827
+ description: 'Available number of Enterprise clusters that can be created.',
2828
+ example: 999
2829
+ },
2830
+ fleets_max: {
2831
+ type: 'integer',
2832
+ minimum: 0,
2833
+ description: 'Maximum number of fleets that can be created per cluster.',
2834
+ example: 999
2835
+ },
2836
+ cluster_tiers: {
2837
+ type: 'array',
2838
+ items: {
2839
+ type: 'string',
2840
+ example: 'basic'
2841
+ },
2842
+ minItems: 0,
2843
+ description: 'List of Cloudfleet cluster tiers available for the organization.'
2844
+ },
2845
+ regions: {
2846
+ type: 'array',
2847
+ items: {
2848
+ type: 'string',
2849
+ example: 'northamerica-central-1a'
2850
+ },
2851
+ minItems: 1,
2852
+ description: 'List of Cloudfleet control plane regions available for the organization.'
2853
+ },
2854
+ versions: {
2855
+ type: 'array',
2856
+ items: {
2857
+ type: 'object',
2858
+ properties: {
2859
+ id: {
2860
+ type: 'string',
2861
+ description: 'Id of the control plane version. Used in API calls.',
2862
+ example: '1.33.x-cfke.x'
2863
+ },
2864
+ label: {
2865
+ type: 'string',
2866
+ description: 'Label of the control plane version. Used in frontent UI.',
2867
+ example: '1.33.x (Always latest 1.33 patch version)'
2868
+ }
2869
+ },
2870
+ required: [
2871
+ 'id',
2872
+ 'label'
2873
+ ],
2874
+ additionalProperties: false
2875
+ },
2876
+ minItems: 1,
2877
+ description: 'List of CFKE control plane versions available for the organization.'
2878
+ },
2879
+ cfcr_storage_gb: {
2880
+ type: 'integer',
2881
+ minimum: -1,
2882
+ description: 'Organization-level maximum CFCR storage volume in GB. -1 means no limit.',
2883
+ example: 500
2884
+ }
2885
+ },
2886
+ required: [
2887
+ 'basic_clusters_max',
2888
+ 'basic_clusters_available',
2889
+ 'pro_clusters_max',
2890
+ 'pro_clusters_available',
2891
+ 'enterprise_clusters_max',
2892
+ 'enterprise_clusters_available',
2893
+ 'fleets_max',
2894
+ 'cluster_tiers',
2895
+ 'regions',
2896
+ 'versions',
2897
+ 'cfcr_storage_gb'
2898
+ ],
2899
+ additionalProperties: false
2900
+ };
2901
+ export const RegistryRepositorySchema = {
1070
2902
  type: 'object',
1071
2903
  properties: {
1072
2904
  name: {
1073
2905
  type: 'string',
1074
- maxLength: 63,
1075
- minLength: 1,
1076
- pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
1077
- description: 'Human readable access token name.',
1078
- example: 'deployment-token'
2906
+ description: 'Repository name.',
2907
+ example: 'my-app'
1079
2908
  },
1080
- role: {
2909
+ region: {
1081
2910
  type: 'string',
1082
- description: 'Role assumed by the token.',
1083
- example: 'User',
1084
- enum: ['Administrator', 'User']
2911
+ description: 'Registry region.',
2912
+ example: 'northamerica'
2913
+ },
2914
+ uri: {
2915
+ type: 'string',
2916
+ description: 'Full URI of the repository.',
2917
+ example: 'ssds123e-6651-4e5d-9c04-079f6532989b.northamerica.registry.cloudfleet.dev/my-app'
1085
2918
  }
1086
2919
  },
1087
- required: ['name', 'role'],
2920
+ required: [
2921
+ 'name',
2922
+ 'region',
2923
+ 'uri'
2924
+ ],
1088
2925
  additionalProperties: false
1089
2926
  };
1090
- export const TokenSchema = {
2927
+ export const RegistryRepositoryWithTagsSchema = {
1091
2928
  type: 'object',
1092
2929
  properties: {
1093
2930
  name: {
1094
2931
  type: 'string',
1095
- maxLength: 63,
1096
- minLength: 1,
1097
- pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
1098
- description: 'Human readable access token name.',
1099
- example: 'deployment-token'
2932
+ description: 'Repository name.',
2933
+ example: 'my-app'
1100
2934
  },
1101
- role: {
2935
+ region: {
1102
2936
  type: 'string',
1103
- description: 'Role assumed by the token.',
2937
+ description: 'Registry region.',
2938
+ example: 'northamerica'
2939
+ },
2940
+ uri: {
2941
+ type: 'string',
2942
+ description: 'Full URI of the repository.',
2943
+ example: 'ssds123e-6651-4e5d-9c04-079f6532989b.northamerica.registry.cloudfleet.dev/my-app'
2944
+ },
2945
+ tags: {
2946
+ type: 'array',
2947
+ items: {
2948
+ type: 'object',
2949
+ properties: {
2950
+ name: {
2951
+ type: 'string',
2952
+ description: 'Tag name.',
2953
+ example: 'latest'
2954
+ },
2955
+ size: {
2956
+ type: 'number',
2957
+ format: 'float',
2958
+ description: 'Size of the tag in bytes.',
2959
+ example: 123456789
2960
+ },
2961
+ mediaType: {
2962
+ type: 'string',
2963
+ description: 'Media type of the manifest.',
2964
+ example: 'application/vnd.docker.distribution.manifest.v2+json'
2965
+ },
2966
+ platforms: {
2967
+ type: 'array',
2968
+ items: {
2969
+ type: 'string'
2970
+ },
2971
+ description: 'Array of platform strings for multi-arch images (e.g., linux/amd64, linux/arm64).',
2972
+ example: [
2973
+ 'linux/amd64',
2974
+ 'linux/arm64'
2975
+ ]
2976
+ }
2977
+ },
2978
+ required: [
2979
+ 'name',
2980
+ 'size'
2981
+ ],
2982
+ additionalProperties: false
2983
+ },
2984
+ description: 'Array of tags in the repository.'
2985
+ },
2986
+ totalSize: {
2987
+ type: 'number',
2988
+ format: 'float',
2989
+ description: 'Total size of all tags in the repository in bytes.',
2990
+ example: 987654321
2991
+ }
2992
+ },
2993
+ required: [
2994
+ 'name',
2995
+ 'region',
2996
+ 'uri',
2997
+ 'tags',
2998
+ 'totalSize'
2999
+ ],
3000
+ additionalProperties: false
3001
+ };
3002
+ export const RegistryTagSchema = {
3003
+ type: 'object',
3004
+ properties: {
3005
+ name: {
3006
+ type: 'string',
3007
+ description: 'Tag name.',
3008
+ example: 'latest'
3009
+ },
3010
+ digest: {
3011
+ type: 'string',
3012
+ description: 'Manifest digest for pulling by digest.',
3013
+ example: 'sha256:abcd1234ef567890abcd1234ef567890abcd1234ef567890abcd1234ef567890'
3014
+ },
3015
+ mediaType: {
3016
+ type: 'string',
3017
+ description: 'Media type of the manifest.',
3018
+ example: 'application/vnd.docker.distribution.manifest.v2+json'
3019
+ },
3020
+ config: {
3021
+ type: 'object',
3022
+ properties: {
3023
+ size: {
3024
+ type: 'number',
3025
+ format: 'float',
3026
+ description: 'Size of the config in bytes.',
3027
+ example: 1234
3028
+ }
3029
+ },
3030
+ required: [
3031
+ 'size'
3032
+ ],
3033
+ additionalProperties: false,
3034
+ description: 'Manifest config metadata.'
3035
+ },
3036
+ layers: {
3037
+ type: 'array',
3038
+ items: {
3039
+ type: 'object',
3040
+ properties: {
3041
+ digest: {
3042
+ type: 'string',
3043
+ description: 'Digest of the layer.',
3044
+ example: 'sha256:abcd1234ef567890abcd1234ef567890abcd1234ef567890abcd1234ef567890'
3045
+ },
3046
+ size: {
3047
+ type: 'number',
3048
+ format: 'float',
3049
+ description: 'Size of the layer in bytes.',
3050
+ example: 5678
3051
+ }
3052
+ },
3053
+ required: [
3054
+ 'size'
3055
+ ],
3056
+ additionalProperties: false
3057
+ },
3058
+ description: 'Array of layer metadata.'
3059
+ },
3060
+ manifests: {
3061
+ type: 'array',
3062
+ items: {
3063
+ type: 'object',
3064
+ properties: {
3065
+ digest: {
3066
+ type: 'string',
3067
+ description: 'Digest of the manifest.',
3068
+ example: 'sha256:abcd1234ef567890abcd1234ef567890abcd1234ef567890abcd1234ef567890'
3069
+ },
3070
+ platform: {
3071
+ type: 'object',
3072
+ properties: {
3073
+ architecture: {
3074
+ type: 'string',
3075
+ description: 'Architecture of the platform.',
3076
+ example: 'amd64'
3077
+ },
3078
+ os: {
3079
+ type: 'string',
3080
+ description: 'Operating system of the platform.',
3081
+ example: 'linux'
3082
+ },
3083
+ variant: {
3084
+ type: 'string',
3085
+ description: 'Variant of the platform (e.g., v7, v8 for ARM).',
3086
+ example: 'v8'
3087
+ }
3088
+ },
3089
+ required: [
3090
+ 'architecture',
3091
+ 'os'
3092
+ ],
3093
+ additionalProperties: false,
3094
+ description: 'Platform information for the manifest.'
3095
+ },
3096
+ layers: {
3097
+ type: 'array',
3098
+ items: {
3099
+ type: 'object',
3100
+ properties: {
3101
+ digest: {
3102
+ type: 'string',
3103
+ description: 'Digest of the layer.',
3104
+ example: 'sha256:abcd1234ef567890abcd1234ef567890abcd1234ef567890abcd1234ef567890'
3105
+ },
3106
+ size: {
3107
+ type: 'number',
3108
+ format: 'float',
3109
+ description: 'Size of the layer in bytes.',
3110
+ example: 5678
3111
+ }
3112
+ },
3113
+ required: [
3114
+ 'size'
3115
+ ],
3116
+ additionalProperties: false
3117
+ },
3118
+ description: 'Layers for this platform.'
3119
+ },
3120
+ size: {
3121
+ type: 'number',
3122
+ format: 'float',
3123
+ description: 'Total size of this platform manifest in bytes.',
3124
+ example: 12345678
3125
+ }
3126
+ },
3127
+ required: [
3128
+ 'digest'
3129
+ ],
3130
+ additionalProperties: false
3131
+ },
3132
+ description: 'Array of manifests for multi-arch images.'
3133
+ },
3134
+ size: {
3135
+ type: 'number',
3136
+ format: 'float',
3137
+ description: 'Total size of the tag in bytes.',
3138
+ example: 123456789
3139
+ },
3140
+ region: {
3141
+ type: 'string',
3142
+ description: 'Registry region.',
3143
+ example: 'northamerica'
3144
+ },
3145
+ repository: {
3146
+ type: 'string',
3147
+ description: 'Repository name.',
3148
+ example: 'my-app'
3149
+ },
3150
+ uri: {
3151
+ type: 'string',
3152
+ description: 'Full URI of the tag.',
3153
+ example: 'ssds123e-6651-4e5d-9c04-079f6532989b.northamerica.registry.cloudfleet.dev/my-app:latest'
3154
+ }
3155
+ },
3156
+ required: [
3157
+ 'name',
3158
+ 'digest',
3159
+ 'size',
3160
+ 'region',
3161
+ 'repository',
3162
+ 'uri'
3163
+ ],
3164
+ additionalProperties: false
3165
+ };
3166
+ export const TicketAttachmentSchema = {
3167
+ type: 'object',
3168
+ properties: {
3169
+ id: {
3170
+ type: 'string',
3171
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3172
+ example: '60c72b2f9f1b2c001f8e4d3c'
3173
+ },
3174
+ filename: {
3175
+ type: 'string',
3176
+ description: 'Original filename as uploaded.',
3177
+ example: 'debug.log'
3178
+ },
3179
+ content_type: {
3180
+ type: 'string',
3181
+ description: 'MIME content type of the attachment.',
3182
+ example: 'text/plain'
3183
+ },
3184
+ size: {
3185
+ type: 'integer',
3186
+ description: 'Size of the attachment in bytes.',
3187
+ example: 12345
3188
+ }
3189
+ },
3190
+ required: [
3191
+ 'id',
3192
+ 'filename',
3193
+ 'content_type',
3194
+ 'size'
3195
+ ],
3196
+ additionalProperties: false
3197
+ };
3198
+ export const TicketCreateInputSchema = {
3199
+ type: 'object',
3200
+ properties: {
3201
+ category: {
3202
+ type: 'string',
3203
+ description: 'Ticket category. Drives auto-assignment and may carry a subcategory in `properties`.',
3204
+ example: 'technical',
3205
+ enum: [
3206
+ 'billing',
3207
+ 'technical',
3208
+ 'general'
3209
+ ]
3210
+ },
3211
+ body: {
3212
+ type: 'string',
3213
+ maxLength: 50000,
3214
+ minLength: 1,
3215
+ pattern: '\\S',
3216
+ description: 'Initial message body in markdown. There is no separate subject — the first message body is the description.',
3217
+ example: 'My cluster cannot reach the registry. Logs attached.'
3218
+ },
3219
+ properties: {
3220
+ type: 'object',
3221
+ additionalProperties: true,
3222
+ description: 'Free-form key/value bag set by the UI (e.g. `subcategory`, `cluster_id`, `cluster_name`, `region`).',
3223
+ example: {
3224
+ subcategory: 'cluster-question',
3225
+ cluster_id: '60c72b2f9f1b2c001f8e4d3a'
3226
+ }
3227
+ }
3228
+ },
3229
+ required: [
3230
+ 'category',
3231
+ 'body'
3232
+ ],
3233
+ additionalProperties: false
3234
+ };
3235
+ export const TicketMessageInputSchema = {
3236
+ type: 'object',
3237
+ properties: {
3238
+ body: {
3239
+ type: 'string',
3240
+ maxLength: 50000,
3241
+ minLength: 1,
3242
+ pattern: '\\S',
3243
+ description: 'Reply body in markdown.',
3244
+ example: 'Thanks — that resolved it on my side.'
3245
+ }
3246
+ },
3247
+ required: [
3248
+ 'body'
3249
+ ],
3250
+ additionalProperties: false
3251
+ };
3252
+ export const TicketMessageSchema = {
3253
+ type: 'object',
3254
+ properties: {
3255
+ id: {
3256
+ type: 'string',
3257
+ description: 'Unique identifier of the message (Mongo ObjectId).',
3258
+ example: '60c72b2f9f1b2c001f8e4d3b'
3259
+ },
3260
+ type: {
3261
+ type: 'string',
3262
+ description: 'Message type. Internal notes are filtered out of customer-facing responses.',
3263
+ example: 'customer_reply',
3264
+ enum: [
3265
+ 'customer_reply',
3266
+ 'agent_reply'
3267
+ ]
3268
+ },
3269
+ body: {
3270
+ type: 'string',
3271
+ description: 'Message body in markdown.',
3272
+ example: 'Thanks — that resolved it on my side.'
3273
+ },
3274
+ author_first_name: {
3275
+ type: 'string',
3276
+ nullable: true,
3277
+ description: 'First name of the author. Null when not provided.',
3278
+ example: 'Jane'
3279
+ },
3280
+ author_last_name: {
3281
+ type: 'string',
3282
+ nullable: true,
3283
+ description: 'Last name of the author. Null when not provided.',
3284
+ example: 'Doe'
3285
+ },
3286
+ attachments: {
3287
+ type: 'array',
3288
+ items: {
3289
+ type: 'object',
3290
+ properties: {
3291
+ id: {
3292
+ type: 'string',
3293
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3294
+ example: '60c72b2f9f1b2c001f8e4d3c'
3295
+ },
3296
+ filename: {
3297
+ type: 'string',
3298
+ description: 'Original filename as uploaded.',
3299
+ example: 'debug.log'
3300
+ },
3301
+ content_type: {
3302
+ type: 'string',
3303
+ description: 'MIME content type of the attachment.',
3304
+ example: 'text/plain'
3305
+ },
3306
+ size: {
3307
+ type: 'integer',
3308
+ description: 'Size of the attachment in bytes.',
3309
+ example: 12345
3310
+ }
3311
+ },
3312
+ required: [
3313
+ 'id',
3314
+ 'filename',
3315
+ 'content_type',
3316
+ 'size'
3317
+ ],
3318
+ additionalProperties: false
3319
+ },
3320
+ description: 'Attachments associated with this message.',
3321
+ example: []
3322
+ },
3323
+ date_created: {
3324
+ type: 'string',
3325
+ format: 'date-time',
3326
+ description: 'Creation date of the message. ISO 8601 UTC.',
3327
+ example: '2026-05-11T16:08:14.338Z'
3328
+ }
3329
+ },
3330
+ required: [
3331
+ 'id',
3332
+ 'type',
3333
+ 'body',
3334
+ 'date_created'
3335
+ ],
3336
+ additionalProperties: false
3337
+ };
3338
+ export const TicketSchema = {
3339
+ type: 'object',
3340
+ properties: {
3341
+ id: {
3342
+ type: 'string',
3343
+ description: 'Unique identifier of the ticket (Mongo ObjectId).',
3344
+ example: '60c72b2f9f1b2c001f8e4d3a'
3345
+ },
3346
+ status: {
3347
+ type: 'string',
3348
+ description: 'Current state of the ticket.',
3349
+ example: 'waiting_on_us',
3350
+ enum: [
3351
+ 'waiting_on_us',
3352
+ 'waiting_on_user',
3353
+ 'closed'
3354
+ ]
3355
+ },
3356
+ category: {
3357
+ type: 'string',
3358
+ description: 'Ticket category.',
3359
+ example: 'technical',
3360
+ enum: [
3361
+ 'billing',
3362
+ 'technical',
3363
+ 'general'
3364
+ ]
3365
+ },
3366
+ summary: {
3367
+ type: 'string',
3368
+ description: 'First 128 characters of the initial message body, with markdown formatting and newlines stripped. Used for ticket list previews.',
3369
+ example: 'My cluster cannot reach the registry. Logs attached.'
3370
+ },
3371
+ closed_at: {
3372
+ type: 'string',
3373
+ format: 'date-time',
3374
+ nullable: true,
3375
+ description: 'Closure timestamp. Null while the ticket is open.',
3376
+ example: '2026-05-18T16:08:14.338Z'
3377
+ },
3378
+ date_created: {
3379
+ type: 'string',
3380
+ format: 'date-time',
3381
+ description: 'Creation date of the ticket. ISO 8601 UTC.',
3382
+ example: '2026-05-11T16:08:14.338Z'
3383
+ },
3384
+ date_updated: {
3385
+ type: 'string',
3386
+ format: 'date-time',
3387
+ description: 'Last update date of the ticket. ISO 8601 UTC.',
3388
+ example: '2026-05-11T16:08:14.338Z'
3389
+ },
3390
+ messages: {
3391
+ type: 'array',
3392
+ items: {
3393
+ type: 'object',
3394
+ properties: {
3395
+ id: {
3396
+ type: 'string',
3397
+ description: 'Unique identifier of the message (Mongo ObjectId).',
3398
+ example: '60c72b2f9f1b2c001f8e4d3b'
3399
+ },
3400
+ type: {
3401
+ type: 'string',
3402
+ description: 'Message type. Internal notes are filtered out of customer-facing responses.',
3403
+ example: 'customer_reply',
3404
+ enum: [
3405
+ 'customer_reply',
3406
+ 'agent_reply'
3407
+ ]
3408
+ },
3409
+ body: {
3410
+ type: 'string',
3411
+ description: 'Message body in markdown.',
3412
+ example: 'Thanks — that resolved it on my side.'
3413
+ },
3414
+ author_first_name: {
3415
+ type: 'string',
3416
+ description: 'First name of the author. Null when not provided.',
3417
+ example: 'Jane'
3418
+ },
3419
+ author_last_name: {
3420
+ type: 'string',
3421
+ description: 'Last name of the author. Null when not provided.',
3422
+ example: 'Doe'
3423
+ },
3424
+ attachments: {
3425
+ type: 'array',
3426
+ items: {
3427
+ type: 'object',
3428
+ properties: {
3429
+ id: {
3430
+ type: 'string',
3431
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3432
+ example: '60c72b2f9f1b2c001f8e4d3c'
3433
+ },
3434
+ filename: {
3435
+ type: 'string',
3436
+ description: 'Original filename as uploaded.',
3437
+ example: 'debug.log'
3438
+ },
3439
+ content_type: {
3440
+ type: 'string',
3441
+ description: 'MIME content type of the attachment.',
3442
+ example: 'text/plain'
3443
+ },
3444
+ size: {
3445
+ type: 'integer',
3446
+ description: 'Size of the attachment in bytes.',
3447
+ example: 12345
3448
+ }
3449
+ },
3450
+ required: [
3451
+ 'id',
3452
+ 'filename',
3453
+ 'content_type',
3454
+ 'size'
3455
+ ],
3456
+ additionalProperties: false
3457
+ },
3458
+ description: 'Attachments associated with this message.',
3459
+ example: []
3460
+ },
3461
+ date_created: {
3462
+ type: 'string',
3463
+ format: 'date-time',
3464
+ description: 'Creation date of the message. ISO 8601 UTC.',
3465
+ example: '2026-05-11T16:08:14.338Z'
3466
+ }
3467
+ },
3468
+ required: [
3469
+ 'id',
3470
+ 'type',
3471
+ 'body',
3472
+ 'date_created'
3473
+ ],
3474
+ additionalProperties: false
3475
+ },
3476
+ description: 'Messages on the ticket in chronological order. Internal notes are excluded. Returned by the detail endpoint only.'
3477
+ }
3478
+ },
3479
+ required: [
3480
+ 'id',
3481
+ 'status',
3482
+ 'category',
3483
+ 'summary',
3484
+ 'date_created',
3485
+ 'date_updated'
3486
+ ],
3487
+ additionalProperties: false
3488
+ };
3489
+ export const TokenCreateInputSchema = {
3490
+ type: 'object',
3491
+ properties: {
3492
+ name: {
3493
+ type: 'string',
3494
+ maxLength: 63,
3495
+ minLength: 1,
3496
+ pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
3497
+ description: 'Human readable access token name.',
3498
+ example: 'deployment-token'
3499
+ },
3500
+ role: {
3501
+ type: 'string',
3502
+ description: 'Role assumed by the token.',
1104
3503
  example: 'User',
1105
- enum: ['Administrator', 'User']
3504
+ enum: [
3505
+ 'Administrator',
3506
+ 'User'
3507
+ ]
3508
+ }
3509
+ },
3510
+ required: [
3511
+ 'name',
3512
+ 'role'
3513
+ ],
3514
+ additionalProperties: false
3515
+ };
3516
+ export const TokenSchema = {
3517
+ type: 'object',
3518
+ properties: {
3519
+ name: {
3520
+ type: 'string',
3521
+ maxLength: 63,
3522
+ minLength: 1,
3523
+ pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
3524
+ description: 'Human readable access token name.',
3525
+ example: 'deployment-token'
3526
+ },
3527
+ role: {
3528
+ type: 'string',
3529
+ description: 'Role assumed by the token.',
3530
+ example: 'User',
3531
+ enum: [
3532
+ 'Administrator',
3533
+ 'User'
3534
+ ]
1106
3535
  },
1107
3536
  id: {
1108
3537
  type: 'string',
@@ -1121,7 +3550,11 @@ export const TokenSchema = {
1121
3550
  example: '2023-12-20T13:53:32.000Z'
1122
3551
  }
1123
3552
  },
1124
- required: ['name', 'role', 'date_created'],
3553
+ required: [
3554
+ 'name',
3555
+ 'role',
3556
+ 'date_created'
3557
+ ],
1125
3558
  additionalProperties: false
1126
3559
  };
1127
3560
  export const TokenUpdateInputSchema = {
@@ -1139,9 +3572,154 @@ export const TokenUpdateInputSchema = {
1139
3572
  type: 'string',
1140
3573
  description: 'Role assumed by the token.',
1141
3574
  example: 'User',
1142
- enum: ['Administrator', 'User']
3575
+ enum: [
3576
+ 'Administrator',
3577
+ 'User'
3578
+ ]
3579
+ }
3580
+ },
3581
+ additionalProperties: false
3582
+ };
3583
+ export const UsageFacetsSchema = {
3584
+ type: 'object',
3585
+ properties: {
3586
+ cluster_id: {
3587
+ type: 'array',
3588
+ items: {
3589
+ type: 'string'
3590
+ },
3591
+ description: 'List of unique cluster IDs',
3592
+ example: [
3593
+ '6b5439b1-923a-4f2b-a371-d554e5ea23fa'
3594
+ ]
3595
+ },
3596
+ product: {
3597
+ type: 'array',
3598
+ items: {
3599
+ type: 'string',
3600
+ enum: [
3601
+ 'cfke_controlplane_basic',
3602
+ 'cfke_controlplane_pro',
3603
+ 'cfke_controlplane_enterprise',
3604
+ 'cfke_connected_nodes_basic',
3605
+ 'cfke_connected_nodes_pro',
3606
+ 'cfke_connected_nodes_enterprise',
3607
+ 'cfcr_storage'
3608
+ ]
3609
+ },
3610
+ description: 'List of unique products',
3611
+ example: [
3612
+ 'cfke_controlplane_pro',
3613
+ 'cfke_connected_nodes_pro'
3614
+ ]
3615
+ }
3616
+ },
3617
+ additionalProperties: false
3618
+ };
3619
+ export const UsageResponseSchema = {
3620
+ type: 'object',
3621
+ properties: {
3622
+ data: {
3623
+ type: 'array',
3624
+ items: {
3625
+ type: 'object',
3626
+ properties: {
3627
+ hour: {
3628
+ type: 'string',
3629
+ description: 'Hour of the usage',
3630
+ example: '2019-01-01T00:00:00.000Z'
3631
+ },
3632
+ cluster_id: {
3633
+ type: 'string',
3634
+ description: 'Unique identifier of the kubernetes cluster. UUID v4 string in canonical form',
3635
+ example: '6b5439b1-923a-4f2b-a371-d554e5ea23fa'
3636
+ },
3637
+ product: {
3638
+ type: 'string',
3639
+ description: 'The product the usage is associated with',
3640
+ example: 'cfke_controlplane_pro',
3641
+ enum: [
3642
+ 'cfke_controlplane_basic',
3643
+ 'cfke_controlplane_pro',
3644
+ 'cfke_controlplane_enterprise',
3645
+ 'cfke_connected_nodes_basic',
3646
+ 'cfke_connected_nodes_pro',
3647
+ 'cfke_connected_nodes_enterprise',
3648
+ 'cfcr_storage'
3649
+ ]
3650
+ },
3651
+ value: {
3652
+ type: 'number',
3653
+ format: 'float',
3654
+ description: 'Consumption',
3655
+ example: 4
3656
+ },
3657
+ price: {
3658
+ type: 'number',
3659
+ format: 'float',
3660
+ description: 'Price per unit',
3661
+ example: 0.01
3662
+ },
3663
+ total: {
3664
+ type: 'number',
3665
+ format: 'float',
3666
+ description: 'Total cost'
3667
+ }
3668
+ },
3669
+ required: [
3670
+ 'hour',
3671
+ 'cluster_id',
3672
+ 'product',
3673
+ 'value',
3674
+ 'price',
3675
+ 'total'
3676
+ ],
3677
+ additionalProperties: false
3678
+ },
3679
+ description: 'Usage data'
3680
+ },
3681
+ facets: {
3682
+ type: 'object',
3683
+ properties: {
3684
+ cluster_id: {
3685
+ type: 'array',
3686
+ items: {
3687
+ type: 'string'
3688
+ },
3689
+ description: 'List of unique cluster IDs',
3690
+ example: [
3691
+ '6b5439b1-923a-4f2b-a371-d554e5ea23fa'
3692
+ ]
3693
+ },
3694
+ product: {
3695
+ type: 'array',
3696
+ items: {
3697
+ type: 'string',
3698
+ enum: [
3699
+ 'cfke_controlplane_basic',
3700
+ 'cfke_controlplane_pro',
3701
+ 'cfke_controlplane_enterprise',
3702
+ 'cfke_connected_nodes_basic',
3703
+ 'cfke_connected_nodes_pro',
3704
+ 'cfke_connected_nodes_enterprise',
3705
+ 'cfcr_storage'
3706
+ ]
3707
+ },
3708
+ description: 'List of unique products',
3709
+ example: [
3710
+ 'cfke_controlplane_pro',
3711
+ 'cfke_connected_nodes_pro'
3712
+ ]
3713
+ }
3714
+ },
3715
+ additionalProperties: false,
3716
+ description: 'Facets for filtering'
1143
3717
  }
1144
3718
  },
3719
+ required: [
3720
+ 'data',
3721
+ 'facets'
3722
+ ],
1145
3723
  additionalProperties: false
1146
3724
  };
1147
3725
  export const UsageSchema = {
@@ -1154,90 +3732,49 @@ export const UsageSchema = {
1154
3732
  },
1155
3733
  cluster_id: {
1156
3734
  type: 'string',
1157
- format: 'uuid',
1158
3735
  description: 'Unique identifier of the kubernetes cluster. UUID v4 string in canonical form',
1159
3736
  example: '6b5439b1-923a-4f2b-a371-d554e5ea23fa'
1160
3737
  },
1161
- cluster_tier: {
1162
- type: 'string',
1163
- description: 'Tier of the cluster.',
1164
- example: 'pro',
1165
- enum: ['basic', 'pro', '']
1166
- },
1167
3738
  product: {
1168
3739
  type: 'string',
1169
3740
  description: 'The product the usage is associated with',
1170
- example: 'cfke_controlplane',
1171
- enum: ['cfke_controlplane', 'cfke_connected_nodes', 'infra_compute', 'infra_storage', 'infra_loadbalancing', 'infra_traffic', 'cfcr_storage']
1172
- },
1173
- node_name: {
1174
- type: 'string',
1175
- description: 'Name of the Kubernetes node',
1176
- example: 'flexible-moth-956037384'
1177
- },
1178
- sku: {
1179
- type: 'string',
1180
- description: 'SKU of the Kubernetes node',
1181
- example: 'GCP-NORTHAMERICA-NORTHEAST1-A-G1-SMALL-SPOT'
1182
- },
1183
- cpu: {
1184
- anyOf: [
1185
- {
1186
- type: 'number',
1187
- format: 'float',
1188
- description: 'CPU core count of the node',
1189
- example: 4
1190
- },
1191
- {
1192
- type: 'string',
1193
- enum: ['']
1194
- }
1195
- ]
1196
- },
1197
- price: {
1198
- anyOf: [
1199
- {
1200
- type: 'number',
1201
- format: 'float',
1202
- description: 'Price',
1203
- example: 4
1204
- },
1205
- {
1206
- type: 'string',
1207
- enum: ['']
1208
- }
3741
+ example: 'cfke_controlplane_pro',
3742
+ enum: [
3743
+ 'cfke_controlplane_basic',
3744
+ 'cfke_controlplane_pro',
3745
+ 'cfke_controlplane_enterprise',
3746
+ 'cfke_connected_nodes_basic',
3747
+ 'cfke_connected_nodes_pro',
3748
+ 'cfke_connected_nodes_enterprise',
3749
+ 'cfcr_storage'
1209
3750
  ]
1210
3751
  },
1211
3752
  value: {
1212
- anyOf: [
1213
- {
1214
- type: 'number',
1215
- format: 'float',
1216
- description: 'Value',
1217
- example: 4
1218
- },
1219
- {
1220
- type: 'string',
1221
- enum: ['']
1222
- }
1223
- ]
3753
+ type: 'number',
3754
+ format: 'float',
3755
+ description: 'Consumption',
3756
+ example: 4
3757
+ },
3758
+ price: {
3759
+ type: 'number',
3760
+ format: 'float',
3761
+ description: 'Price per unit',
3762
+ example: 0.01
1224
3763
  },
1225
3764
  total: {
1226
- anyOf: [
1227
- {
1228
- type: 'number',
1229
- format: 'float',
1230
- description: 'Total',
1231
- example: 4
1232
- },
1233
- {
1234
- type: 'string',
1235
- enum: ['']
1236
- }
1237
- ]
3765
+ type: 'number',
3766
+ format: 'float',
3767
+ description: 'Total cost'
1238
3768
  }
1239
3769
  },
1240
- required: ['cluster_id', 'cluster_tier', 'product', 'node_name', 'sku', 'cpu', 'price', 'value', 'total'],
3770
+ required: [
3771
+ 'hour',
3772
+ 'cluster_id',
3773
+ 'product',
3774
+ 'value',
3775
+ 'price',
3776
+ 'total'
3777
+ ],
1241
3778
  additionalProperties: false
1242
3779
  };
1243
3780
  export const UserCreateInputSchema = {
@@ -1273,21 +3810,15 @@ export const UserCreateInputSchema = {
1273
3810
  type: 'string',
1274
3811
  minLength: 8,
1275
3812
  description: 'User password. Must be at least 8 characters long.'
1276
- },
1277
- status: {
1278
- type: 'string',
1279
- description: 'Status of the user. Can be `active` or `inactive`. Inactive users cannot log in or manage organization resources.',
1280
- example: 'active',
1281
- enum: ['active', 'inactive']
1282
- },
1283
- role: {
1284
- type: 'string',
1285
- description: "User role. Can be 'Administrator', 'User'.",
1286
- example: 'User',
1287
- enum: ['Administrator', 'User']
1288
3813
  }
1289
3814
  },
1290
- required: ['email', 'first_name', 'last_name', 'code', 'password'],
3815
+ required: [
3816
+ 'email',
3817
+ 'first_name',
3818
+ 'last_name',
3819
+ 'code',
3820
+ 'password'
3821
+ ],
1291
3822
  additionalProperties: false
1292
3823
  };
1293
3824
  export const UserSchema = {
@@ -1315,15 +3846,21 @@ export const UserSchema = {
1315
3846
  },
1316
3847
  role: {
1317
3848
  type: 'string',
1318
- description: "User role. Can be 'Administrator', 'User'.",
3849
+ description: 'User role. Can be \'Administrator\', \'User\'.',
1319
3850
  example: 'User',
1320
- enum: ['Administrator', 'User']
3851
+ enum: [
3852
+ 'Administrator',
3853
+ 'User'
3854
+ ]
1321
3855
  },
1322
3856
  status: {
1323
3857
  type: 'string',
1324
3858
  description: 'Status of the user. Can be `active` or `inactive`. Inactive users cannot log in or manage organization resources.',
1325
3859
  example: 'active',
1326
- enum: ['active', 'inactive']
3860
+ enum: [
3861
+ 'active',
3862
+ 'inactive'
3863
+ ]
1327
3864
  },
1328
3865
  id: {
1329
3866
  type: 'string',
@@ -1338,7 +3875,15 @@ export const UserSchema = {
1338
3875
  example: '2023-11-02T16:08:14.338Z'
1339
3876
  }
1340
3877
  },
1341
- required: ['email', 'first_name', 'last_name', 'role', 'status', 'id', 'date_created'],
3878
+ required: [
3879
+ 'email',
3880
+ 'first_name',
3881
+ 'last_name',
3882
+ 'role',
3883
+ 'status',
3884
+ 'id',
3885
+ 'date_created'
3886
+ ],
1342
3887
  additionalProperties: false
1343
3888
  };
1344
3889
  export const UserUpdateInputSchema = {
@@ -1366,15 +3911,21 @@ export const UserUpdateInputSchema = {
1366
3911
  },
1367
3912
  role: {
1368
3913
  type: 'string',
1369
- description: "User role. Can be 'Administrator', 'User'.",
3914
+ description: 'User role. Can be \'Administrator\', \'User\'.',
1370
3915
  example: 'User',
1371
- enum: ['Administrator', 'User']
3916
+ enum: [
3917
+ 'Administrator',
3918
+ 'User'
3919
+ ]
1372
3920
  },
1373
3921
  status: {
1374
3922
  type: 'string',
1375
3923
  description: 'Status of the user. Can be `active` or `inactive`. Inactive users cannot log in or manage organization resources.',
1376
3924
  example: 'active',
1377
- enum: ['active', 'inactive']
3925
+ enum: [
3926
+ 'active',
3927
+ 'inactive'
3928
+ ]
1378
3929
  }
1379
3930
  },
1380
3931
  additionalProperties: false