@cloudfleet/sdk 0.0.1-3de42b3 → 0.0.1-3f11d8b

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