@cloudfleet/sdk 0.0.1-cfddf24 → 0.0.1-d32b155

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,6 +621,11 @@ 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.',
@@ -578,6 +701,7 @@ export const ClusterJoinInformationSchema = {
578
701
  'certificate_authority',
579
702
  'endpoint',
580
703
  'cluster_dns',
704
+ 'pod_cidr',
581
705
  'auth_key',
582
706
  'bootstrap_token',
583
707
  'versions',
@@ -599,24 +723,123 @@ export const ClusterSchema = {
599
723
  tier: {
600
724
  type: 'string',
601
725
  description: 'Tier of the cluster.',
726
+ default: 'basic',
602
727
  example: 'pro',
603
728
  enum: [
604
729
  'basic',
605
- 'pro'
730
+ 'pro',
731
+ 'enterprise'
606
732
  ]
607
733
  },
608
- region: {
734
+ version_channel: {
735
+ type: 'string',
736
+ pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
737
+ description: 'Version of the kubernetes cluster.',
738
+ default: '1.x.x-cfke.x',
739
+ example: '1.x.x-cfke.x'
740
+ },
741
+ release_channel: {
609
742
  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',
743
+ description: 'Release channel for the cluster\'s control plane.',
744
+ default: 'rapid',
745
+ example: 'rapid',
613
746
  enum: [
614
- 'staging-1a',
615
- 'northamerica-central-1',
616
- 'europe-central-1a',
617
- 'northamerica-central-1a'
747
+ 'rapid',
748
+ 'stable',
749
+ 'extended'
618
750
  ]
619
751
  },
752
+ features: {
753
+ type: 'object',
754
+ properties: {
755
+ gpu_sharing_strategy: {
756
+ type: 'string',
757
+ description: 'GPU sharing strategy.',
758
+ default: 'none',
759
+ example: 'none',
760
+ enum: [
761
+ 'none',
762
+ 'mps',
763
+ 'time_slicing'
764
+ ]
765
+ },
766
+ gpu_max_shared_clients_per_gpu: {
767
+ type: 'integer',
768
+ minimum: 2,
769
+ maximum: 48,
770
+ description: 'Maximum number of pods that may share a single GPU.',
771
+ default: 4,
772
+ example: 10
773
+ },
774
+ cilium_socket_lb_host_namespace_only: {
775
+ type: 'boolean',
776
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
777
+ example: false
778
+ }
779
+ },
780
+ required: [
781
+ 'gpu_sharing_strategy',
782
+ 'gpu_max_shared_clients_per_gpu',
783
+ 'cilium_socket_lb_host_namespace_only'
784
+ ],
785
+ additionalProperties: false,
786
+ description: 'Cluster feature toggles.',
787
+ default: {
788
+ gpu_sharing_strategy: 'none',
789
+ gpu_max_shared_clients_per_gpu: 4,
790
+ cilium_socket_lb_host_namespace_only: false
791
+ }
792
+ },
793
+ region: {
794
+ type: 'string',
795
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
796
+ example: 'europe-central-1a'
797
+ },
798
+ networking: {
799
+ type: 'object',
800
+ properties: {
801
+ pod_cidr: {
802
+ type: 'string',
803
+ description: 'CIDR block for pod IPs.',
804
+ default: '10.244.0.0/16'
805
+ },
806
+ service_cidr: {
807
+ type: 'string',
808
+ description: 'CIDR block for service IPs.',
809
+ default: '10.96.0.0/12'
810
+ },
811
+ dual_stack: {
812
+ type: 'boolean',
813
+ description: 'Enable IPv4+IPv6 dual-stack networking.'
814
+ },
815
+ pod_cidr_v6: {
816
+ type: 'string',
817
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
818
+ default: '2001:db8:1:2::/48'
819
+ },
820
+ service_cidr_v6: {
821
+ type: 'string',
822
+ description: 'IPv6 service CIDR. Requires dual_stack.',
823
+ default: '2001:db8:1:1::/112'
824
+ }
825
+ },
826
+ required: [
827
+ 'pod_cidr',
828
+ 'service_cidr',
829
+ 'dual_stack',
830
+ 'pod_cidr_v6',
831
+ 'service_cidr_v6'
832
+ ],
833
+ additionalProperties: false,
834
+ description: 'Cluster networking configuration. Immutable after creation.',
835
+ default: {
836
+ pod_cidr: '10.244.0.0/16',
837
+ service_cidr: '10.96.0.0/12',
838
+ dual_stack: false,
839
+ pod_cidr_v6: '2001:db8:1:2::/48',
840
+ service_cidr_v6: '2001:db8:1:1::/112'
841
+ }
842
+ },
620
843
  id: {
621
844
  type: 'string',
622
845
  format: 'uuid',
@@ -625,16 +848,13 @@ export const ClusterSchema = {
625
848
  },
626
849
  status: {
627
850
  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',
851
+ description: 'Status of the cluster.',
852
+ example: 'deployed',
630
853
  enum: [
631
- 'active',
632
- 'disabled',
633
- 'deleted',
634
854
  'creating',
635
855
  'deployed',
636
- 'failed',
637
- 'updating'
856
+ 'updating',
857
+ 'disabled'
638
858
  ]
639
859
  },
640
860
  endpoint: {
@@ -642,8 +862,8 @@ export const ClusterSchema = {
642
862
  {
643
863
  type: 'string',
644
864
  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'
865
+ description: 'URL signed by a public CA of the Kubernetes cluster control plane. This is the endpoint that kubectl uses to connect to the cluster.',
866
+ example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
647
867
  },
648
868
  {
649
869
  type: 'string',
@@ -658,7 +878,7 @@ export const ClusterSchema = {
658
878
  {
659
879
  type: 'string',
660
880
  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.',
881
+ description: 'Deprecated alias of `endpoint`; retained for backward compatibility.',
662
882
  example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
663
883
  },
664
884
  {
@@ -693,21 +913,22 @@ export const ClusterSchema = {
693
913
  type: 'boolean',
694
914
  description: 'Indicates if the cluster is ready to be used.',
695
915
  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
916
  }
703
917
  },
704
918
  required: [
705
919
  'name',
706
920
  'tier',
921
+ 'version_channel',
922
+ 'release_channel',
923
+ 'features',
924
+ 'region',
925
+ 'networking',
707
926
  'id',
708
- 'status'
927
+ 'status',
928
+ 'ready'
709
929
  ],
710
- additionalProperties: false
930
+ additionalProperties: false,
931
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
711
932
  };
712
933
  export const ClusterUpdateInputSchema = {
713
934
  type: 'object',
@@ -723,23 +944,74 @@ export const ClusterUpdateInputSchema = {
723
944
  tier: {
724
945
  type: 'string',
725
946
  description: 'Tier of the cluster.',
947
+ default: 'basic',
726
948
  example: 'pro',
727
949
  enum: [
728
950
  'basic',
729
- 'pro'
951
+ 'pro',
952
+ 'enterprise'
730
953
  ]
731
954
  },
732
955
  version_channel: {
733
956
  type: 'string',
734
957
  pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
735
958
  description: 'Version of the kubernetes cluster.',
959
+ default: '1.x.x-cfke.x',
736
960
  example: '1.x.x-cfke.x'
961
+ },
962
+ release_channel: {
963
+ type: 'string',
964
+ description: 'Release channel for the cluster\'s control plane.',
965
+ default: 'rapid',
966
+ example: 'rapid',
967
+ enum: [
968
+ 'rapid',
969
+ 'stable',
970
+ 'extended'
971
+ ]
972
+ },
973
+ features: {
974
+ type: 'object',
975
+ properties: {
976
+ gpu_sharing_strategy: {
977
+ type: 'string',
978
+ description: 'GPU sharing strategy.',
979
+ default: 'none',
980
+ example: 'none',
981
+ enum: [
982
+ 'none',
983
+ 'mps',
984
+ 'time_slicing'
985
+ ]
986
+ },
987
+ gpu_max_shared_clients_per_gpu: {
988
+ type: 'integer',
989
+ minimum: 2,
990
+ maximum: 48,
991
+ description: 'Maximum number of pods that may share a single GPU.',
992
+ default: 4,
993
+ example: 10
994
+ },
995
+ cilium_socket_lb_host_namespace_only: {
996
+ type: 'boolean',
997
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
998
+ example: false
999
+ }
1000
+ },
1001
+ additionalProperties: false,
1002
+ description: 'Cluster feature toggles.',
1003
+ default: {
1004
+ gpu_sharing_strategy: 'none',
1005
+ gpu_max_shared_clients_per_gpu: 4,
1006
+ cilium_socket_lb_host_namespace_only: false
1007
+ }
737
1008
  }
738
1009
  },
739
1010
  required: [
740
- 'tier'
1011
+ 'name'
741
1012
  ],
742
- additionalProperties: false
1013
+ additionalProperties: false,
1014
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
743
1015
  };
744
1016
  export const FleetCreateInputSchema = {
745
1017
  type: 'object',
@@ -785,8 +1057,8 @@ export const FleetCreateInputSchema = {
785
1057
  type: 'string',
786
1058
  maxLength: 64,
787
1059
  minLength: 64,
788
- pattern: '^[A-Za-z0-9]+$',
789
- description: 'Hetzner Cloud API token with read / write access (64 alphanumeric characters). Omit this field to keep the existing value.'
1060
+ pattern: '^([A-Za-z0-9]{64}|\\*{64})$',
1061
+ description: 'Hetzner Cloud API token with read/write access (64 alphanumeric characters). Write-only: reads return a redacted placeholder, never the token. Omit the field, or send the placeholder back unchanged, to keep the existing key. Send a new value to rotate it.'
790
1062
  }
791
1063
  },
792
1064
  required: [
@@ -1011,7 +1283,8 @@ export const FleetCreateInputSchema = {
1011
1283
  'z3'
1012
1284
  ]
1013
1285
  },
1014
- description: 'Allowed values for `cfke.io/instance-family`.'
1286
+ description: 'Allowed values for `cfke.io/instance-family`.',
1287
+ default: []
1015
1288
  },
1016
1289
  'topology.kubernetes.io/region': {
1017
1290
  type: 'array',
@@ -1084,15 +1357,27 @@ export const FleetCreateInputSchema = {
1084
1357
  'us-west4'
1085
1358
  ]
1086
1359
  },
1087
- description: 'Allowed values for `topology.kubernetes.io/region`.'
1360
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
1361
+ default: []
1088
1362
  }
1089
1363
  },
1090
1364
  additionalProperties: false,
1091
- 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. Omit a field to place no restriction on that key.'
1365
+ description: 'Constraints define scheduling and provisioning requirements for the fleet. Each field restricts the values allowed for a given Kubernetes label key. Multiple constraints are ANDed together.',
1366
+ default: {
1367
+ 'karpenter.sh/capacity-type': [
1368
+ 'on-demand',
1369
+ 'spot'
1370
+ ],
1371
+ 'kubernetes.io/arch': [
1372
+ 'amd64'
1373
+ ],
1374
+ 'cfke.io/instance-family': [],
1375
+ 'topology.kubernetes.io/region': []
1376
+ }
1092
1377
  },
1093
1378
  scalingProfile: {
1094
1379
  type: 'string',
1095
- description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
1380
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet. Full-overwrite: omit to reset to the default (`conservative`).',
1096
1381
  default: 'conservative',
1097
1382
  example: 'conservative',
1098
1383
  enum: [
@@ -1112,7 +1397,8 @@ export const FleetCreateInputSchema = {
1112
1397
  required: [
1113
1398
  'id'
1114
1399
  ],
1115
- additionalProperties: false
1400
+ additionalProperties: false,
1401
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
1116
1402
  };
1117
1403
  export const FleetSchema = {
1118
1404
  type: 'object',
@@ -1382,7 +1668,8 @@ export const FleetSchema = {
1382
1668
  'z3'
1383
1669
  ]
1384
1670
  },
1385
- description: 'Allowed values for `cfke.io/instance-family`.'
1671
+ description: 'Allowed values for `cfke.io/instance-family`.',
1672
+ default: []
1386
1673
  },
1387
1674
  'topology.kubernetes.io/region': {
1388
1675
  type: 'array',
@@ -1455,15 +1742,31 @@ export const FleetSchema = {
1455
1742
  'us-west4'
1456
1743
  ]
1457
1744
  },
1458
- description: 'Allowed values for `topology.kubernetes.io/region`.'
1745
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
1746
+ default: []
1459
1747
  }
1460
1748
  },
1749
+ required: [
1750
+ 'karpenter.sh/capacity-type',
1751
+ 'kubernetes.io/arch'
1752
+ ],
1461
1753
  additionalProperties: false,
1462
- 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. Omit a field to place no restriction on that key.'
1754
+ description: 'Constraints define scheduling and provisioning requirements for the fleet. Each field restricts the values allowed for a given Kubernetes label key. Multiple constraints are ANDed together.',
1755
+ default: {
1756
+ 'karpenter.sh/capacity-type': [
1757
+ 'on-demand',
1758
+ 'spot'
1759
+ ],
1760
+ 'kubernetes.io/arch': [
1761
+ 'amd64'
1762
+ ],
1763
+ 'cfke.io/instance-family': [],
1764
+ 'topology.kubernetes.io/region': []
1765
+ }
1463
1766
  },
1464
1767
  scalingProfile: {
1465
1768
  type: 'string',
1466
- description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
1769
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet. Full-overwrite: omit to reset to the default (`conservative`).',
1467
1770
  default: 'conservative',
1468
1771
  example: 'conservative',
1469
1772
  enum: [
@@ -1478,13 +1781,38 @@ export const FleetSchema = {
1478
1781
  pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
1479
1782
  description: 'Unique identifier of the kubernetes fleet.',
1480
1783
  example: 'new-clouds-fleet'
1784
+ },
1785
+ ready: {
1786
+ type: 'boolean',
1787
+ description: 'Indicates whether the fleet configuration is healthy.',
1788
+ example: true
1789
+ },
1790
+ status_message: {
1791
+ type: 'string',
1792
+ description: 'Human-readable reason the fleet is not ready. Present only when `ready` is false.',
1793
+ example: 'Invalid provider permissions.'
1794
+ },
1795
+ created_at: {
1796
+ type: 'string',
1797
+ description: 'Creation date and time of the fleet.',
1798
+ example: '2024-09-12T09:11:27Z'
1799
+ },
1800
+ updated_at: {
1801
+ type: 'string',
1802
+ description: 'Date and time the fleet was last updated.',
1803
+ example: '2024-09-12T09:11:27Z'
1481
1804
  }
1482
1805
  },
1483
1806
  required: [
1807
+ 'constraints',
1484
1808
  'scalingProfile',
1485
- 'id'
1809
+ 'id',
1810
+ 'ready',
1811
+ 'created_at',
1812
+ 'updated_at'
1486
1813
  ],
1487
- additionalProperties: false
1814
+ additionalProperties: false,
1815
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
1488
1816
  };
1489
1817
  export const FleetUpdateInputSchema = {
1490
1818
  type: 'object',
@@ -1530,8 +1858,8 @@ export const FleetUpdateInputSchema = {
1530
1858
  type: 'string',
1531
1859
  maxLength: 64,
1532
1860
  minLength: 64,
1533
- pattern: '^[A-Za-z0-9]+$',
1534
- description: 'Hetzner Cloud API token with read / write access (64 alphanumeric characters). Omit this field to keep the existing value.'
1861
+ pattern: '^([A-Za-z0-9]{64}|\\*{64})$',
1862
+ description: 'Hetzner Cloud API token with read/write access (64 alphanumeric characters). Write-only: reads return a redacted placeholder, never the token. Omit the field, or send the placeholder back unchanged, to keep the existing key. Send a new value to rotate it.'
1535
1863
  }
1536
1864
  },
1537
1865
  required: [
@@ -1570,7 +1898,11 @@ export const FleetUpdateInputSchema = {
1570
1898
  ]
1571
1899
  },
1572
1900
  minItems: 1,
1573
- description: 'Allowed values for `karpenter.sh/capacity-type`.'
1901
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1902
+ default: [
1903
+ 'on-demand',
1904
+ 'spot'
1905
+ ]
1574
1906
  },
1575
1907
  'kubernetes.io/arch': {
1576
1908
  type: 'array',
@@ -1582,7 +1914,10 @@ export const FleetUpdateInputSchema = {
1582
1914
  ]
1583
1915
  },
1584
1916
  minItems: 1,
1585
- description: 'Allowed values for `kubernetes.io/arch`.'
1917
+ description: 'Allowed values for `kubernetes.io/arch`.',
1918
+ default: [
1919
+ 'amd64'
1920
+ ]
1586
1921
  },
1587
1922
  'cfke.io/instance-family': {
1588
1923
  type: 'array',
@@ -1749,7 +2084,8 @@ export const FleetUpdateInputSchema = {
1749
2084
  'z3'
1750
2085
  ]
1751
2086
  },
1752
- description: 'Allowed values for `cfke.io/instance-family`.'
2087
+ description: 'Allowed values for `cfke.io/instance-family`.',
2088
+ default: []
1753
2089
  },
1754
2090
  'topology.kubernetes.io/region': {
1755
2091
  type: 'array',
@@ -1822,15 +2158,28 @@ export const FleetUpdateInputSchema = {
1822
2158
  'us-west4'
1823
2159
  ]
1824
2160
  },
1825
- description: 'Allowed values for `topology.kubernetes.io/region`.'
2161
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
2162
+ default: []
1826
2163
  }
1827
2164
  },
1828
2165
  additionalProperties: false,
1829
- 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. Omit a field to place no restriction on that key.'
2166
+ description: 'Constraints define scheduling and provisioning requirements for the fleet. Each field restricts the values allowed for a given Kubernetes label key. Multiple constraints are ANDed together.',
2167
+ default: {
2168
+ 'karpenter.sh/capacity-type': [
2169
+ 'on-demand',
2170
+ 'spot'
2171
+ ],
2172
+ 'kubernetes.io/arch': [
2173
+ 'amd64'
2174
+ ],
2175
+ 'cfke.io/instance-family': [],
2176
+ 'topology.kubernetes.io/region': []
2177
+ }
1830
2178
  },
1831
2179
  scalingProfile: {
1832
2180
  type: 'string',
1833
- description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
2181
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet. Full-overwrite: omit to reset to the default (`conservative`).',
2182
+ default: 'conservative',
1834
2183
  example: 'conservative',
1835
2184
  enum: [
1836
2185
  'aggressive',
@@ -1838,8 +2187,31 @@ export const FleetUpdateInputSchema = {
1838
2187
  ]
1839
2188
  }
1840
2189
  },
2190
+ additionalProperties: false,
2191
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
2192
+ };
2193
+ export const InviteCreateInputSchema = {
2194
+ type: 'object',
2195
+ properties: {
2196
+ email: {
2197
+ type: 'string',
2198
+ format: 'email',
2199
+ description: 'Email address of the user to invite.',
2200
+ example: 'email@example.com'
2201
+ },
2202
+ role: {
2203
+ type: 'string',
2204
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2205
+ default: 'User',
2206
+ example: 'User',
2207
+ enum: [
2208
+ 'Administrator',
2209
+ 'User'
2210
+ ]
2211
+ }
2212
+ },
1841
2213
  required: [
1842
- 'scalingProfile'
2214
+ 'email'
1843
2215
  ],
1844
2216
  additionalProperties: false
1845
2217
  };
@@ -1873,6 +2245,16 @@ export const InviteSchema = {
1873
2245
  type: 'string',
1874
2246
  description: 'Generated unique invite code.',
1875
2247
  example: '7kUZnH7nnKUFfvc4NK2KQF'
2248
+ },
2249
+ role: {
2250
+ type: 'string',
2251
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2252
+ default: 'User',
2253
+ example: 'User',
2254
+ enum: [
2255
+ 'Administrator',
2256
+ 'User'
2257
+ ]
1876
2258
  }
1877
2259
  },
1878
2260
  required: [
@@ -2093,6 +2475,15 @@ export const MarketplaceListingSchema = {
2093
2475
  export const OrganizationCreateInputSchema = {
2094
2476
  type: 'object',
2095
2477
  properties: {
2478
+ type: {
2479
+ type: 'string',
2480
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2481
+ example: 'business',
2482
+ enum: [
2483
+ 'business',
2484
+ 'personal'
2485
+ ]
2486
+ },
2096
2487
  email: {
2097
2488
  type: 'string',
2098
2489
  format: 'email',
@@ -2101,11 +2492,13 @@ export const OrganizationCreateInputSchema = {
2101
2492
  },
2102
2493
  first_name: {
2103
2494
  type: 'string',
2495
+ minLength: 1,
2104
2496
  description: 'First name of the billing contact person.',
2105
2497
  example: 'John'
2106
2498
  },
2107
2499
  last_name: {
2108
2500
  type: 'string',
2501
+ minLength: 1,
2109
2502
  description: 'Last name of the billing contact person.',
2110
2503
  example: 'Doe'
2111
2504
  },
@@ -2124,6 +2517,7 @@ export const OrganizationCreateInputSchema = {
2124
2517
  }
2125
2518
  },
2126
2519
  required: [
2520
+ 'type',
2127
2521
  'email',
2128
2522
  'first_name',
2129
2523
  'last_name',
@@ -2132,6 +2526,20 @@ export const OrganizationCreateInputSchema = {
2132
2526
  ],
2133
2527
  additionalProperties: false
2134
2528
  };
2529
+ export const OrganizationCreateOutputSchema = {
2530
+ type: 'object',
2531
+ properties: {
2532
+ id: {
2533
+ type: 'string',
2534
+ description: 'Unique identifier of the newly created organization. Generated by the API and safe to use for client-side tracking immediately.',
2535
+ example: 'organization-id'
2536
+ }
2537
+ },
2538
+ required: [
2539
+ 'id'
2540
+ ],
2541
+ additionalProperties: false
2542
+ };
2135
2543
  export const OrganizationSchema = {
2136
2544
  type: 'object',
2137
2545
  properties: {
@@ -2148,6 +2556,15 @@ export const OrganizationSchema = {
2148
2556
  description: 'Name of the legal entity. This name will be used in invoices. Use your first and last name for individual accounts.',
2149
2557
  example: 'ACME Corp.'
2150
2558
  },
2559
+ type: {
2560
+ type: 'string',
2561
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2562
+ example: 'business',
2563
+ enum: [
2564
+ 'business',
2565
+ 'personal'
2566
+ ]
2567
+ },
2151
2568
  date_created: {
2152
2569
  type: 'string',
2153
2570
  format: 'date-time',
@@ -2179,6 +2596,17 @@ export const OrganizationSchema = {
2179
2596
  description: 'Available number of Pro clusters that can be created.',
2180
2597
  example: 999
2181
2598
  },
2599
+ enterprise_clusters_max: {
2600
+ type: 'integer',
2601
+ minimum: 0,
2602
+ description: 'Maximum number of Enterprise clusters that can be created.',
2603
+ example: 999
2604
+ },
2605
+ enterprise_clusters_available: {
2606
+ type: 'integer',
2607
+ description: 'Available number of Enterprise clusters that can be created.',
2608
+ example: 999
2609
+ },
2182
2610
  fleets_max: {
2183
2611
  type: 'integer',
2184
2612
  minimum: 0,
@@ -2198,7 +2626,7 @@ export const OrganizationSchema = {
2198
2626
  type: 'array',
2199
2627
  items: {
2200
2628
  type: 'string',
2201
- example: 'northamerica-central-1'
2629
+ example: 'northamerica-central-1a'
2202
2630
  },
2203
2631
  minItems: 1,
2204
2632
  description: 'List of Cloudfleet control plane regions available for the organization.'
@@ -2240,6 +2668,8 @@ export const OrganizationSchema = {
2240
2668
  'basic_clusters_available',
2241
2669
  'pro_clusters_max',
2242
2670
  'pro_clusters_available',
2671
+ 'enterprise_clusters_max',
2672
+ 'enterprise_clusters_available',
2243
2673
  'fleets_max',
2244
2674
  'cluster_tiers',
2245
2675
  'regions',
@@ -2257,13 +2687,25 @@ export const OrganizationSchema = {
2257
2687
  'closed',
2258
2688
  'suspended'
2259
2689
  ]
2690
+ },
2691
+ verification: {
2692
+ type: 'string',
2693
+ description: 'Verification status of the organization, which determines the assigned quota. `none` when billing information is incomplete, `submitted` when billing information is complete but the organization is not yet verified, `verified` when the organization is verified.',
2694
+ example: 'verified',
2695
+ enum: [
2696
+ 'none',
2697
+ 'submitted',
2698
+ 'verified'
2699
+ ]
2260
2700
  }
2261
2701
  },
2262
2702
  required: [
2263
2703
  'id',
2704
+ 'type',
2264
2705
  'date_created',
2265
2706
  'quota',
2266
- 'status'
2707
+ 'status',
2708
+ 'verification'
2267
2709
  ],
2268
2710
  additionalProperties: false
2269
2711
  };
@@ -2272,28 +2714,23 @@ export const PaymentMethodSchema = {
2272
2714
  properties: {
2273
2715
  id: {
2274
2716
  type: 'string',
2275
- format: 'uuid',
2276
- description: 'Unique identifier of the organization. UUID v4 string in canonical form.',
2277
- example: 'e94d30ec-a2dd-4dcb-832c-ac2be144ba91'
2278
- },
2279
- setup: {
2280
- type: 'boolean',
2281
- description: 'Whether organization payment method was set up and ready to use for payments.',
2282
- example: true
2717
+ description: 'Payment method identifier. Stripe payment method id for cards/SEPA; the constant `bank_transfer` for the invoice/bank-transfer method. Used to set as default or delete the payment method.',
2718
+ example: 'pm_1MtwBwLkdIwHu7ix28a3tqPa'
2283
2719
  },
2284
2720
  type: {
2285
2721
  type: 'string',
2286
- nullable: true,
2287
- description: 'Payment method type type. Only `card` payments supported at the moment.',
2722
+ description: 'Payment method type. `card`, `sepa_debit` for SEPA Direct Debit (business accounts only), or `bank_transfer` for paying invoices by bank transfer.',
2288
2723
  example: 'card',
2289
2724
  enum: [
2290
- 'card'
2725
+ 'card',
2726
+ 'sepa_debit',
2727
+ 'bank_transfer'
2291
2728
  ]
2292
2729
  },
2293
2730
  last4: {
2294
2731
  type: 'string',
2295
2732
  nullable: true,
2296
- description: 'Last 4 digits of the payment card number.',
2733
+ description: 'Last 4 digits of the payment card number, of the bank account (IBAN) for SEPA Direct Debit, or of the destination IBAN for bank transfer.',
2297
2734
  example: '4242'
2298
2735
  },
2299
2736
  exp_month: {
@@ -2301,42 +2738,56 @@ export const PaymentMethodSchema = {
2301
2738
  minimum: 1,
2302
2739
  maximum: 12,
2303
2740
  nullable: true,
2304
- description: 'Two-digit number representing the card\'s expiration month.',
2305
- example: '12'
2741
+ description: 'Two-digit number representing the card\'s expiration month. Null for SEPA Direct Debit and bank transfer.',
2742
+ example: 12
2306
2743
  },
2307
2744
  exp_year: {
2308
2745
  type: 'integer',
2309
- minimum: 2024,
2310
2746
  nullable: true,
2311
- description: 'Four-digit number representing the card\'s expiration year.',
2312
- example: '2028'
2747
+ description: 'Four-digit number representing the card\'s expiration year. May be in the past for an expired card still on file. Null for SEPA Direct Debit and bank transfer.',
2748
+ example: 2028
2313
2749
  },
2314
2750
  brand: {
2315
2751
  type: 'string',
2316
2752
  nullable: true,
2317
- description: 'Payment card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.',
2318
- example: 'visa',
2319
- enum: [
2320
- 'amex',
2321
- 'diners',
2322
- 'discover',
2323
- 'eftpos_au',
2324
- 'jcb',
2325
- 'mastercard',
2326
- 'unionpay',
2327
- 'visa',
2328
- 'unknown'
2329
- ]
2753
+ description: 'Payment card brand as reported by Stripe, e.g. `visa`, `mastercard`, `amex`, `cartes_bancaires`, or `unknown`. Null for SEPA Direct Debit and bank transfer.',
2754
+ example: 'visa'
2755
+ },
2756
+ iban: {
2757
+ type: 'string',
2758
+ nullable: true,
2759
+ description: 'Full destination IBAN to send bank transfers to. Set only for `bank_transfer`; null otherwise. This is Cloudfleet\'s virtual receiving account, shown in full so the customer can pay into it.',
2760
+ example: 'DE11243015658023127510'
2761
+ },
2762
+ bic: {
2763
+ type: 'string',
2764
+ nullable: true,
2765
+ description: 'BIC/SWIFT of the destination bank for bank transfers. Set only for `bank_transfer`; null otherwise.',
2766
+ example: 'SOGEDEFFXXX'
2767
+ },
2768
+ account_holder_name: {
2769
+ type: 'string',
2770
+ nullable: true,
2771
+ description: 'Account holder name of the destination bank account for bank transfers. Set only for `bank_transfer`; null otherwise.',
2772
+ example: 'Cloudfleet GmbH'
2773
+ },
2774
+ is_default: {
2775
+ type: 'boolean',
2776
+ description: 'Whether this payment method is the default used for invoices and active subscriptions. Always false for `bank_transfer` (it cannot be a Stripe default payment method).',
2777
+ example: true
2330
2778
  }
2331
2779
  },
2332
2780
  required: [
2333
2781
  'id',
2334
- 'setup',
2335
2782
  'type',
2336
2783
  'last4',
2337
2784
  'exp_month',
2338
2785
  'exp_year',
2339
- 'brand'
2786
+ 'brand',
2787
+ 'iban',
2788
+ 'bic',
2789
+ 'account_holder_name',
2790
+ 'is_default'
2340
2791
  ],
2341
2792
  additionalProperties: false
2342
2793
  };
@@ -2365,6 +2816,17 @@ export const PlatformQuotaSchema = {
2365
2816
  description: 'Available number of Pro clusters that can be created.',
2366
2817
  example: 999
2367
2818
  },
2819
+ enterprise_clusters_max: {
2820
+ type: 'integer',
2821
+ minimum: 0,
2822
+ description: 'Maximum number of Enterprise clusters that can be created.',
2823
+ example: 999
2824
+ },
2825
+ enterprise_clusters_available: {
2826
+ type: 'integer',
2827
+ description: 'Available number of Enterprise clusters that can be created.',
2828
+ example: 999
2829
+ },
2368
2830
  fleets_max: {
2369
2831
  type: 'integer',
2370
2832
  minimum: 0,
@@ -2384,7 +2846,7 @@ export const PlatformQuotaSchema = {
2384
2846
  type: 'array',
2385
2847
  items: {
2386
2848
  type: 'string',
2387
- example: 'northamerica-central-1'
2849
+ example: 'northamerica-central-1a'
2388
2850
  },
2389
2851
  minItems: 1,
2390
2852
  description: 'List of Cloudfleet control plane regions available for the organization.'
@@ -2426,6 +2888,8 @@ export const PlatformQuotaSchema = {
2426
2888
  'basic_clusters_available',
2427
2889
  'pro_clusters_max',
2428
2890
  'pro_clusters_available',
2891
+ 'enterprise_clusters_max',
2892
+ 'enterprise_clusters_available',
2429
2893
  'fleets_max',
2430
2894
  'cluster_tiers',
2431
2895
  'regions',
@@ -2768,172 +3232,6 @@ export const TicketCreateInputSchema = {
2768
3232
  ],
2769
3233
  additionalProperties: false
2770
3234
  };
2771
- export const TicketListResponseSchema = {
2772
- type: 'object',
2773
- properties: {
2774
- items: {
2775
- type: 'array',
2776
- items: {
2777
- type: 'object',
2778
- properties: {
2779
- id: {
2780
- type: 'string',
2781
- description: 'Unique identifier of the ticket (Mongo ObjectId).',
2782
- example: '60c72b2f9f1b2c001f8e4d3a'
2783
- },
2784
- status: {
2785
- type: 'string',
2786
- description: 'Current state of the ticket.',
2787
- example: 'waiting_on_us',
2788
- enum: [
2789
- 'waiting_on_us',
2790
- 'waiting_on_user',
2791
- 'closed'
2792
- ]
2793
- },
2794
- category: {
2795
- type: 'string',
2796
- description: 'Ticket category.',
2797
- example: 'technical',
2798
- enum: [
2799
- 'billing',
2800
- 'technical',
2801
- 'general'
2802
- ]
2803
- },
2804
- summary: {
2805
- type: 'string',
2806
- description: 'First 128 characters of the initial message body, with markdown formatting and newlines stripped. Used for ticket list previews.',
2807
- example: 'My cluster cannot reach the registry. Logs attached.'
2808
- },
2809
- closed_at: {
2810
- type: 'string',
2811
- format: 'date-time',
2812
- nullable: true,
2813
- description: 'Closure timestamp. Null while the ticket is open.',
2814
- example: '2026-05-18T16:08:14.338Z'
2815
- },
2816
- date_created: {
2817
- type: 'string',
2818
- format: 'date-time',
2819
- description: 'Creation date of the ticket. ISO 8601 UTC.',
2820
- example: '2026-05-11T16:08:14.338Z'
2821
- },
2822
- date_updated: {
2823
- type: 'string',
2824
- format: 'date-time',
2825
- description: 'Last update date of the ticket. ISO 8601 UTC.',
2826
- example: '2026-05-11T16:08:14.338Z'
2827
- },
2828
- messages: {
2829
- type: 'array',
2830
- items: {
2831
- type: 'object',
2832
- properties: {
2833
- id: {
2834
- type: 'string',
2835
- description: 'Unique identifier of the message (Mongo ObjectId).',
2836
- example: '60c72b2f9f1b2c001f8e4d3b'
2837
- },
2838
- type: {
2839
- type: 'string',
2840
- description: 'Message type. Internal notes are filtered out of customer-facing responses.',
2841
- example: 'customer_reply',
2842
- enum: [
2843
- 'customer_reply',
2844
- 'agent_reply'
2845
- ]
2846
- },
2847
- body: {
2848
- type: 'string',
2849
- description: 'Message body in markdown.',
2850
- example: 'Thanks — that resolved it on my side.'
2851
- },
2852
- author_first_name: {
2853
- type: 'string',
2854
- nullable: true,
2855
- description: 'First name of the author. Null when not provided.',
2856
- example: 'Jane'
2857
- },
2858
- author_last_name: {
2859
- type: 'string',
2860
- nullable: true,
2861
- description: 'Last name of the author. Null when not provided.',
2862
- example: 'Doe'
2863
- },
2864
- attachments: {
2865
- type: 'array',
2866
- items: {
2867
- type: 'object',
2868
- properties: {
2869
- id: {
2870
- type: 'string',
2871
- description: 'Unique identifier of the attachment (Mongo ObjectId).',
2872
- example: '60c72b2f9f1b2c001f8e4d3c'
2873
- },
2874
- filename: {
2875
- type: 'string',
2876
- description: 'Original filename as uploaded.',
2877
- example: 'debug.log'
2878
- },
2879
- content_type: {
2880
- type: 'string',
2881
- description: 'MIME content type of the attachment.',
2882
- example: 'text/plain'
2883
- },
2884
- size: {
2885
- type: 'integer',
2886
- description: 'Size of the attachment in bytes.',
2887
- example: 12345
2888
- }
2889
- },
2890
- required: [
2891
- 'id',
2892
- 'filename',
2893
- 'content_type',
2894
- 'size'
2895
- ],
2896
- additionalProperties: false
2897
- },
2898
- description: 'Attachments associated with this message.',
2899
- example: []
2900
- },
2901
- date_created: {
2902
- type: 'string',
2903
- format: 'date-time',
2904
- description: 'Creation date of the message. ISO 8601 UTC.',
2905
- example: '2026-05-11T16:08:14.338Z'
2906
- }
2907
- },
2908
- required: [
2909
- 'id',
2910
- 'type',
2911
- 'body',
2912
- 'date_created'
2913
- ],
2914
- additionalProperties: false
2915
- },
2916
- description: 'Messages on the ticket in chronological order. Internal notes are excluded. Returned by the detail endpoint only.'
2917
- }
2918
- },
2919
- required: [
2920
- 'id',
2921
- 'status',
2922
- 'category',
2923
- 'summary',
2924
- 'date_created',
2925
- 'date_updated'
2926
- ],
2927
- additionalProperties: false
2928
- },
2929
- description: 'Tickets for the organization, ordered newest first. Messages are omitted from list responses.'
2930
- }
2931
- },
2932
- required: [
2933
- 'items'
2934
- ],
2935
- additionalProperties: false
2936
- };
2937
3235
  export const TicketMessageInputSchema = {
2938
3236
  type: 'object',
2939
3237
  properties: {
@@ -2975,11 +3273,13 @@ export const TicketMessageSchema = {
2975
3273
  },
2976
3274
  author_first_name: {
2977
3275
  type: 'string',
3276
+ nullable: true,
2978
3277
  description: 'First name of the author. Null when not provided.',
2979
3278
  example: 'Jane'
2980
3279
  },
2981
3280
  author_last_name: {
2982
3281
  type: 'string',
3282
+ nullable: true,
2983
3283
  description: 'Last name of the author. Null when not provided.',
2984
3284
  example: 'Doe'
2985
3285
  },
@@ -3071,6 +3371,7 @@ export const TicketSchema = {
3071
3371
  closed_at: {
3072
3372
  type: 'string',
3073
3373
  format: 'date-time',
3374
+ nullable: true,
3074
3375
  description: 'Closure timestamp. Null while the ticket is open.',
3075
3376
  example: '2026-05-18T16:08:14.338Z'
3076
3377
  },
@@ -3295,12 +3596,21 @@ export const UsageFacetsSchema = {
3295
3596
  product: {
3296
3597
  type: 'array',
3297
3598
  items: {
3298
- type: 'string'
3599
+ type: 'string',
3600
+ enum: [
3601
+ 'cfke_controlplane_basic',
3602
+ 'cfke_controlplane_pro',
3603
+ 'cfke_controlplane_enterprise',
3604
+ 'cfke_connected_nodes_basic',
3605
+ 'cfke_connected_nodes_pro',
3606
+ 'cfke_connected_nodes_enterprise',
3607
+ 'cfcr_storage'
3608
+ ]
3299
3609
  },
3300
3610
  description: 'List of unique products',
3301
3611
  example: [
3302
- 'cfke_controlplane',
3303
- 'cfke_connected_nodes'
3612
+ 'cfke_controlplane_pro',
3613
+ 'cfke_connected_nodes_pro'
3304
3614
  ]
3305
3615
  }
3306
3616
  },
@@ -3327,7 +3637,16 @@ export const UsageResponseSchema = {
3327
3637
  product: {
3328
3638
  type: 'string',
3329
3639
  description: 'The product the usage is associated with',
3330
- example: 'cfke_controlplane'
3640
+ example: 'cfke_controlplane_pro',
3641
+ enum: [
3642
+ 'cfke_controlplane_basic',
3643
+ 'cfke_controlplane_pro',
3644
+ 'cfke_controlplane_enterprise',
3645
+ 'cfke_connected_nodes_basic',
3646
+ 'cfke_connected_nodes_pro',
3647
+ 'cfke_connected_nodes_enterprise',
3648
+ 'cfcr_storage'
3649
+ ]
3331
3650
  },
3332
3651
  value: {
3333
3652
  type: 'number',
@@ -3375,12 +3694,21 @@ export const UsageResponseSchema = {
3375
3694
  product: {
3376
3695
  type: 'array',
3377
3696
  items: {
3378
- type: 'string'
3697
+ type: 'string',
3698
+ enum: [
3699
+ 'cfke_controlplane_basic',
3700
+ 'cfke_controlplane_pro',
3701
+ 'cfke_controlplane_enterprise',
3702
+ 'cfke_connected_nodes_basic',
3703
+ 'cfke_connected_nodes_pro',
3704
+ 'cfke_connected_nodes_enterprise',
3705
+ 'cfcr_storage'
3706
+ ]
3379
3707
  },
3380
3708
  description: 'List of unique products',
3381
3709
  example: [
3382
- 'cfke_controlplane',
3383
- 'cfke_connected_nodes'
3710
+ 'cfke_controlplane_pro',
3711
+ 'cfke_connected_nodes_pro'
3384
3712
  ]
3385
3713
  }
3386
3714
  },
@@ -3410,7 +3738,16 @@ export const UsageSchema = {
3410
3738
  product: {
3411
3739
  type: 'string',
3412
3740
  description: 'The product the usage is associated with',
3413
- example: 'cfke_controlplane'
3741
+ example: 'cfke_controlplane_pro',
3742
+ enum: [
3743
+ 'cfke_controlplane_basic',
3744
+ 'cfke_controlplane_pro',
3745
+ 'cfke_controlplane_enterprise',
3746
+ 'cfke_connected_nodes_basic',
3747
+ 'cfke_connected_nodes_pro',
3748
+ 'cfke_connected_nodes_enterprise',
3749
+ 'cfcr_storage'
3750
+ ]
3414
3751
  },
3415
3752
  value: {
3416
3753
  type: 'number',
@@ -3473,24 +3810,6 @@ export const UserCreateInputSchema = {
3473
3810
  type: 'string',
3474
3811
  minLength: 8,
3475
3812
  description: 'User password. Must be at least 8 characters long.'
3476
- },
3477
- status: {
3478
- type: 'string',
3479
- description: 'Status of the user. Can be `active` or `inactive`. Inactive users cannot log in or manage organization resources.',
3480
- example: 'active',
3481
- enum: [
3482
- 'active',
3483
- 'inactive'
3484
- ]
3485
- },
3486
- role: {
3487
- type: 'string',
3488
- description: 'User role. Can be \'Administrator\', \'User\'.',
3489
- example: 'User',
3490
- enum: [
3491
- 'Administrator',
3492
- 'User'
3493
- ]
3494
3813
  }
3495
3814
  },
3496
3815
  required: [