@cloudfleet/sdk 0.0.1-91321da → 0.0.1-933646b

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.
@@ -1,7 +1,65 @@
1
1
  // This file is auto-generated by @hey-api/openapi-ts
2
+ export const BasicPriceConsentInputSchema = {
3
+ type: 'object',
4
+ properties: {
5
+ decision: {
6
+ type: 'string',
7
+ description: 'The administrator\'s decision on the new Basic price. `accepted` continues to paid billing when the signup credit runs out; `rejected` opts out (clusters are suspended, never charged). A `rejected` org can later be flipped back to `accepted`.',
8
+ example: 'accepted',
9
+ enum: [
10
+ 'accepted',
11
+ 'rejected'
12
+ ]
13
+ }
14
+ },
15
+ required: [
16
+ 'decision'
17
+ ],
18
+ additionalProperties: false
19
+ };
20
+ export const BasicPriceConsentSchema = {
21
+ type: 'object',
22
+ properties: {
23
+ status: {
24
+ type: 'string',
25
+ description: 'Consent status for the new Basic price. `not_applicable` when the organization is not in scope for the migration. `pending` when the organization must opt in but no admin has decided yet. `accepted` / `rejected` reflect the recorded decision.',
26
+ example: 'pending',
27
+ enum: [
28
+ 'not_applicable',
29
+ 'pending',
30
+ 'accepted',
31
+ 'rejected'
32
+ ]
33
+ },
34
+ decided_at: {
35
+ type: 'string',
36
+ format: 'date-time',
37
+ description: 'When the current decision was recorded. Absent while `not_applicable` or `pending`.',
38
+ example: '2026-09-05T10:12:00.000Z'
39
+ },
40
+ decided_by: {
41
+ type: 'string',
42
+ description: 'User id of the administrator who recorded the current decision. Absent while `not_applicable` or `pending`.',
43
+ example: '2b7a5c9e-1f4d-4a1b-9c3e-8d2f6a0b1c2d'
44
+ }
45
+ },
46
+ required: [
47
+ 'status'
48
+ ],
49
+ additionalProperties: false
50
+ };
2
51
  export const BillingContactSchema = {
3
52
  type: 'object',
4
53
  properties: {
54
+ type: {
55
+ type: 'string',
56
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
57
+ example: 'business',
58
+ enum: [
59
+ 'business',
60
+ 'personal'
61
+ ]
62
+ },
5
63
  company: {
6
64
  type: 'string',
7
65
  maxLength: 120,
@@ -207,6 +265,7 @@ export const BillingContactSchema = {
207
265
  }
208
266
  },
209
267
  required: [
268
+ 'type',
210
269
  'email',
211
270
  'individual_name'
212
271
  ],
@@ -358,24 +417,8 @@ export const ChartSchema = {
358
417
  },
359
418
  status: {
360
419
  type: 'string',
361
- description: 'Status of the chart deployment.',
362
- example: 'active',
363
- enum: [
364
- 'InstallSucceeded',
365
- 'InstallFailed',
366
- 'UpgradeSucceeded',
367
- 'UpgradeFailed',
368
- 'TestSucceeded',
369
- 'TestFailed',
370
- 'RollbackSucceeded',
371
- 'RollbackFailed',
372
- 'UninstallSucceeded',
373
- 'UninstallFailed',
374
- 'ArtifactFailed',
375
- 'DependencyNotReady',
376
- 'Progressing',
377
- 'SourceNotReady'
378
- ]
420
+ description: 'Status of the chart deployment (Flux HelmRelease Ready condition reason, e.g. InstallSucceeded, UpgradeFailed, Progressing).',
421
+ example: 'InstallSucceeded'
379
422
  },
380
423
  version_current: {
381
424
  type: 'string',
@@ -446,22 +489,12 @@ export const ClusterCreateInputSchema = {
446
489
  tier: {
447
490
  type: 'string',
448
491
  description: 'Tier of the cluster.',
492
+ default: 'basic',
449
493
  example: 'pro',
450
494
  enum: [
451
495
  'basic',
452
- 'pro'
453
- ]
454
- },
455
- region: {
456
- type: 'string',
457
- description: 'Cloudfleet control plane region. One of "staging-1a", "northamerica-central-1", "europe-central-1a", "northamerica-central-1a". This field can not be updated after creation.',
458
- default: 'staging-1a',
459
- example: 'northamerica-central-1a',
460
- enum: [
461
- 'staging-1a',
462
- 'northamerica-central-1',
463
- 'europe-central-1a',
464
- 'northamerica-central-1a'
496
+ 'pro',
497
+ 'enterprise'
465
498
  ]
466
499
  },
467
500
  version_channel: {
@@ -469,20 +502,105 @@ export const ClusterCreateInputSchema = {
469
502
  pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
470
503
  description: 'Version of the kubernetes cluster.',
471
504
  default: '1.x.x-cfke.x',
472
- example: '1.x.x-cfke.x',
505
+ example: '1.x.x-cfke.x'
506
+ },
507
+ release_channel: {
508
+ type: 'string',
509
+ description: 'Release channel for the cluster\'s control plane.',
510
+ default: 'rapid',
511
+ example: 'rapid',
473
512
  enum: [
474
- '1.x.x-cfke.x',
475
- '1.31.x-cfke.x',
476
- '1.32.x-cfke.x',
477
- '1.33.x-cfke.x'
513
+ 'rapid',
514
+ 'stable',
515
+ 'extended'
478
516
  ]
517
+ },
518
+ features: {
519
+ type: 'object',
520
+ properties: {
521
+ gpu_sharing_strategy: {
522
+ type: 'string',
523
+ description: 'GPU sharing strategy.',
524
+ default: 'none',
525
+ example: 'none',
526
+ enum: [
527
+ 'none',
528
+ 'mps',
529
+ 'time_slicing'
530
+ ]
531
+ },
532
+ gpu_max_shared_clients_per_gpu: {
533
+ type: 'integer',
534
+ minimum: 2,
535
+ maximum: 48,
536
+ description: 'Maximum number of pods that may share a single GPU.',
537
+ default: 4,
538
+ example: 10
539
+ },
540
+ cilium_socket_lb_host_namespace_only: {
541
+ type: 'boolean',
542
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
543
+ example: false
544
+ }
545
+ },
546
+ additionalProperties: false,
547
+ description: 'Cluster feature toggles.',
548
+ default: {
549
+ gpu_sharing_strategy: 'none',
550
+ gpu_max_shared_clients_per_gpu: 4,
551
+ cilium_socket_lb_host_namespace_only: false
552
+ }
553
+ },
554
+ region: {
555
+ type: 'string',
556
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
557
+ example: 'europe-central-1a'
558
+ },
559
+ networking: {
560
+ type: 'object',
561
+ properties: {
562
+ pod_cidr: {
563
+ type: 'string',
564
+ description: 'CIDR block for pod IPs.',
565
+ default: '10.244.0.0/16'
566
+ },
567
+ service_cidr: {
568
+ type: 'string',
569
+ description: 'CIDR block for service IPs.',
570
+ default: '10.96.0.0/12'
571
+ },
572
+ dual_stack: {
573
+ type: 'boolean',
574
+ description: 'Enable IPv4+IPv6 dual-stack networking.'
575
+ },
576
+ pod_cidr_v6: {
577
+ type: 'string',
578
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
579
+ default: '2001:db8:1:2::/48'
580
+ },
581
+ service_cidr_v6: {
582
+ type: 'string',
583
+ description: 'IPv6 service CIDR. Requires dual_stack.',
584
+ default: '2001:db8:1:1::/112'
585
+ }
586
+ },
587
+ additionalProperties: false,
588
+ description: 'Cluster networking configuration. Immutable after creation.',
589
+ default: {
590
+ pod_cidr: '10.244.0.0/16',
591
+ service_cidr: '10.96.0.0/12',
592
+ dual_stack: false,
593
+ pod_cidr_v6: '2001:db8:1:2::/48',
594
+ service_cidr_v6: '2001:db8:1:1::/112'
595
+ }
479
596
  }
480
597
  },
481
598
  required: [
482
599
  'name',
483
- 'tier'
600
+ 'region'
484
601
  ],
485
- additionalProperties: false
602
+ additionalProperties: false,
603
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
486
604
  };
487
605
  export const ClusterJoinInformationSchema = {
488
606
  type: 'object',
@@ -503,11 +621,21 @@ export const ClusterJoinInformationSchema = {
503
621
  description: 'Cluster DNS IP address. This is the IP address of the kube-dns service in the cluster.',
504
622
  example: '10.96.0.10'
505
623
  },
624
+ pod_cidr: {
625
+ type: 'string',
626
+ description: 'Pod CIDR for the cluster. Used to configure iptables rules on nodes to prevent Tailscale routing loops.',
627
+ example: '10.244.0.0/16'
628
+ },
506
629
  auth_key: {
507
630
  type: 'string',
508
631
  description: 'Authentication key for the cluster.',
509
632
  example: 'tskey-auth-kBV8wr1dk911CNTRL-...'
510
633
  },
634
+ login_server: {
635
+ type: 'string',
636
+ 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.',
637
+ example: 'https://415026b6-f00f-44f8-968d-fc6ef4d0fc6d.fabric.europe-central-1a.cfke.io'
638
+ },
511
639
  bootstrap_token: {
512
640
  type: 'string',
513
641
  description: 'Bootstrap token for the cluster.',
@@ -578,7 +706,9 @@ export const ClusterJoinInformationSchema = {
578
706
  'certificate_authority',
579
707
  'endpoint',
580
708
  'cluster_dns',
709
+ 'pod_cidr',
581
710
  'auth_key',
711
+ 'login_server',
582
712
  'bootstrap_token',
583
713
  'versions',
584
714
  'third_party_api_access_config'
@@ -599,24 +729,123 @@ export const ClusterSchema = {
599
729
  tier: {
600
730
  type: 'string',
601
731
  description: 'Tier of the cluster.',
732
+ default: 'basic',
602
733
  example: 'pro',
603
734
  enum: [
604
735
  'basic',
605
- 'pro'
736
+ 'pro',
737
+ 'enterprise'
606
738
  ]
607
739
  },
608
- region: {
740
+ version_channel: {
741
+ type: 'string',
742
+ 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-]+)*))?$',
743
+ description: 'Version of the kubernetes cluster.',
744
+ default: '1.x.x-cfke.x',
745
+ example: '1.x.x-cfke.x'
746
+ },
747
+ release_channel: {
609
748
  type: 'string',
610
- description: 'Cloudfleet control plane region. One of "staging-1a", "northamerica-central-1", "europe-central-1a", "northamerica-central-1a". This field can not be updated after creation.',
611
- default: 'staging-1a',
612
- example: 'northamerica-central-1a',
749
+ description: 'Release channel for the cluster\'s control plane.',
750
+ default: 'rapid',
751
+ example: 'rapid',
613
752
  enum: [
614
- 'staging-1a',
615
- 'northamerica-central-1',
616
- 'europe-central-1a',
617
- 'northamerica-central-1a'
753
+ 'rapid',
754
+ 'stable',
755
+ 'extended'
618
756
  ]
619
757
  },
758
+ features: {
759
+ type: 'object',
760
+ properties: {
761
+ gpu_sharing_strategy: {
762
+ type: 'string',
763
+ description: 'GPU sharing strategy.',
764
+ default: 'none',
765
+ example: 'none',
766
+ enum: [
767
+ 'none',
768
+ 'mps',
769
+ 'time_slicing'
770
+ ]
771
+ },
772
+ gpu_max_shared_clients_per_gpu: {
773
+ type: 'integer',
774
+ minimum: 2,
775
+ maximum: 48,
776
+ description: 'Maximum number of pods that may share a single GPU.',
777
+ default: 4,
778
+ example: 10
779
+ },
780
+ cilium_socket_lb_host_namespace_only: {
781
+ type: 'boolean',
782
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
783
+ example: false
784
+ }
785
+ },
786
+ required: [
787
+ 'gpu_sharing_strategy',
788
+ 'gpu_max_shared_clients_per_gpu',
789
+ 'cilium_socket_lb_host_namespace_only'
790
+ ],
791
+ additionalProperties: false,
792
+ description: 'Cluster feature toggles.',
793
+ default: {
794
+ gpu_sharing_strategy: 'none',
795
+ gpu_max_shared_clients_per_gpu: 4,
796
+ cilium_socket_lb_host_namespace_only: false
797
+ }
798
+ },
799
+ region: {
800
+ type: 'string',
801
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
802
+ example: 'europe-central-1a'
803
+ },
804
+ networking: {
805
+ type: 'object',
806
+ properties: {
807
+ pod_cidr: {
808
+ type: 'string',
809
+ description: 'CIDR block for pod IPs.',
810
+ default: '10.244.0.0/16'
811
+ },
812
+ service_cidr: {
813
+ type: 'string',
814
+ description: 'CIDR block for service IPs.',
815
+ default: '10.96.0.0/12'
816
+ },
817
+ dual_stack: {
818
+ type: 'boolean',
819
+ description: 'Enable IPv4+IPv6 dual-stack networking.'
820
+ },
821
+ pod_cidr_v6: {
822
+ type: 'string',
823
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
824
+ default: '2001:db8:1:2::/48'
825
+ },
826
+ service_cidr_v6: {
827
+ type: 'string',
828
+ description: 'IPv6 service CIDR. Requires dual_stack.',
829
+ default: '2001:db8:1:1::/112'
830
+ }
831
+ },
832
+ required: [
833
+ 'pod_cidr',
834
+ 'service_cidr',
835
+ 'dual_stack',
836
+ 'pod_cidr_v6',
837
+ 'service_cidr_v6'
838
+ ],
839
+ additionalProperties: false,
840
+ description: 'Cluster networking configuration. Immutable after creation.',
841
+ default: {
842
+ pod_cidr: '10.244.0.0/16',
843
+ service_cidr: '10.96.0.0/12',
844
+ dual_stack: false,
845
+ pod_cidr_v6: '2001:db8:1:2::/48',
846
+ service_cidr_v6: '2001:db8:1:1::/112'
847
+ }
848
+ },
620
849
  id: {
621
850
  type: 'string',
622
851
  format: 'uuid',
@@ -625,16 +854,13 @@ export const ClusterSchema = {
625
854
  },
626
855
  status: {
627
856
  type: 'string',
628
- description: 'Status of the cluster. When creating a new cluster, set to `active`. When deleting a clusters, set to `deleted`.',
629
- example: 'active',
857
+ description: 'Status of the cluster.',
858
+ example: 'deployed',
630
859
  enum: [
631
- 'active',
632
- 'disabled',
633
- 'deleted',
634
860
  'creating',
635
861
  'deployed',
636
- 'failed',
637
- 'updating'
862
+ 'updating',
863
+ 'disabled'
638
864
  ]
639
865
  },
640
866
  endpoint: {
@@ -642,8 +868,8 @@ export const ClusterSchema = {
642
868
  {
643
869
  type: 'string',
644
870
  format: 'uri',
645
- description: 'URL signed by the private CA of the Kubernetes cluster control plane. This is the endpoint that kubectl uses to connect to the cluster. (Deprecated, use endpoint_public instead)',
646
- example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.cloudfleet.dev:6443'
871
+ 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.',
872
+ example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
647
873
  },
648
874
  {
649
875
  type: 'string',
@@ -658,7 +884,7 @@ export const ClusterSchema = {
658
884
  {
659
885
  type: 'string',
660
886
  format: 'uri',
661
- 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.',
887
+ description: 'Deprecated alias of `endpoint`; retained for backward compatibility.',
662
888
  example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
663
889
  },
664
890
  {
@@ -693,21 +919,22 @@ export const ClusterSchema = {
693
919
  type: 'boolean',
694
920
  description: 'Indicates if the cluster is ready to be used.',
695
921
  example: true
696
- },
697
- version_channel: {
698
- type: 'string',
699
- 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-]+)*))?$',
700
- description: 'Version of the kubernetes cluster.',
701
- example: '1.x.x-cfke.x'
702
922
  }
703
923
  },
704
924
  required: [
705
925
  'name',
706
926
  'tier',
927
+ 'version_channel',
928
+ 'release_channel',
929
+ 'features',
930
+ 'region',
931
+ 'networking',
707
932
  'id',
708
- 'status'
933
+ 'status',
934
+ 'ready'
709
935
  ],
710
- additionalProperties: false
936
+ additionalProperties: false,
937
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
711
938
  };
712
939
  export const ClusterUpdateInputSchema = {
713
940
  type: 'object',
@@ -723,23 +950,74 @@ export const ClusterUpdateInputSchema = {
723
950
  tier: {
724
951
  type: 'string',
725
952
  description: 'Tier of the cluster.',
953
+ default: 'basic',
726
954
  example: 'pro',
727
955
  enum: [
728
956
  'basic',
729
- 'pro'
957
+ 'pro',
958
+ 'enterprise'
730
959
  ]
731
960
  },
732
961
  version_channel: {
733
962
  type: 'string',
734
963
  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-]+)*))?$',
735
964
  description: 'Version of the kubernetes cluster.',
965
+ default: '1.x.x-cfke.x',
736
966
  example: '1.x.x-cfke.x'
967
+ },
968
+ release_channel: {
969
+ type: 'string',
970
+ description: 'Release channel for the cluster\'s control plane.',
971
+ default: 'rapid',
972
+ example: 'rapid',
973
+ enum: [
974
+ 'rapid',
975
+ 'stable',
976
+ 'extended'
977
+ ]
978
+ },
979
+ features: {
980
+ type: 'object',
981
+ properties: {
982
+ gpu_sharing_strategy: {
983
+ type: 'string',
984
+ description: 'GPU sharing strategy.',
985
+ default: 'none',
986
+ example: 'none',
987
+ enum: [
988
+ 'none',
989
+ 'mps',
990
+ 'time_slicing'
991
+ ]
992
+ },
993
+ gpu_max_shared_clients_per_gpu: {
994
+ type: 'integer',
995
+ minimum: 2,
996
+ maximum: 48,
997
+ description: 'Maximum number of pods that may share a single GPU.',
998
+ default: 4,
999
+ example: 10
1000
+ },
1001
+ cilium_socket_lb_host_namespace_only: {
1002
+ type: 'boolean',
1003
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
1004
+ example: false
1005
+ }
1006
+ },
1007
+ additionalProperties: false,
1008
+ description: 'Cluster feature toggles.',
1009
+ default: {
1010
+ gpu_sharing_strategy: 'none',
1011
+ gpu_max_shared_clients_per_gpu: 4,
1012
+ cilium_socket_lb_host_namespace_only: false
1013
+ }
737
1014
  }
738
1015
  },
739
1016
  required: [
740
- 'tier'
1017
+ 'name'
741
1018
  ],
742
- additionalProperties: false
1019
+ additionalProperties: false,
1020
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
743
1021
  };
744
1022
  export const FleetCreateInputSchema = {
745
1023
  type: 'object',
@@ -748,15 +1026,12 @@ export const FleetCreateInputSchema = {
748
1026
  type: 'object',
749
1027
  properties: {
750
1028
  cpu: {
751
- type: 'number',
752
- format: 'float',
1029
+ type: 'integer',
753
1030
  minimum: 0,
754
- description: 'CPU limit in cores.'
1031
+ maximum: 100000,
1032
+ description: 'CPU limit in cores. Maximum 100,000.'
755
1033
  }
756
1034
  },
757
- required: [
758
- 'cpu'
759
- ],
760
1035
  additionalProperties: false,
761
1036
  description: 'Limits define a set of bounds for provisioning capacity.'
762
1037
  },
@@ -764,16 +1039,17 @@ export const FleetCreateInputSchema = {
764
1039
  type: 'object',
765
1040
  properties: {
766
1041
  enabled: {
767
- type: 'boolean',
768
- default: true
1042
+ type: 'boolean'
769
1043
  },
770
1044
  project: {
771
1045
  type: 'string',
772
- description: 'Project GCP Project id to deploy instances into'
1046
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1047
+ 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.',
1048
+ example: 'my-cloudfleet-project'
773
1049
  }
774
1050
  },
775
1051
  required: [
776
- 'project'
1052
+ 'enabled'
777
1053
  ],
778
1054
  additionalProperties: false
779
1055
  },
@@ -781,16 +1057,18 @@ export const FleetCreateInputSchema = {
781
1057
  type: 'object',
782
1058
  properties: {
783
1059
  enabled: {
784
- type: 'boolean',
785
- default: true
1060
+ type: 'boolean'
786
1061
  },
787
1062
  apiKey: {
788
1063
  type: 'string',
789
- description: 'Hetzner Cloud API key with read / write access'
1064
+ maxLength: 64,
1065
+ minLength: 64,
1066
+ pattern: '^([A-Za-z0-9]{64}|\\*{64})$',
1067
+ 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.'
790
1068
  }
791
1069
  },
792
1070
  required: [
793
- 'apiKey'
1071
+ 'enabled'
794
1072
  ],
795
1073
  additionalProperties: false
796
1074
  },
@@ -798,19 +1076,321 @@ export const FleetCreateInputSchema = {
798
1076
  type: 'object',
799
1077
  properties: {
800
1078
  enabled: {
801
- type: 'boolean',
802
- default: true
1079
+ type: 'boolean'
803
1080
  },
804
1081
  controllerRoleArn: {
805
1082
  type: 'string',
806
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1083
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1084
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1085
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
807
1086
  }
808
1087
  },
809
1088
  required: [
810
- 'controllerRoleArn'
1089
+ 'enabled'
811
1090
  ],
812
1091
  additionalProperties: false
813
1092
  },
1093
+ constraints: {
1094
+ type: 'object',
1095
+ properties: {
1096
+ 'karpenter.sh/capacity-type': {
1097
+ type: 'array',
1098
+ items: {
1099
+ type: 'string',
1100
+ enum: [
1101
+ 'on-demand',
1102
+ 'spot'
1103
+ ]
1104
+ },
1105
+ minItems: 1,
1106
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1107
+ default: [
1108
+ 'on-demand',
1109
+ 'spot'
1110
+ ]
1111
+ },
1112
+ 'kubernetes.io/arch': {
1113
+ type: 'array',
1114
+ items: {
1115
+ type: 'string',
1116
+ enum: [
1117
+ 'amd64',
1118
+ 'arm64'
1119
+ ]
1120
+ },
1121
+ minItems: 1,
1122
+ description: 'Allowed values for `kubernetes.io/arch`.',
1123
+ default: [
1124
+ 'amd64'
1125
+ ]
1126
+ },
1127
+ 'cfke.io/instance-family': {
1128
+ type: 'array',
1129
+ items: {
1130
+ type: 'string',
1131
+ enum: [
1132
+ 'a1',
1133
+ 'a2',
1134
+ 'a3',
1135
+ 'a4',
1136
+ 'c1',
1137
+ 'c2',
1138
+ 'c2d',
1139
+ 'c3',
1140
+ 'c3d',
1141
+ 'c4',
1142
+ 'c4a',
1143
+ 'c4d',
1144
+ 'c5',
1145
+ 'c5a',
1146
+ 'c5ad',
1147
+ 'c5d',
1148
+ 'c5n',
1149
+ 'c6a',
1150
+ 'c6g',
1151
+ 'c6gd',
1152
+ 'c6gn',
1153
+ 'c6i',
1154
+ 'c6id',
1155
+ 'c6in',
1156
+ 'c7a',
1157
+ 'c7g',
1158
+ 'c7gd',
1159
+ 'c7gn',
1160
+ 'c7i',
1161
+ 'c7i-flex',
1162
+ 'c8g',
1163
+ 'c8gd',
1164
+ 'cax',
1165
+ 'ccx',
1166
+ 'cpx',
1167
+ 'cx',
1168
+ 'd2',
1169
+ 'd3',
1170
+ 'd3en',
1171
+ 'dl1',
1172
+ 'dl2q',
1173
+ 'e2',
1174
+ 'f1',
1175
+ 'f2',
1176
+ 'g1',
1177
+ 'g2',
1178
+ 'g4ad',
1179
+ 'g4dn',
1180
+ 'g5',
1181
+ 'g5g',
1182
+ 'g6',
1183
+ 'g6e',
1184
+ 'gr6',
1185
+ 'h1',
1186
+ 'h3',
1187
+ 'hpc6a',
1188
+ 'hpc6id',
1189
+ 'hpc7a',
1190
+ 'hpc7g',
1191
+ 'i2',
1192
+ 'i3',
1193
+ 'i3en',
1194
+ 'i4g',
1195
+ 'i4i',
1196
+ 'i7i',
1197
+ 'i7ie',
1198
+ 'i8g',
1199
+ 'im4gn',
1200
+ 'inf1',
1201
+ 'inf2',
1202
+ 'is4gen',
1203
+ 'm1',
1204
+ 'm2',
1205
+ 'm3',
1206
+ 'm4',
1207
+ 'm5',
1208
+ 'm5a',
1209
+ 'm5ad',
1210
+ 'm5d',
1211
+ 'm5dn',
1212
+ 'm5n',
1213
+ 'm5zn',
1214
+ 'm6a',
1215
+ 'm6g',
1216
+ 'm6gd',
1217
+ 'm6i',
1218
+ 'm6id',
1219
+ 'm6idn',
1220
+ 'm6in',
1221
+ 'm7a',
1222
+ 'm7g',
1223
+ 'm7gd',
1224
+ 'm7i',
1225
+ 'm7i-flex',
1226
+ 'm8g',
1227
+ 'm8gd',
1228
+ 'n1',
1229
+ 'n2',
1230
+ 'n2d',
1231
+ 'n4',
1232
+ 'p3',
1233
+ 'p3dn',
1234
+ 'p4d',
1235
+ 'p4de',
1236
+ 'p5',
1237
+ 'p5e',
1238
+ 'p5en',
1239
+ 'p6-b200',
1240
+ 'r3',
1241
+ 'r4',
1242
+ 'r5',
1243
+ 'r5a',
1244
+ 'r5ad',
1245
+ 'r5b',
1246
+ 'r5d',
1247
+ 'r5dn',
1248
+ 'r5n',
1249
+ 'r6a',
1250
+ 'r6g',
1251
+ 'r6gd',
1252
+ 'r6i',
1253
+ 'r6id',
1254
+ 'r6idn',
1255
+ 'r6in',
1256
+ 'r7a',
1257
+ 'r7g',
1258
+ 'r7gd',
1259
+ 'r7i',
1260
+ 'r7iz',
1261
+ 'r8g',
1262
+ 'r8gd',
1263
+ 't2',
1264
+ 't2a',
1265
+ 't2d',
1266
+ 't3',
1267
+ 't3a',
1268
+ 't4g',
1269
+ 'trn1',
1270
+ 'trn1n',
1271
+ 'u-3tb1',
1272
+ 'u-6tb1',
1273
+ 'u7i-12tb',
1274
+ 'u7i-6tb',
1275
+ 'u7i-8tb',
1276
+ 'u7in-16tb',
1277
+ 'u7in-24tb',
1278
+ 'u7in-32tb',
1279
+ 'vt1',
1280
+ 'x1',
1281
+ 'x1e',
1282
+ 'x2gd',
1283
+ 'x2idn',
1284
+ 'x2iedn',
1285
+ 'x2iezn',
1286
+ 'x4',
1287
+ 'x8g',
1288
+ 'z1d',
1289
+ 'z3'
1290
+ ]
1291
+ },
1292
+ description: 'Allowed values for `cfke.io/instance-family`.',
1293
+ default: []
1294
+ },
1295
+ 'topology.kubernetes.io/region': {
1296
+ type: 'array',
1297
+ items: {
1298
+ type: 'string',
1299
+ enum: [
1300
+ 'africa-south1',
1301
+ 'ap-northeast-1',
1302
+ 'ap-northeast-2',
1303
+ 'ap-northeast-3',
1304
+ 'ap-south-1',
1305
+ 'ap-southeast-1',
1306
+ 'ap-southeast-2',
1307
+ 'ash',
1308
+ 'asia-east1',
1309
+ 'asia-east2',
1310
+ 'asia-northeast1',
1311
+ 'asia-northeast2',
1312
+ 'asia-northeast3',
1313
+ 'asia-south1',
1314
+ 'asia-south2',
1315
+ 'asia-southeast1',
1316
+ 'asia-southeast2',
1317
+ 'australia-southeast1',
1318
+ 'australia-southeast2',
1319
+ 'ca-central-1',
1320
+ 'eu-central-1',
1321
+ 'eu-central-2',
1322
+ 'eu-north-1',
1323
+ 'eu-west-1',
1324
+ 'eu-west-2',
1325
+ 'eu-west-3',
1326
+ 'europe-central2',
1327
+ 'europe-north1',
1328
+ 'europe-southwest1',
1329
+ 'europe-west1',
1330
+ 'europe-west10',
1331
+ 'europe-west12',
1332
+ 'europe-west2',
1333
+ 'europe-west3',
1334
+ 'europe-west4',
1335
+ 'europe-west6',
1336
+ 'europe-west8',
1337
+ 'europe-west9',
1338
+ 'fsn1',
1339
+ 'hel1',
1340
+ 'hil',
1341
+ 'me-central1',
1342
+ 'me-central2',
1343
+ 'me-west1',
1344
+ 'nbg1',
1345
+ 'northamerica-northeast1',
1346
+ 'northamerica-northeast2',
1347
+ 'sa-east-1',
1348
+ 'sin',
1349
+ 'southamerica-east1',
1350
+ 'southamerica-west1',
1351
+ 'us-central1',
1352
+ 'us-east-1',
1353
+ 'us-east-2',
1354
+ 'us-east1',
1355
+ 'us-east4',
1356
+ 'us-east5',
1357
+ 'us-south1',
1358
+ 'us-west-1',
1359
+ 'us-west-2',
1360
+ 'us-west1',
1361
+ 'us-west2',
1362
+ 'us-west3',
1363
+ 'us-west4'
1364
+ ]
1365
+ },
1366
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
1367
+ default: []
1368
+ }
1369
+ },
1370
+ additionalProperties: false,
1371
+ 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.',
1372
+ default: {
1373
+ 'karpenter.sh/capacity-type': [
1374
+ 'on-demand',
1375
+ 'spot'
1376
+ ],
1377
+ 'kubernetes.io/arch': [
1378
+ 'amd64'
1379
+ ],
1380
+ 'cfke.io/instance-family': [],
1381
+ 'topology.kubernetes.io/region': []
1382
+ }
1383
+ },
1384
+ scalingProfile: {
1385
+ type: 'string',
1386
+ 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`).',
1387
+ default: 'conservative',
1388
+ example: 'conservative',
1389
+ enum: [
1390
+ 'aggressive',
1391
+ 'conservative'
1392
+ ]
1393
+ },
814
1394
  id: {
815
1395
  type: 'string',
816
1396
  maxLength: 63,
@@ -823,7 +1403,8 @@ export const FleetCreateInputSchema = {
823
1403
  required: [
824
1404
  'id'
825
1405
  ],
826
- additionalProperties: false
1406
+ additionalProperties: false,
1407
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
827
1408
  };
828
1409
  export const FleetSchema = {
829
1410
  type: 'object',
@@ -832,15 +1413,12 @@ export const FleetSchema = {
832
1413
  type: 'object',
833
1414
  properties: {
834
1415
  cpu: {
835
- type: 'number',
836
- format: 'float',
1416
+ type: 'integer',
837
1417
  minimum: 0,
838
- description: 'CPU limit in cores.'
1418
+ maximum: 100000,
1419
+ description: 'CPU limit in cores. Maximum 100,000.'
839
1420
  }
840
1421
  },
841
- required: [
842
- 'cpu'
843
- ],
844
1422
  additionalProperties: false,
845
1423
  description: 'Limits define a set of bounds for provisioning capacity.'
846
1424
  },
@@ -848,16 +1426,17 @@ export const FleetSchema = {
848
1426
  type: 'object',
849
1427
  properties: {
850
1428
  enabled: {
851
- type: 'boolean',
852
- default: true
1429
+ type: 'boolean'
853
1430
  },
854
1431
  project: {
855
1432
  type: 'string',
856
- description: 'Project GCP Project id to deploy instances into'
1433
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1434
+ 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.',
1435
+ example: 'my-cloudfleet-project'
857
1436
  }
858
1437
  },
859
1438
  required: [
860
- 'project'
1439
+ 'enabled'
861
1440
  ],
862
1441
  additionalProperties: false
863
1442
  },
@@ -865,16 +1444,16 @@ export const FleetSchema = {
865
1444
  type: 'object',
866
1445
  properties: {
867
1446
  enabled: {
868
- type: 'boolean',
869
- default: true
1447
+ type: 'boolean'
870
1448
  },
871
1449
  apiKey: {
872
1450
  type: 'string',
873
- description: 'Hetzner Cloud API key with read / write access'
1451
+ pattern: '^\\*{64}$',
1452
+ 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.'
874
1453
  }
875
1454
  },
876
1455
  required: [
877
- 'apiKey'
1456
+ 'enabled'
878
1457
  ],
879
1458
  additionalProperties: false
880
1459
  },
@@ -882,32 +1461,364 @@ export const FleetSchema = {
882
1461
  type: 'object',
883
1462
  properties: {
884
1463
  enabled: {
885
- type: 'boolean',
886
- default: true
1464
+ type: 'boolean'
887
1465
  },
888
1466
  controllerRoleArn: {
889
1467
  type: 'string',
890
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1468
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1469
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1470
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
891
1471
  }
892
1472
  },
893
1473
  required: [
894
- 'controllerRoleArn'
1474
+ 'enabled'
895
1475
  ],
896
1476
  additionalProperties: false
897
1477
  },
898
- id: {
1478
+ constraints: {
1479
+ type: 'object',
1480
+ properties: {
1481
+ 'karpenter.sh/capacity-type': {
1482
+ type: 'array',
1483
+ items: {
1484
+ type: 'string',
1485
+ enum: [
1486
+ 'on-demand',
1487
+ 'spot'
1488
+ ]
1489
+ },
1490
+ minItems: 1,
1491
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1492
+ default: [
1493
+ 'on-demand',
1494
+ 'spot'
1495
+ ]
1496
+ },
1497
+ 'kubernetes.io/arch': {
1498
+ type: 'array',
1499
+ items: {
1500
+ type: 'string',
1501
+ enum: [
1502
+ 'amd64',
1503
+ 'arm64'
1504
+ ]
1505
+ },
1506
+ minItems: 1,
1507
+ description: 'Allowed values for `kubernetes.io/arch`.',
1508
+ default: [
1509
+ 'amd64'
1510
+ ]
1511
+ },
1512
+ 'cfke.io/instance-family': {
1513
+ type: 'array',
1514
+ items: {
1515
+ type: 'string',
1516
+ enum: [
1517
+ 'a1',
1518
+ 'a2',
1519
+ 'a3',
1520
+ 'a4',
1521
+ 'c1',
1522
+ 'c2',
1523
+ 'c2d',
1524
+ 'c3',
1525
+ 'c3d',
1526
+ 'c4',
1527
+ 'c4a',
1528
+ 'c4d',
1529
+ 'c5',
1530
+ 'c5a',
1531
+ 'c5ad',
1532
+ 'c5d',
1533
+ 'c5n',
1534
+ 'c6a',
1535
+ 'c6g',
1536
+ 'c6gd',
1537
+ 'c6gn',
1538
+ 'c6i',
1539
+ 'c6id',
1540
+ 'c6in',
1541
+ 'c7a',
1542
+ 'c7g',
1543
+ 'c7gd',
1544
+ 'c7gn',
1545
+ 'c7i',
1546
+ 'c7i-flex',
1547
+ 'c8g',
1548
+ 'c8gd',
1549
+ 'cax',
1550
+ 'ccx',
1551
+ 'cpx',
1552
+ 'cx',
1553
+ 'd2',
1554
+ 'd3',
1555
+ 'd3en',
1556
+ 'dl1',
1557
+ 'dl2q',
1558
+ 'e2',
1559
+ 'f1',
1560
+ 'f2',
1561
+ 'g1',
1562
+ 'g2',
1563
+ 'g4ad',
1564
+ 'g4dn',
1565
+ 'g5',
1566
+ 'g5g',
1567
+ 'g6',
1568
+ 'g6e',
1569
+ 'gr6',
1570
+ 'h1',
1571
+ 'h3',
1572
+ 'hpc6a',
1573
+ 'hpc6id',
1574
+ 'hpc7a',
1575
+ 'hpc7g',
1576
+ 'i2',
1577
+ 'i3',
1578
+ 'i3en',
1579
+ 'i4g',
1580
+ 'i4i',
1581
+ 'i7i',
1582
+ 'i7ie',
1583
+ 'i8g',
1584
+ 'im4gn',
1585
+ 'inf1',
1586
+ 'inf2',
1587
+ 'is4gen',
1588
+ 'm1',
1589
+ 'm2',
1590
+ 'm3',
1591
+ 'm4',
1592
+ 'm5',
1593
+ 'm5a',
1594
+ 'm5ad',
1595
+ 'm5d',
1596
+ 'm5dn',
1597
+ 'm5n',
1598
+ 'm5zn',
1599
+ 'm6a',
1600
+ 'm6g',
1601
+ 'm6gd',
1602
+ 'm6i',
1603
+ 'm6id',
1604
+ 'm6idn',
1605
+ 'm6in',
1606
+ 'm7a',
1607
+ 'm7g',
1608
+ 'm7gd',
1609
+ 'm7i',
1610
+ 'm7i-flex',
1611
+ 'm8g',
1612
+ 'm8gd',
1613
+ 'n1',
1614
+ 'n2',
1615
+ 'n2d',
1616
+ 'n4',
1617
+ 'p3',
1618
+ 'p3dn',
1619
+ 'p4d',
1620
+ 'p4de',
1621
+ 'p5',
1622
+ 'p5e',
1623
+ 'p5en',
1624
+ 'p6-b200',
1625
+ 'r3',
1626
+ 'r4',
1627
+ 'r5',
1628
+ 'r5a',
1629
+ 'r5ad',
1630
+ 'r5b',
1631
+ 'r5d',
1632
+ 'r5dn',
1633
+ 'r5n',
1634
+ 'r6a',
1635
+ 'r6g',
1636
+ 'r6gd',
1637
+ 'r6i',
1638
+ 'r6id',
1639
+ 'r6idn',
1640
+ 'r6in',
1641
+ 'r7a',
1642
+ 'r7g',
1643
+ 'r7gd',
1644
+ 'r7i',
1645
+ 'r7iz',
1646
+ 'r8g',
1647
+ 'r8gd',
1648
+ 't2',
1649
+ 't2a',
1650
+ 't2d',
1651
+ 't3',
1652
+ 't3a',
1653
+ 't4g',
1654
+ 'trn1',
1655
+ 'trn1n',
1656
+ 'u-3tb1',
1657
+ 'u-6tb1',
1658
+ 'u7i-12tb',
1659
+ 'u7i-6tb',
1660
+ 'u7i-8tb',
1661
+ 'u7in-16tb',
1662
+ 'u7in-24tb',
1663
+ 'u7in-32tb',
1664
+ 'vt1',
1665
+ 'x1',
1666
+ 'x1e',
1667
+ 'x2gd',
1668
+ 'x2idn',
1669
+ 'x2iedn',
1670
+ 'x2iezn',
1671
+ 'x4',
1672
+ 'x8g',
1673
+ 'z1d',
1674
+ 'z3'
1675
+ ]
1676
+ },
1677
+ description: 'Allowed values for `cfke.io/instance-family`.',
1678
+ default: []
1679
+ },
1680
+ 'topology.kubernetes.io/region': {
1681
+ type: 'array',
1682
+ items: {
1683
+ type: 'string',
1684
+ enum: [
1685
+ 'africa-south1',
1686
+ 'ap-northeast-1',
1687
+ 'ap-northeast-2',
1688
+ 'ap-northeast-3',
1689
+ 'ap-south-1',
1690
+ 'ap-southeast-1',
1691
+ 'ap-southeast-2',
1692
+ 'ash',
1693
+ 'asia-east1',
1694
+ 'asia-east2',
1695
+ 'asia-northeast1',
1696
+ 'asia-northeast2',
1697
+ 'asia-northeast3',
1698
+ 'asia-south1',
1699
+ 'asia-south2',
1700
+ 'asia-southeast1',
1701
+ 'asia-southeast2',
1702
+ 'australia-southeast1',
1703
+ 'australia-southeast2',
1704
+ 'ca-central-1',
1705
+ 'eu-central-1',
1706
+ 'eu-central-2',
1707
+ 'eu-north-1',
1708
+ 'eu-west-1',
1709
+ 'eu-west-2',
1710
+ 'eu-west-3',
1711
+ 'europe-central2',
1712
+ 'europe-north1',
1713
+ 'europe-southwest1',
1714
+ 'europe-west1',
1715
+ 'europe-west10',
1716
+ 'europe-west12',
1717
+ 'europe-west2',
1718
+ 'europe-west3',
1719
+ 'europe-west4',
1720
+ 'europe-west6',
1721
+ 'europe-west8',
1722
+ 'europe-west9',
1723
+ 'fsn1',
1724
+ 'hel1',
1725
+ 'hil',
1726
+ 'me-central1',
1727
+ 'me-central2',
1728
+ 'me-west1',
1729
+ 'nbg1',
1730
+ 'northamerica-northeast1',
1731
+ 'northamerica-northeast2',
1732
+ 'sa-east-1',
1733
+ 'sin',
1734
+ 'southamerica-east1',
1735
+ 'southamerica-west1',
1736
+ 'us-central1',
1737
+ 'us-east-1',
1738
+ 'us-east-2',
1739
+ 'us-east1',
1740
+ 'us-east4',
1741
+ 'us-east5',
1742
+ 'us-south1',
1743
+ 'us-west-1',
1744
+ 'us-west-2',
1745
+ 'us-west1',
1746
+ 'us-west2',
1747
+ 'us-west3',
1748
+ 'us-west4'
1749
+ ]
1750
+ },
1751
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
1752
+ default: []
1753
+ }
1754
+ },
1755
+ required: [
1756
+ 'karpenter.sh/capacity-type',
1757
+ 'kubernetes.io/arch'
1758
+ ],
1759
+ additionalProperties: false,
1760
+ 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.',
1761
+ default: {
1762
+ 'karpenter.sh/capacity-type': [
1763
+ 'on-demand',
1764
+ 'spot'
1765
+ ],
1766
+ 'kubernetes.io/arch': [
1767
+ 'amd64'
1768
+ ],
1769
+ 'cfke.io/instance-family': [],
1770
+ 'topology.kubernetes.io/region': []
1771
+ }
1772
+ },
1773
+ scalingProfile: {
1774
+ type: 'string',
1775
+ 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`).',
1776
+ default: 'conservative',
1777
+ example: 'conservative',
1778
+ enum: [
1779
+ 'aggressive',
1780
+ 'conservative'
1781
+ ]
1782
+ },
1783
+ id: {
1784
+ type: 'string',
1785
+ maxLength: 63,
1786
+ minLength: 1,
1787
+ pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
1788
+ description: 'Unique identifier of the kubernetes fleet.',
1789
+ example: 'new-clouds-fleet'
1790
+ },
1791
+ ready: {
1792
+ type: 'boolean',
1793
+ description: 'Indicates whether the fleet configuration is healthy.',
1794
+ example: true
1795
+ },
1796
+ status_message: {
1797
+ type: 'string',
1798
+ description: 'Human-readable reason the fleet is not ready. Present only when `ready` is false.',
1799
+ example: 'Invalid provider permissions.'
1800
+ },
1801
+ created_at: {
1802
+ type: 'string',
1803
+ description: 'Creation date and time of the fleet.',
1804
+ example: '2024-09-12T09:11:27Z'
1805
+ },
1806
+ updated_at: {
899
1807
  type: 'string',
900
- maxLength: 63,
901
- minLength: 1,
902
- pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
903
- description: 'Unique identifier of the kubernetes fleet.',
904
- example: 'new-clouds-fleet'
1808
+ description: 'Date and time the fleet was last updated.',
1809
+ example: '2024-09-12T09:11:27Z'
905
1810
  }
906
1811
  },
907
1812
  required: [
908
- 'id'
1813
+ 'constraints',
1814
+ 'scalingProfile',
1815
+ 'id',
1816
+ 'ready',
1817
+ 'created_at',
1818
+ 'updated_at'
909
1819
  ],
910
- additionalProperties: false
1820
+ additionalProperties: false,
1821
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
911
1822
  };
912
1823
  export const FleetUpdateInputSchema = {
913
1824
  type: 'object',
@@ -916,15 +1827,12 @@ export const FleetUpdateInputSchema = {
916
1827
  type: 'object',
917
1828
  properties: {
918
1829
  cpu: {
919
- type: 'number',
920
- format: 'float',
1830
+ type: 'integer',
921
1831
  minimum: 0,
922
- description: 'CPU limit in cores.'
1832
+ maximum: 100000,
1833
+ description: 'CPU limit in cores. Maximum 100,000.'
923
1834
  }
924
1835
  },
925
- required: [
926
- 'cpu'
927
- ],
928
1836
  additionalProperties: false,
929
1837
  description: 'Limits define a set of bounds for provisioning capacity.'
930
1838
  },
@@ -932,16 +1840,17 @@ export const FleetUpdateInputSchema = {
932
1840
  type: 'object',
933
1841
  properties: {
934
1842
  enabled: {
935
- type: 'boolean',
936
- default: true
1843
+ type: 'boolean'
937
1844
  },
938
1845
  project: {
939
1846
  type: 'string',
940
- description: 'Project GCP Project id to deploy instances into'
1847
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1848
+ 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.',
1849
+ example: 'my-cloudfleet-project'
941
1850
  }
942
1851
  },
943
1852
  required: [
944
- 'project'
1853
+ 'enabled'
945
1854
  ],
946
1855
  additionalProperties: false
947
1856
  },
@@ -949,16 +1858,18 @@ export const FleetUpdateInputSchema = {
949
1858
  type: 'object',
950
1859
  properties: {
951
1860
  enabled: {
952
- type: 'boolean',
953
- default: true
1861
+ type: 'boolean'
954
1862
  },
955
1863
  apiKey: {
956
1864
  type: 'string',
957
- description: 'Hetzner Cloud API key with read / write access'
1865
+ maxLength: 64,
1866
+ minLength: 64,
1867
+ pattern: '^([A-Za-z0-9]{64}|\\*{64})$',
1868
+ 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.'
958
1869
  }
959
1870
  },
960
1871
  required: [
961
- 'apiKey'
1872
+ 'enabled'
962
1873
  ],
963
1874
  additionalProperties: false
964
1875
  },
@@ -966,20 +1877,348 @@ export const FleetUpdateInputSchema = {
966
1877
  type: 'object',
967
1878
  properties: {
968
1879
  enabled: {
969
- type: 'boolean',
970
- default: true
1880
+ type: 'boolean'
971
1881
  },
972
1882
  controllerRoleArn: {
973
1883
  type: 'string',
974
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1884
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1885
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1886
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
975
1887
  }
976
1888
  },
977
1889
  required: [
978
- 'controllerRoleArn'
1890
+ 'enabled'
979
1891
  ],
980
1892
  additionalProperties: false
1893
+ },
1894
+ constraints: {
1895
+ type: 'object',
1896
+ properties: {
1897
+ 'karpenter.sh/capacity-type': {
1898
+ type: 'array',
1899
+ items: {
1900
+ type: 'string',
1901
+ enum: [
1902
+ 'on-demand',
1903
+ 'spot'
1904
+ ]
1905
+ },
1906
+ minItems: 1,
1907
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1908
+ default: [
1909
+ 'on-demand',
1910
+ 'spot'
1911
+ ]
1912
+ },
1913
+ 'kubernetes.io/arch': {
1914
+ type: 'array',
1915
+ items: {
1916
+ type: 'string',
1917
+ enum: [
1918
+ 'amd64',
1919
+ 'arm64'
1920
+ ]
1921
+ },
1922
+ minItems: 1,
1923
+ description: 'Allowed values for `kubernetes.io/arch`.',
1924
+ default: [
1925
+ 'amd64'
1926
+ ]
1927
+ },
1928
+ 'cfke.io/instance-family': {
1929
+ type: 'array',
1930
+ items: {
1931
+ type: 'string',
1932
+ enum: [
1933
+ 'a1',
1934
+ 'a2',
1935
+ 'a3',
1936
+ 'a4',
1937
+ 'c1',
1938
+ 'c2',
1939
+ 'c2d',
1940
+ 'c3',
1941
+ 'c3d',
1942
+ 'c4',
1943
+ 'c4a',
1944
+ 'c4d',
1945
+ 'c5',
1946
+ 'c5a',
1947
+ 'c5ad',
1948
+ 'c5d',
1949
+ 'c5n',
1950
+ 'c6a',
1951
+ 'c6g',
1952
+ 'c6gd',
1953
+ 'c6gn',
1954
+ 'c6i',
1955
+ 'c6id',
1956
+ 'c6in',
1957
+ 'c7a',
1958
+ 'c7g',
1959
+ 'c7gd',
1960
+ 'c7gn',
1961
+ 'c7i',
1962
+ 'c7i-flex',
1963
+ 'c8g',
1964
+ 'c8gd',
1965
+ 'cax',
1966
+ 'ccx',
1967
+ 'cpx',
1968
+ 'cx',
1969
+ 'd2',
1970
+ 'd3',
1971
+ 'd3en',
1972
+ 'dl1',
1973
+ 'dl2q',
1974
+ 'e2',
1975
+ 'f1',
1976
+ 'f2',
1977
+ 'g1',
1978
+ 'g2',
1979
+ 'g4ad',
1980
+ 'g4dn',
1981
+ 'g5',
1982
+ 'g5g',
1983
+ 'g6',
1984
+ 'g6e',
1985
+ 'gr6',
1986
+ 'h1',
1987
+ 'h3',
1988
+ 'hpc6a',
1989
+ 'hpc6id',
1990
+ 'hpc7a',
1991
+ 'hpc7g',
1992
+ 'i2',
1993
+ 'i3',
1994
+ 'i3en',
1995
+ 'i4g',
1996
+ 'i4i',
1997
+ 'i7i',
1998
+ 'i7ie',
1999
+ 'i8g',
2000
+ 'im4gn',
2001
+ 'inf1',
2002
+ 'inf2',
2003
+ 'is4gen',
2004
+ 'm1',
2005
+ 'm2',
2006
+ 'm3',
2007
+ 'm4',
2008
+ 'm5',
2009
+ 'm5a',
2010
+ 'm5ad',
2011
+ 'm5d',
2012
+ 'm5dn',
2013
+ 'm5n',
2014
+ 'm5zn',
2015
+ 'm6a',
2016
+ 'm6g',
2017
+ 'm6gd',
2018
+ 'm6i',
2019
+ 'm6id',
2020
+ 'm6idn',
2021
+ 'm6in',
2022
+ 'm7a',
2023
+ 'm7g',
2024
+ 'm7gd',
2025
+ 'm7i',
2026
+ 'm7i-flex',
2027
+ 'm8g',
2028
+ 'm8gd',
2029
+ 'n1',
2030
+ 'n2',
2031
+ 'n2d',
2032
+ 'n4',
2033
+ 'p3',
2034
+ 'p3dn',
2035
+ 'p4d',
2036
+ 'p4de',
2037
+ 'p5',
2038
+ 'p5e',
2039
+ 'p5en',
2040
+ 'p6-b200',
2041
+ 'r3',
2042
+ 'r4',
2043
+ 'r5',
2044
+ 'r5a',
2045
+ 'r5ad',
2046
+ 'r5b',
2047
+ 'r5d',
2048
+ 'r5dn',
2049
+ 'r5n',
2050
+ 'r6a',
2051
+ 'r6g',
2052
+ 'r6gd',
2053
+ 'r6i',
2054
+ 'r6id',
2055
+ 'r6idn',
2056
+ 'r6in',
2057
+ 'r7a',
2058
+ 'r7g',
2059
+ 'r7gd',
2060
+ 'r7i',
2061
+ 'r7iz',
2062
+ 'r8g',
2063
+ 'r8gd',
2064
+ 't2',
2065
+ 't2a',
2066
+ 't2d',
2067
+ 't3',
2068
+ 't3a',
2069
+ 't4g',
2070
+ 'trn1',
2071
+ 'trn1n',
2072
+ 'u-3tb1',
2073
+ 'u-6tb1',
2074
+ 'u7i-12tb',
2075
+ 'u7i-6tb',
2076
+ 'u7i-8tb',
2077
+ 'u7in-16tb',
2078
+ 'u7in-24tb',
2079
+ 'u7in-32tb',
2080
+ 'vt1',
2081
+ 'x1',
2082
+ 'x1e',
2083
+ 'x2gd',
2084
+ 'x2idn',
2085
+ 'x2iedn',
2086
+ 'x2iezn',
2087
+ 'x4',
2088
+ 'x8g',
2089
+ 'z1d',
2090
+ 'z3'
2091
+ ]
2092
+ },
2093
+ description: 'Allowed values for `cfke.io/instance-family`.',
2094
+ default: []
2095
+ },
2096
+ 'topology.kubernetes.io/region': {
2097
+ type: 'array',
2098
+ items: {
2099
+ type: 'string',
2100
+ enum: [
2101
+ 'africa-south1',
2102
+ 'ap-northeast-1',
2103
+ 'ap-northeast-2',
2104
+ 'ap-northeast-3',
2105
+ 'ap-south-1',
2106
+ 'ap-southeast-1',
2107
+ 'ap-southeast-2',
2108
+ 'ash',
2109
+ 'asia-east1',
2110
+ 'asia-east2',
2111
+ 'asia-northeast1',
2112
+ 'asia-northeast2',
2113
+ 'asia-northeast3',
2114
+ 'asia-south1',
2115
+ 'asia-south2',
2116
+ 'asia-southeast1',
2117
+ 'asia-southeast2',
2118
+ 'australia-southeast1',
2119
+ 'australia-southeast2',
2120
+ 'ca-central-1',
2121
+ 'eu-central-1',
2122
+ 'eu-central-2',
2123
+ 'eu-north-1',
2124
+ 'eu-west-1',
2125
+ 'eu-west-2',
2126
+ 'eu-west-3',
2127
+ 'europe-central2',
2128
+ 'europe-north1',
2129
+ 'europe-southwest1',
2130
+ 'europe-west1',
2131
+ 'europe-west10',
2132
+ 'europe-west12',
2133
+ 'europe-west2',
2134
+ 'europe-west3',
2135
+ 'europe-west4',
2136
+ 'europe-west6',
2137
+ 'europe-west8',
2138
+ 'europe-west9',
2139
+ 'fsn1',
2140
+ 'hel1',
2141
+ 'hil',
2142
+ 'me-central1',
2143
+ 'me-central2',
2144
+ 'me-west1',
2145
+ 'nbg1',
2146
+ 'northamerica-northeast1',
2147
+ 'northamerica-northeast2',
2148
+ 'sa-east-1',
2149
+ 'sin',
2150
+ 'southamerica-east1',
2151
+ 'southamerica-west1',
2152
+ 'us-central1',
2153
+ 'us-east-1',
2154
+ 'us-east-2',
2155
+ 'us-east1',
2156
+ 'us-east4',
2157
+ 'us-east5',
2158
+ 'us-south1',
2159
+ 'us-west-1',
2160
+ 'us-west-2',
2161
+ 'us-west1',
2162
+ 'us-west2',
2163
+ 'us-west3',
2164
+ 'us-west4'
2165
+ ]
2166
+ },
2167
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
2168
+ default: []
2169
+ }
2170
+ },
2171
+ additionalProperties: false,
2172
+ 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.',
2173
+ default: {
2174
+ 'karpenter.sh/capacity-type': [
2175
+ 'on-demand',
2176
+ 'spot'
2177
+ ],
2178
+ 'kubernetes.io/arch': [
2179
+ 'amd64'
2180
+ ],
2181
+ 'cfke.io/instance-family': [],
2182
+ 'topology.kubernetes.io/region': []
2183
+ }
2184
+ },
2185
+ scalingProfile: {
2186
+ type: 'string',
2187
+ 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`).',
2188
+ default: 'conservative',
2189
+ example: 'conservative',
2190
+ enum: [
2191
+ 'aggressive',
2192
+ 'conservative'
2193
+ ]
2194
+ }
2195
+ },
2196
+ additionalProperties: false,
2197
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
2198
+ };
2199
+ export const InviteCreateInputSchema = {
2200
+ type: 'object',
2201
+ properties: {
2202
+ email: {
2203
+ type: 'string',
2204
+ format: 'email',
2205
+ description: 'Email address of the user to invite.',
2206
+ example: 'email@example.com'
2207
+ },
2208
+ role: {
2209
+ type: 'string',
2210
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2211
+ default: 'User',
2212
+ example: 'User',
2213
+ enum: [
2214
+ 'Administrator',
2215
+ 'User'
2216
+ ]
981
2217
  }
982
2218
  },
2219
+ required: [
2220
+ 'email'
2221
+ ],
983
2222
  additionalProperties: false
984
2223
  };
985
2224
  export const InviteSchema = {
@@ -1012,6 +2251,16 @@ export const InviteSchema = {
1012
2251
  type: 'string',
1013
2252
  description: 'Generated unique invite code.',
1014
2253
  example: '7kUZnH7nnKUFfvc4NK2KQF'
2254
+ },
2255
+ role: {
2256
+ type: 'string',
2257
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2258
+ default: 'User',
2259
+ example: 'User',
2260
+ enum: [
2261
+ 'Administrator',
2262
+ 'User'
2263
+ ]
1015
2264
  }
1016
2265
  },
1017
2266
  required: [
@@ -1232,6 +2481,15 @@ export const MarketplaceListingSchema = {
1232
2481
  export const OrganizationCreateInputSchema = {
1233
2482
  type: 'object',
1234
2483
  properties: {
2484
+ type: {
2485
+ type: 'string',
2486
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2487
+ example: 'business',
2488
+ enum: [
2489
+ 'business',
2490
+ 'personal'
2491
+ ]
2492
+ },
1235
2493
  email: {
1236
2494
  type: 'string',
1237
2495
  format: 'email',
@@ -1240,11 +2498,13 @@ export const OrganizationCreateInputSchema = {
1240
2498
  },
1241
2499
  first_name: {
1242
2500
  type: 'string',
2501
+ minLength: 1,
1243
2502
  description: 'First name of the billing contact person.',
1244
2503
  example: 'John'
1245
2504
  },
1246
2505
  last_name: {
1247
2506
  type: 'string',
2507
+ minLength: 1,
1248
2508
  description: 'Last name of the billing contact person.',
1249
2509
  example: 'Doe'
1250
2510
  },
@@ -1263,6 +2523,7 @@ export const OrganizationCreateInputSchema = {
1263
2523
  }
1264
2524
  },
1265
2525
  required: [
2526
+ 'type',
1266
2527
  'email',
1267
2528
  'first_name',
1268
2529
  'last_name',
@@ -1271,6 +2532,20 @@ export const OrganizationCreateInputSchema = {
1271
2532
  ],
1272
2533
  additionalProperties: false
1273
2534
  };
2535
+ export const OrganizationCreateOutputSchema = {
2536
+ type: 'object',
2537
+ properties: {
2538
+ id: {
2539
+ type: 'string',
2540
+ description: 'Unique identifier of the newly created organization. Generated by the API and safe to use for client-side tracking immediately.',
2541
+ example: 'organization-id'
2542
+ }
2543
+ },
2544
+ required: [
2545
+ 'id'
2546
+ ],
2547
+ additionalProperties: false
2548
+ };
1274
2549
  export const OrganizationSchema = {
1275
2550
  type: 'object',
1276
2551
  properties: {
@@ -1287,6 +2562,15 @@ export const OrganizationSchema = {
1287
2562
  description: 'Name of the legal entity. This name will be used in invoices. Use your first and last name for individual accounts.',
1288
2563
  example: 'ACME Corp.'
1289
2564
  },
2565
+ type: {
2566
+ type: 'string',
2567
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2568
+ example: 'business',
2569
+ enum: [
2570
+ 'business',
2571
+ 'personal'
2572
+ ]
2573
+ },
1290
2574
  date_created: {
1291
2575
  type: 'string',
1292
2576
  format: 'date-time',
@@ -1318,6 +2602,17 @@ export const OrganizationSchema = {
1318
2602
  description: 'Available number of Pro clusters that can be created.',
1319
2603
  example: 999
1320
2604
  },
2605
+ enterprise_clusters_max: {
2606
+ type: 'integer',
2607
+ minimum: 0,
2608
+ description: 'Maximum number of Enterprise clusters that can be created.',
2609
+ example: 999
2610
+ },
2611
+ enterprise_clusters_available: {
2612
+ type: 'integer',
2613
+ description: 'Available number of Enterprise clusters that can be created.',
2614
+ example: 999
2615
+ },
1321
2616
  fleets_max: {
1322
2617
  type: 'integer',
1323
2618
  minimum: 0,
@@ -1337,7 +2632,7 @@ export const OrganizationSchema = {
1337
2632
  type: 'array',
1338
2633
  items: {
1339
2634
  type: 'string',
1340
- example: 'northamerica-central-1'
2635
+ example: 'northamerica-central-1a'
1341
2636
  },
1342
2637
  minItems: 1,
1343
2638
  description: 'List of Cloudfleet control plane regions available for the organization.'
@@ -1379,6 +2674,8 @@ export const OrganizationSchema = {
1379
2674
  'basic_clusters_available',
1380
2675
  'pro_clusters_max',
1381
2676
  'pro_clusters_available',
2677
+ 'enterprise_clusters_max',
2678
+ 'enterprise_clusters_available',
1382
2679
  'fleets_max',
1383
2680
  'cluster_tiers',
1384
2681
  'regions',
@@ -1396,13 +2693,25 @@ export const OrganizationSchema = {
1396
2693
  'closed',
1397
2694
  'suspended'
1398
2695
  ]
2696
+ },
2697
+ verification: {
2698
+ type: 'string',
2699
+ 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.',
2700
+ example: 'verified',
2701
+ enum: [
2702
+ 'none',
2703
+ 'submitted',
2704
+ 'verified'
2705
+ ]
1399
2706
  }
1400
2707
  },
1401
2708
  required: [
1402
2709
  'id',
2710
+ 'type',
1403
2711
  'date_created',
1404
2712
  'quota',
1405
- 'status'
2713
+ 'status',
2714
+ 'verification'
1406
2715
  ],
1407
2716
  additionalProperties: false
1408
2717
  };
@@ -1411,28 +2720,23 @@ export const PaymentMethodSchema = {
1411
2720
  properties: {
1412
2721
  id: {
1413
2722
  type: 'string',
1414
- format: 'uuid',
1415
- description: 'Unique identifier of the organization. UUID v4 string in canonical form.',
1416
- example: 'e94d30ec-a2dd-4dcb-832c-ac2be144ba91'
1417
- },
1418
- setup: {
1419
- type: 'boolean',
1420
- description: 'Whether organization payment method was set up and ready to use for payments.',
1421
- example: true
2723
+ 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.',
2724
+ example: 'pm_1MtwBwLkdIwHu7ix28a3tqPa'
1422
2725
  },
1423
2726
  type: {
1424
2727
  type: 'string',
1425
- nullable: true,
1426
- description: 'Payment method type type. Only `card` payments supported at the moment.',
2728
+ description: 'Payment method type. `card`, `sepa_debit` for SEPA Direct Debit (business accounts only), or `bank_transfer` for paying invoices by bank transfer.',
1427
2729
  example: 'card',
1428
2730
  enum: [
1429
- 'card'
2731
+ 'card',
2732
+ 'sepa_debit',
2733
+ 'bank_transfer'
1430
2734
  ]
1431
2735
  },
1432
2736
  last4: {
1433
2737
  type: 'string',
1434
2738
  nullable: true,
1435
- description: 'Last 4 digits of the payment card number.',
2739
+ 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.',
1436
2740
  example: '4242'
1437
2741
  },
1438
2742
  exp_month: {
@@ -1440,42 +2744,56 @@ export const PaymentMethodSchema = {
1440
2744
  minimum: 1,
1441
2745
  maximum: 12,
1442
2746
  nullable: true,
1443
- description: 'Two-digit number representing the card\'s expiration month.',
1444
- example: '12'
2747
+ description: 'Two-digit number representing the card\'s expiration month. Null for SEPA Direct Debit and bank transfer.',
2748
+ example: 12
1445
2749
  },
1446
2750
  exp_year: {
1447
2751
  type: 'integer',
1448
- minimum: 2024,
1449
2752
  nullable: true,
1450
- description: 'Four-digit number representing the card\'s expiration year.',
1451
- example: '2028'
2753
+ 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.',
2754
+ example: 2028
1452
2755
  },
1453
2756
  brand: {
1454
2757
  type: 'string',
1455
2758
  nullable: true,
1456
- description: 'Payment card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.',
1457
- example: 'visa',
1458
- enum: [
1459
- 'amex',
1460
- 'diners',
1461
- 'discover',
1462
- 'eftpos_au',
1463
- 'jcb',
1464
- 'mastercard',
1465
- 'unionpay',
1466
- 'visa',
1467
- 'unknown'
1468
- ]
2759
+ 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.',
2760
+ example: 'visa'
2761
+ },
2762
+ iban: {
2763
+ type: 'string',
2764
+ nullable: true,
2765
+ 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.',
2766
+ example: 'DE11243015658023127510'
2767
+ },
2768
+ bic: {
2769
+ type: 'string',
2770
+ nullable: true,
2771
+ description: 'BIC/SWIFT of the destination bank for bank transfers. Set only for `bank_transfer`; null otherwise.',
2772
+ example: 'SOGEDEFFXXX'
2773
+ },
2774
+ account_holder_name: {
2775
+ type: 'string',
2776
+ nullable: true,
2777
+ description: 'Account holder name of the destination bank account for bank transfers. Set only for `bank_transfer`; null otherwise.',
2778
+ example: 'Cloudfleet GmbH'
2779
+ },
2780
+ is_default: {
2781
+ type: 'boolean',
2782
+ 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).',
2783
+ example: true
1469
2784
  }
1470
2785
  },
1471
2786
  required: [
1472
2787
  'id',
1473
- 'setup',
1474
2788
  'type',
1475
2789
  'last4',
1476
2790
  'exp_month',
1477
2791
  'exp_year',
1478
- 'brand'
2792
+ 'brand',
2793
+ 'iban',
2794
+ 'bic',
2795
+ 'account_holder_name',
2796
+ 'is_default'
1479
2797
  ],
1480
2798
  additionalProperties: false
1481
2799
  };
@@ -1504,6 +2822,17 @@ export const PlatformQuotaSchema = {
1504
2822
  description: 'Available number of Pro clusters that can be created.',
1505
2823
  example: 999
1506
2824
  },
2825
+ enterprise_clusters_max: {
2826
+ type: 'integer',
2827
+ minimum: 0,
2828
+ description: 'Maximum number of Enterprise clusters that can be created.',
2829
+ example: 999
2830
+ },
2831
+ enterprise_clusters_available: {
2832
+ type: 'integer',
2833
+ description: 'Available number of Enterprise clusters that can be created.',
2834
+ example: 999
2835
+ },
1507
2836
  fleets_max: {
1508
2837
  type: 'integer',
1509
2838
  minimum: 0,
@@ -1523,7 +2852,7 @@ export const PlatformQuotaSchema = {
1523
2852
  type: 'array',
1524
2853
  items: {
1525
2854
  type: 'string',
1526
- example: 'northamerica-central-1'
2855
+ example: 'northamerica-central-1a'
1527
2856
  },
1528
2857
  minItems: 1,
1529
2858
  description: 'List of Cloudfleet control plane regions available for the organization.'
@@ -1565,6 +2894,8 @@ export const PlatformQuotaSchema = {
1565
2894
  'basic_clusters_available',
1566
2895
  'pro_clusters_max',
1567
2896
  'pro_clusters_available',
2897
+ 'enterprise_clusters_max',
2898
+ 'enterprise_clusters_available',
1568
2899
  'fleets_max',
1569
2900
  'cluster_tiers',
1570
2901
  'regions',
@@ -1907,172 +3238,6 @@ export const TicketCreateInputSchema = {
1907
3238
  ],
1908
3239
  additionalProperties: false
1909
3240
  };
1910
- export const TicketListResponseSchema = {
1911
- type: 'object',
1912
- properties: {
1913
- items: {
1914
- type: 'array',
1915
- items: {
1916
- type: 'object',
1917
- properties: {
1918
- id: {
1919
- type: 'string',
1920
- description: 'Unique identifier of the ticket (Mongo ObjectId).',
1921
- example: '60c72b2f9f1b2c001f8e4d3a'
1922
- },
1923
- status: {
1924
- type: 'string',
1925
- description: 'Current state of the ticket.',
1926
- example: 'waiting_on_us',
1927
- enum: [
1928
- 'waiting_on_us',
1929
- 'waiting_on_user',
1930
- 'closed'
1931
- ]
1932
- },
1933
- category: {
1934
- type: 'string',
1935
- description: 'Ticket category.',
1936
- example: 'technical',
1937
- enum: [
1938
- 'billing',
1939
- 'technical',
1940
- 'general'
1941
- ]
1942
- },
1943
- summary: {
1944
- type: 'string',
1945
- description: 'First 128 characters of the initial message body, with markdown formatting and newlines stripped. Used for ticket list previews.',
1946
- example: 'My cluster cannot reach the registry. Logs attached.'
1947
- },
1948
- closed_at: {
1949
- type: 'string',
1950
- format: 'date-time',
1951
- nullable: true,
1952
- description: 'Closure timestamp. Null while the ticket is open.',
1953
- example: '2026-05-18T16:08:14.338Z'
1954
- },
1955
- date_created: {
1956
- type: 'string',
1957
- format: 'date-time',
1958
- description: 'Creation date of the ticket. ISO 8601 UTC.',
1959
- example: '2026-05-11T16:08:14.338Z'
1960
- },
1961
- date_updated: {
1962
- type: 'string',
1963
- format: 'date-time',
1964
- description: 'Last update date of the ticket. ISO 8601 UTC.',
1965
- example: '2026-05-11T16:08:14.338Z'
1966
- },
1967
- messages: {
1968
- type: 'array',
1969
- items: {
1970
- type: 'object',
1971
- properties: {
1972
- id: {
1973
- type: 'string',
1974
- description: 'Unique identifier of the message (Mongo ObjectId).',
1975
- example: '60c72b2f9f1b2c001f8e4d3b'
1976
- },
1977
- type: {
1978
- type: 'string',
1979
- description: 'Message type. Internal notes are filtered out of customer-facing responses.',
1980
- example: 'customer_reply',
1981
- enum: [
1982
- 'customer_reply',
1983
- 'agent_reply'
1984
- ]
1985
- },
1986
- body: {
1987
- type: 'string',
1988
- description: 'Message body in markdown.',
1989
- example: 'Thanks — that resolved it on my side.'
1990
- },
1991
- author_first_name: {
1992
- type: 'string',
1993
- nullable: true,
1994
- description: 'First name of the author. Null when not provided.',
1995
- example: 'Jane'
1996
- },
1997
- author_last_name: {
1998
- type: 'string',
1999
- nullable: true,
2000
- description: 'Last name of the author. Null when not provided.',
2001
- example: 'Doe'
2002
- },
2003
- attachments: {
2004
- type: 'array',
2005
- items: {
2006
- type: 'object',
2007
- properties: {
2008
- id: {
2009
- type: 'string',
2010
- description: 'Unique identifier of the attachment (Mongo ObjectId).',
2011
- example: '60c72b2f9f1b2c001f8e4d3c'
2012
- },
2013
- filename: {
2014
- type: 'string',
2015
- description: 'Original filename as uploaded.',
2016
- example: 'debug.log'
2017
- },
2018
- content_type: {
2019
- type: 'string',
2020
- description: 'MIME content type of the attachment.',
2021
- example: 'text/plain'
2022
- },
2023
- size: {
2024
- type: 'integer',
2025
- description: 'Size of the attachment in bytes.',
2026
- example: 12345
2027
- }
2028
- },
2029
- required: [
2030
- 'id',
2031
- 'filename',
2032
- 'content_type',
2033
- 'size'
2034
- ],
2035
- additionalProperties: false
2036
- },
2037
- description: 'Attachments associated with this message.',
2038
- example: []
2039
- },
2040
- date_created: {
2041
- type: 'string',
2042
- format: 'date-time',
2043
- description: 'Creation date of the message. ISO 8601 UTC.',
2044
- example: '2026-05-11T16:08:14.338Z'
2045
- }
2046
- },
2047
- required: [
2048
- 'id',
2049
- 'type',
2050
- 'body',
2051
- 'date_created'
2052
- ],
2053
- additionalProperties: false
2054
- },
2055
- description: 'Messages on the ticket in chronological order. Internal notes are excluded. Returned by the detail endpoint only.'
2056
- }
2057
- },
2058
- required: [
2059
- 'id',
2060
- 'status',
2061
- 'category',
2062
- 'summary',
2063
- 'date_created',
2064
- 'date_updated'
2065
- ],
2066
- additionalProperties: false
2067
- },
2068
- description: 'Tickets for the organization, ordered newest first. Messages are omitted from list responses.'
2069
- }
2070
- },
2071
- required: [
2072
- 'items'
2073
- ],
2074
- additionalProperties: false
2075
- };
2076
3241
  export const TicketMessageInputSchema = {
2077
3242
  type: 'object',
2078
3243
  properties: {
@@ -2114,11 +3279,13 @@ export const TicketMessageSchema = {
2114
3279
  },
2115
3280
  author_first_name: {
2116
3281
  type: 'string',
3282
+ nullable: true,
2117
3283
  description: 'First name of the author. Null when not provided.',
2118
3284
  example: 'Jane'
2119
3285
  },
2120
3286
  author_last_name: {
2121
3287
  type: 'string',
3288
+ nullable: true,
2122
3289
  description: 'Last name of the author. Null when not provided.',
2123
3290
  example: 'Doe'
2124
3291
  },
@@ -2210,6 +3377,7 @@ export const TicketSchema = {
2210
3377
  closed_at: {
2211
3378
  type: 'string',
2212
3379
  format: 'date-time',
3380
+ nullable: true,
2213
3381
  description: 'Closure timestamp. Null while the ticket is open.',
2214
3382
  example: '2026-05-18T16:08:14.338Z'
2215
3383
  },
@@ -2434,12 +3602,21 @@ export const UsageFacetsSchema = {
2434
3602
  product: {
2435
3603
  type: 'array',
2436
3604
  items: {
2437
- type: 'string'
3605
+ type: 'string',
3606
+ enum: [
3607
+ 'cfke_controlplane_basic',
3608
+ 'cfke_controlplane_pro',
3609
+ 'cfke_controlplane_enterprise',
3610
+ 'cfke_connected_nodes_basic',
3611
+ 'cfke_connected_nodes_pro',
3612
+ 'cfke_connected_nodes_enterprise',
3613
+ 'cfcr_storage'
3614
+ ]
2438
3615
  },
2439
3616
  description: 'List of unique products',
2440
3617
  example: [
2441
- 'cfke_controlplane',
2442
- 'cfke_connected_nodes'
3618
+ 'cfke_controlplane_pro',
3619
+ 'cfke_connected_nodes_pro'
2443
3620
  ]
2444
3621
  }
2445
3622
  },
@@ -2466,7 +3643,16 @@ export const UsageResponseSchema = {
2466
3643
  product: {
2467
3644
  type: 'string',
2468
3645
  description: 'The product the usage is associated with',
2469
- example: 'cfke_controlplane'
3646
+ example: 'cfke_controlplane_pro',
3647
+ enum: [
3648
+ 'cfke_controlplane_basic',
3649
+ 'cfke_controlplane_pro',
3650
+ 'cfke_controlplane_enterprise',
3651
+ 'cfke_connected_nodes_basic',
3652
+ 'cfke_connected_nodes_pro',
3653
+ 'cfke_connected_nodes_enterprise',
3654
+ 'cfcr_storage'
3655
+ ]
2470
3656
  },
2471
3657
  value: {
2472
3658
  type: 'number',
@@ -2514,12 +3700,21 @@ export const UsageResponseSchema = {
2514
3700
  product: {
2515
3701
  type: 'array',
2516
3702
  items: {
2517
- type: 'string'
3703
+ type: 'string',
3704
+ enum: [
3705
+ 'cfke_controlplane_basic',
3706
+ 'cfke_controlplane_pro',
3707
+ 'cfke_controlplane_enterprise',
3708
+ 'cfke_connected_nodes_basic',
3709
+ 'cfke_connected_nodes_pro',
3710
+ 'cfke_connected_nodes_enterprise',
3711
+ 'cfcr_storage'
3712
+ ]
2518
3713
  },
2519
3714
  description: 'List of unique products',
2520
3715
  example: [
2521
- 'cfke_controlplane',
2522
- 'cfke_connected_nodes'
3716
+ 'cfke_controlplane_pro',
3717
+ 'cfke_connected_nodes_pro'
2523
3718
  ]
2524
3719
  }
2525
3720
  },
@@ -2549,7 +3744,16 @@ export const UsageSchema = {
2549
3744
  product: {
2550
3745
  type: 'string',
2551
3746
  description: 'The product the usage is associated with',
2552
- example: 'cfke_controlplane'
3747
+ example: 'cfke_controlplane_pro',
3748
+ enum: [
3749
+ 'cfke_controlplane_basic',
3750
+ 'cfke_controlplane_pro',
3751
+ 'cfke_controlplane_enterprise',
3752
+ 'cfke_connected_nodes_basic',
3753
+ 'cfke_connected_nodes_pro',
3754
+ 'cfke_connected_nodes_enterprise',
3755
+ 'cfcr_storage'
3756
+ ]
2553
3757
  },
2554
3758
  value: {
2555
3759
  type: 'number',
@@ -2612,24 +3816,6 @@ export const UserCreateInputSchema = {
2612
3816
  type: 'string',
2613
3817
  minLength: 8,
2614
3818
  description: 'User password. Must be at least 8 characters long.'
2615
- },
2616
- status: {
2617
- type: 'string',
2618
- description: 'Status of the user. Can be `active` or `inactive`. Inactive users cannot log in or manage organization resources.',
2619
- example: 'active',
2620
- enum: [
2621
- 'active',
2622
- 'inactive'
2623
- ]
2624
- },
2625
- role: {
2626
- type: 'string',
2627
- description: 'User role. Can be \'Administrator\', \'User\'.',
2628
- example: 'User',
2629
- enum: [
2630
- 'Administrator',
2631
- 'User'
2632
- ]
2633
3819
  }
2634
3820
  },
2635
3821
  required: [