@cloudfleet/sdk 0.0.1-e9ffb68 → 0.0.1-eb7ee45

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/README.md +26 -2
  2. package/dist/@tanstack/react-query.gen.d.ts +1149 -0
  3. package/dist/@tanstack/react-query.gen.d.ts.map +1 -0
  4. package/dist/@tanstack/react-query.gen.js +1165 -0
  5. package/dist/@tanstack/react-query.gen.js.map +1 -0
  6. package/dist/client/client.gen.d.ts.map +1 -1
  7. package/dist/client/client.gen.js +104 -123
  8. package/dist/client/client.gen.js.map +1 -1
  9. package/dist/client/types.gen.d.ts +6 -3
  10. package/dist/client/types.gen.d.ts.map +1 -1
  11. package/dist/client/utils.gen.d.ts +7 -3
  12. package/dist/client/utils.gen.d.ts.map +1 -1
  13. package/dist/client/utils.gen.js +3 -3
  14. package/dist/client/utils.gen.js.map +1 -1
  15. package/dist/core/params.gen.js +4 -4
  16. package/dist/core/params.gen.js.map +1 -1
  17. package/dist/core/serverSentEvents.gen.d.ts +1 -1
  18. package/dist/core/serverSentEvents.gen.d.ts.map +1 -1
  19. package/dist/core/serverSentEvents.gen.js +3 -4
  20. package/dist/core/serverSentEvents.gen.js.map +1 -1
  21. package/dist/schemas.gen.d.ts +916 -97
  22. package/dist/schemas.gen.d.ts.map +1 -1
  23. package/dist/schemas.gen.js +1821 -184
  24. package/dist/schemas.gen.js.map +1 -1
  25. package/dist/sdk.gen.d.ts +240 -197
  26. package/dist/sdk.gen.d.ts.map +1 -1
  27. package/dist/sdk.gen.js +348 -274
  28. package/dist/sdk.gen.js.map +1 -1
  29. package/dist/services/kubernetes/api.d.ts +8 -8
  30. package/dist/types.gen.d.ts +1523 -804
  31. package/dist/types.gen.d.ts.map +1 -1
  32. package/dist/zod.gen.d.ts +3257 -1141
  33. package/dist/zod.gen.d.ts.map +1 -1
  34. package/dist/zod.gen.js +1179 -285
  35. package/dist/zod.gen.js.map +1 -1
  36. package/package.json +27 -11
@@ -2,6 +2,15 @@
2
2
  export const BillingContactSchema = {
3
3
  type: 'object',
4
4
  properties: {
5
+ type: {
6
+ type: 'string',
7
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
8
+ example: 'business',
9
+ enum: [
10
+ 'business',
11
+ 'personal'
12
+ ]
13
+ },
5
14
  company: {
6
15
  type: 'string',
7
16
  maxLength: 120,
@@ -207,6 +216,7 @@ export const BillingContactSchema = {
207
216
  }
208
217
  },
209
218
  required: [
219
+ 'type',
210
220
  'email',
211
221
  'individual_name'
212
222
  ],
@@ -358,24 +368,8 @@ export const ChartSchema = {
358
368
  },
359
369
  status: {
360
370
  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
- ]
371
+ description: 'Status of the chart deployment (Flux HelmRelease Ready condition reason, e.g. InstallSucceeded, UpgradeFailed, Progressing).',
372
+ example: 'InstallSucceeded'
379
373
  },
380
374
  version_current: {
381
375
  type: 'string',
@@ -454,33 +448,102 @@ export const ClusterCreateInputSchema = {
454
448
  },
455
449
  region: {
456
450
  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'
465
- ]
451
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
452
+ example: 'europe-central-1a'
466
453
  },
467
454
  version_channel: {
468
455
  type: 'string',
469
456
  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
457
  description: 'Version of the kubernetes cluster.',
471
458
  default: '1.x.x-cfke.x',
472
- example: '1.x.x-cfke.x',
459
+ example: '1.x.x-cfke.x'
460
+ },
461
+ release_channel: {
462
+ type: 'string',
463
+ description: 'Release channel for the cluster\'s control plane.',
464
+ default: 'rapid',
465
+ example: 'rapid',
473
466
  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'
467
+ 'rapid',
468
+ 'stable',
469
+ 'extended'
478
470
  ]
471
+ },
472
+ features: {
473
+ type: 'object',
474
+ properties: {
475
+ gpu_sharing_strategy: {
476
+ type: 'string',
477
+ description: 'GPU sharing strategy.',
478
+ example: 'none',
479
+ enum: [
480
+ 'none',
481
+ 'mps',
482
+ 'time_slicing'
483
+ ]
484
+ },
485
+ gpu_max_shared_clients_per_gpu: {
486
+ type: 'integer',
487
+ minimum: 1,
488
+ maximum: 48,
489
+ description: 'Maximum number of pods that may share a single GPU.',
490
+ example: 10
491
+ },
492
+ cilium_socket_lb_host_namespace_only: {
493
+ type: 'boolean',
494
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
495
+ example: false
496
+ }
497
+ },
498
+ required: [
499
+ 'gpu_sharing_strategy',
500
+ 'gpu_max_shared_clients_per_gpu'
501
+ ],
502
+ additionalProperties: false,
503
+ description: 'Cluster feature toggles.',
504
+ default: {
505
+ gpu_sharing_strategy: 'none',
506
+ gpu_max_shared_clients_per_gpu: 10,
507
+ cilium_socket_lb_host_namespace_only: false
508
+ }
509
+ },
510
+ networking: {
511
+ type: 'object',
512
+ properties: {
513
+ pod_cidr: {
514
+ type: 'string',
515
+ description: 'CIDR block for pod IPs.',
516
+ example: '10.244.0.0/16'
517
+ },
518
+ service_cidr: {
519
+ type: 'string',
520
+ description: 'CIDR block for service IPs.',
521
+ example: '10.96.0.0/12'
522
+ },
523
+ dual_stack: {
524
+ type: 'boolean',
525
+ description: 'Enable IPv4+IPv6 dual-stack networking.',
526
+ example: false
527
+ },
528
+ pod_cidr_v6: {
529
+ type: 'string',
530
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
531
+ example: 'fd00:10:244::/56'
532
+ },
533
+ service_cidr_v6: {
534
+ type: 'string',
535
+ description: 'IPv6 service CIDR. Requires dual_stack.',
536
+ example: 'fd00:10:96::/112'
537
+ }
538
+ },
539
+ additionalProperties: false,
540
+ description: 'Cluster networking configuration. Immutable after creation.'
479
541
  }
480
542
  },
481
543
  required: [
482
544
  'name',
483
- 'tier'
545
+ 'tier',
546
+ 'region'
484
547
  ],
485
548
  additionalProperties: false
486
549
  };
@@ -503,6 +566,11 @@ export const ClusterJoinInformationSchema = {
503
566
  description: 'Cluster DNS IP address. This is the IP address of the kube-dns service in the cluster.',
504
567
  example: '10.96.0.10'
505
568
  },
569
+ pod_cidr: {
570
+ type: 'string',
571
+ description: 'Pod CIDR for the cluster. Used to configure iptables rules on nodes to prevent Tailscale routing loops.',
572
+ example: '10.244.0.0/16'
573
+ },
506
574
  auth_key: {
507
575
  type: 'string',
508
576
  description: 'Authentication key for the cluster.',
@@ -578,6 +646,7 @@ export const ClusterJoinInformationSchema = {
578
646
  'certificate_authority',
579
647
  'endpoint',
580
648
  'cluster_dns',
649
+ 'pod_cidr',
581
650
  'auth_key',
582
651
  'bootstrap_token',
583
652
  'versions',
@@ -607,16 +676,84 @@ export const ClusterSchema = {
607
676
  },
608
677
  region: {
609
678
  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',
679
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
680
+ example: 'europe-central-1a'
681
+ },
682
+ networking: {
683
+ type: 'object',
684
+ properties: {
685
+ pod_cidr: {
686
+ type: 'string',
687
+ description: 'CIDR block for pod IPs.',
688
+ example: '10.244.0.0/16'
689
+ },
690
+ service_cidr: {
691
+ type: 'string',
692
+ description: 'CIDR block for service IPs.',
693
+ example: '10.96.0.0/12'
694
+ },
695
+ dual_stack: {
696
+ type: 'boolean',
697
+ description: 'Enable IPv4+IPv6 dual-stack networking.',
698
+ example: false
699
+ },
700
+ pod_cidr_v6: {
701
+ type: 'string',
702
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
703
+ example: 'fd00:10:244::/56'
704
+ },
705
+ service_cidr_v6: {
706
+ type: 'string',
707
+ description: 'IPv6 service CIDR. Requires dual_stack.',
708
+ example: 'fd00:10:96::/112'
709
+ }
710
+ },
711
+ additionalProperties: false,
712
+ description: 'Cluster networking configuration. Immutable after creation.'
713
+ },
714
+ release_channel: {
715
+ type: 'string',
716
+ description: 'Release channel for the cluster\'s control plane.',
717
+ example: 'rapid',
613
718
  enum: [
614
- 'staging-1a',
615
- 'northamerica-central-1',
616
- 'europe-central-1a',
617
- 'northamerica-central-1a'
719
+ 'rapid',
720
+ 'stable',
721
+ 'extended'
618
722
  ]
619
723
  },
724
+ features: {
725
+ type: 'object',
726
+ properties: {
727
+ gpu_sharing_strategy: {
728
+ type: 'string',
729
+ description: 'GPU sharing strategy.',
730
+ example: 'none',
731
+ enum: [
732
+ 'none',
733
+ 'mps',
734
+ 'time_slicing'
735
+ ]
736
+ },
737
+ gpu_max_shared_clients_per_gpu: {
738
+ type: 'integer',
739
+ minimum: 1,
740
+ maximum: 48,
741
+ description: 'Maximum number of pods that may share a single GPU.',
742
+ example: 10
743
+ },
744
+ cilium_socket_lb_host_namespace_only: {
745
+ type: 'boolean',
746
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
747
+ example: false
748
+ }
749
+ },
750
+ required: [
751
+ 'gpu_sharing_strategy',
752
+ 'gpu_max_shared_clients_per_gpu'
753
+ ],
754
+ additionalProperties: false,
755
+ description: 'Cluster feature toggles.'
756
+ },
620
757
  id: {
621
758
  type: 'string',
622
759
  format: 'uuid',
@@ -625,16 +762,13 @@ export const ClusterSchema = {
625
762
  },
626
763
  status: {
627
764
  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',
765
+ description: 'Status of the cluster.',
766
+ example: 'deployed',
630
767
  enum: [
631
- 'active',
632
- 'disabled',
633
- 'deleted',
634
768
  'creating',
635
769
  'deployed',
636
- 'failed',
637
- 'updating'
770
+ 'updating',
771
+ 'disabled'
638
772
  ]
639
773
  },
640
774
  endpoint: {
@@ -642,8 +776,24 @@ export const ClusterSchema = {
642
776
  {
643
777
  type: 'string',
644
778
  format: 'uri',
645
- description: 'URL of the Kubernetes cluster control plane. This is the endpoint that kubectl uses to connect to the cluster.',
646
- example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.cloudfleet.dev:6443'
779
+ 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.',
780
+ example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
781
+ },
782
+ {
783
+ type: 'string',
784
+ enum: [
785
+ ''
786
+ ]
787
+ }
788
+ ]
789
+ },
790
+ endpoint_public: {
791
+ anyOf: [
792
+ {
793
+ type: 'string',
794
+ format: 'uri',
795
+ description: 'Deprecated alias of `endpoint`; retained for backward compatibility.',
796
+ example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
647
797
  },
648
798
  {
649
799
  type: 'string',
@@ -688,6 +838,7 @@ export const ClusterSchema = {
688
838
  required: [
689
839
  'name',
690
840
  'tier',
841
+ 'region',
691
842
  'id',
692
843
  'status'
693
844
  ],
@@ -718,6 +869,49 @@ export const ClusterUpdateInputSchema = {
718
869
  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-]+)*))?$',
719
870
  description: 'Version of the kubernetes cluster.',
720
871
  example: '1.x.x-cfke.x'
872
+ },
873
+ release_channel: {
874
+ type: 'string',
875
+ description: 'Release channel for the cluster\'s control plane.',
876
+ example: 'rapid',
877
+ enum: [
878
+ 'rapid',
879
+ 'stable',
880
+ 'extended'
881
+ ]
882
+ },
883
+ features: {
884
+ type: 'object',
885
+ properties: {
886
+ gpu_sharing_strategy: {
887
+ type: 'string',
888
+ description: 'GPU sharing strategy.',
889
+ example: 'none',
890
+ enum: [
891
+ 'none',
892
+ 'mps',
893
+ 'time_slicing'
894
+ ]
895
+ },
896
+ gpu_max_shared_clients_per_gpu: {
897
+ type: 'integer',
898
+ minimum: 1,
899
+ maximum: 48,
900
+ description: 'Maximum number of pods that may share a single GPU.',
901
+ example: 10
902
+ },
903
+ cilium_socket_lb_host_namespace_only: {
904
+ type: 'boolean',
905
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
906
+ example: false
907
+ }
908
+ },
909
+ required: [
910
+ 'gpu_sharing_strategy',
911
+ 'gpu_max_shared_clients_per_gpu'
912
+ ],
913
+ additionalProperties: false,
914
+ description: 'Cluster feature toggles.'
721
915
  }
722
916
  },
723
917
  required: [
@@ -732,15 +926,12 @@ export const FleetCreateInputSchema = {
732
926
  type: 'object',
733
927
  properties: {
734
928
  cpu: {
735
- type: 'number',
736
- format: 'float',
929
+ type: 'integer',
737
930
  minimum: 0,
738
- description: 'CPU limit in cores.'
931
+ maximum: 100000,
932
+ description: 'CPU limit in cores. Maximum 100,000.'
739
933
  }
740
934
  },
741
- required: [
742
- 'cpu'
743
- ],
744
935
  additionalProperties: false,
745
936
  description: 'Limits define a set of bounds for provisioning capacity.'
746
937
  },
@@ -748,16 +939,17 @@ export const FleetCreateInputSchema = {
748
939
  type: 'object',
749
940
  properties: {
750
941
  enabled: {
751
- type: 'boolean',
752
- default: true
942
+ type: 'boolean'
753
943
  },
754
944
  project: {
755
945
  type: 'string',
756
- description: 'Project GCP Project id to deploy instances into'
946
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
947
+ 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.',
948
+ example: 'my-cloudfleet-project'
757
949
  }
758
950
  },
759
951
  required: [
760
- 'project'
952
+ 'enabled'
761
953
  ],
762
954
  additionalProperties: false
763
955
  },
@@ -765,16 +957,18 @@ export const FleetCreateInputSchema = {
765
957
  type: 'object',
766
958
  properties: {
767
959
  enabled: {
768
- type: 'boolean',
769
- default: true
960
+ type: 'boolean'
770
961
  },
771
962
  apiKey: {
772
963
  type: 'string',
773
- description: 'Hetzner Cloud API key with read / write access'
964
+ maxLength: 64,
965
+ minLength: 64,
966
+ pattern: '^[A-Za-z0-9]+$',
967
+ description: 'Hetzner Cloud API token with read / write access (64 alphanumeric characters). Omit this field to keep the existing value.'
774
968
  }
775
969
  },
776
970
  required: [
777
- 'apiKey'
971
+ 'enabled'
778
972
  ],
779
973
  additionalProperties: false
780
974
  },
@@ -782,19 +976,308 @@ export const FleetCreateInputSchema = {
782
976
  type: 'object',
783
977
  properties: {
784
978
  enabled: {
785
- type: 'boolean',
786
- default: true
979
+ type: 'boolean'
787
980
  },
788
981
  controllerRoleArn: {
789
982
  type: 'string',
790
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
983
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
984
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
985
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
791
986
  }
792
987
  },
793
988
  required: [
794
- 'controllerRoleArn'
989
+ 'enabled'
795
990
  ],
796
991
  additionalProperties: false
797
992
  },
993
+ constraints: {
994
+ type: 'object',
995
+ properties: {
996
+ 'karpenter.sh/capacity-type': {
997
+ type: 'array',
998
+ items: {
999
+ type: 'string',
1000
+ enum: [
1001
+ 'on-demand',
1002
+ 'spot'
1003
+ ]
1004
+ },
1005
+ minItems: 1,
1006
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1007
+ default: [
1008
+ 'on-demand',
1009
+ 'spot'
1010
+ ]
1011
+ },
1012
+ 'kubernetes.io/arch': {
1013
+ type: 'array',
1014
+ items: {
1015
+ type: 'string',
1016
+ enum: [
1017
+ 'amd64',
1018
+ 'arm64'
1019
+ ]
1020
+ },
1021
+ minItems: 1,
1022
+ description: 'Allowed values for `kubernetes.io/arch`.',
1023
+ default: [
1024
+ 'amd64'
1025
+ ]
1026
+ },
1027
+ 'cfke.io/instance-family': {
1028
+ type: 'array',
1029
+ items: {
1030
+ type: 'string',
1031
+ enum: [
1032
+ 'a1',
1033
+ 'a2',
1034
+ 'a3',
1035
+ 'a4',
1036
+ 'c1',
1037
+ 'c2',
1038
+ 'c2d',
1039
+ 'c3',
1040
+ 'c3d',
1041
+ 'c4',
1042
+ 'c4a',
1043
+ 'c4d',
1044
+ 'c5',
1045
+ 'c5a',
1046
+ 'c5ad',
1047
+ 'c5d',
1048
+ 'c5n',
1049
+ 'c6a',
1050
+ 'c6g',
1051
+ 'c6gd',
1052
+ 'c6gn',
1053
+ 'c6i',
1054
+ 'c6id',
1055
+ 'c6in',
1056
+ 'c7a',
1057
+ 'c7g',
1058
+ 'c7gd',
1059
+ 'c7gn',
1060
+ 'c7i',
1061
+ 'c7i-flex',
1062
+ 'c8g',
1063
+ 'c8gd',
1064
+ 'cax',
1065
+ 'ccx',
1066
+ 'cpx',
1067
+ 'cx',
1068
+ 'd2',
1069
+ 'd3',
1070
+ 'd3en',
1071
+ 'dl1',
1072
+ 'dl2q',
1073
+ 'e2',
1074
+ 'f1',
1075
+ 'f2',
1076
+ 'g1',
1077
+ 'g2',
1078
+ 'g4ad',
1079
+ 'g4dn',
1080
+ 'g5',
1081
+ 'g5g',
1082
+ 'g6',
1083
+ 'g6e',
1084
+ 'gr6',
1085
+ 'h1',
1086
+ 'h3',
1087
+ 'hpc6a',
1088
+ 'hpc6id',
1089
+ 'hpc7a',
1090
+ 'hpc7g',
1091
+ 'i2',
1092
+ 'i3',
1093
+ 'i3en',
1094
+ 'i4g',
1095
+ 'i4i',
1096
+ 'i7i',
1097
+ 'i7ie',
1098
+ 'i8g',
1099
+ 'im4gn',
1100
+ 'inf1',
1101
+ 'inf2',
1102
+ 'is4gen',
1103
+ 'm1',
1104
+ 'm2',
1105
+ 'm3',
1106
+ 'm4',
1107
+ 'm5',
1108
+ 'm5a',
1109
+ 'm5ad',
1110
+ 'm5d',
1111
+ 'm5dn',
1112
+ 'm5n',
1113
+ 'm5zn',
1114
+ 'm6a',
1115
+ 'm6g',
1116
+ 'm6gd',
1117
+ 'm6i',
1118
+ 'm6id',
1119
+ 'm6idn',
1120
+ 'm6in',
1121
+ 'm7a',
1122
+ 'm7g',
1123
+ 'm7gd',
1124
+ 'm7i',
1125
+ 'm7i-flex',
1126
+ 'm8g',
1127
+ 'm8gd',
1128
+ 'n1',
1129
+ 'n2',
1130
+ 'n2d',
1131
+ 'n4',
1132
+ 'p3',
1133
+ 'p3dn',
1134
+ 'p4d',
1135
+ 'p4de',
1136
+ 'p5',
1137
+ 'p5e',
1138
+ 'p5en',
1139
+ 'p6-b200',
1140
+ 'r3',
1141
+ 'r4',
1142
+ 'r5',
1143
+ 'r5a',
1144
+ 'r5ad',
1145
+ 'r5b',
1146
+ 'r5d',
1147
+ 'r5dn',
1148
+ 'r5n',
1149
+ 'r6a',
1150
+ 'r6g',
1151
+ 'r6gd',
1152
+ 'r6i',
1153
+ 'r6id',
1154
+ 'r6idn',
1155
+ 'r6in',
1156
+ 'r7a',
1157
+ 'r7g',
1158
+ 'r7gd',
1159
+ 'r7i',
1160
+ 'r7iz',
1161
+ 'r8g',
1162
+ 'r8gd',
1163
+ 't2',
1164
+ 't2a',
1165
+ 't2d',
1166
+ 't3',
1167
+ 't3a',
1168
+ 't4g',
1169
+ 'trn1',
1170
+ 'trn1n',
1171
+ 'u-3tb1',
1172
+ 'u-6tb1',
1173
+ 'u7i-12tb',
1174
+ 'u7i-6tb',
1175
+ 'u7i-8tb',
1176
+ 'u7in-16tb',
1177
+ 'u7in-24tb',
1178
+ 'u7in-32tb',
1179
+ 'vt1',
1180
+ 'x1',
1181
+ 'x1e',
1182
+ 'x2gd',
1183
+ 'x2idn',
1184
+ 'x2iedn',
1185
+ 'x2iezn',
1186
+ 'x4',
1187
+ 'x8g',
1188
+ 'z1d',
1189
+ 'z3'
1190
+ ]
1191
+ },
1192
+ description: 'Allowed values for `cfke.io/instance-family`.'
1193
+ },
1194
+ 'topology.kubernetes.io/region': {
1195
+ type: 'array',
1196
+ items: {
1197
+ type: 'string',
1198
+ enum: [
1199
+ 'africa-south1',
1200
+ 'ap-northeast-1',
1201
+ 'ap-northeast-2',
1202
+ 'ap-northeast-3',
1203
+ 'ap-south-1',
1204
+ 'ap-southeast-1',
1205
+ 'ap-southeast-2',
1206
+ 'ash',
1207
+ 'asia-east1',
1208
+ 'asia-east2',
1209
+ 'asia-northeast1',
1210
+ 'asia-northeast2',
1211
+ 'asia-northeast3',
1212
+ 'asia-south1',
1213
+ 'asia-south2',
1214
+ 'asia-southeast1',
1215
+ 'asia-southeast2',
1216
+ 'australia-southeast1',
1217
+ 'australia-southeast2',
1218
+ 'ca-central-1',
1219
+ 'eu-central-1',
1220
+ 'eu-central-2',
1221
+ 'eu-north-1',
1222
+ 'eu-west-1',
1223
+ 'eu-west-2',
1224
+ 'eu-west-3',
1225
+ 'europe-central2',
1226
+ 'europe-north1',
1227
+ 'europe-southwest1',
1228
+ 'europe-west1',
1229
+ 'europe-west10',
1230
+ 'europe-west12',
1231
+ 'europe-west2',
1232
+ 'europe-west3',
1233
+ 'europe-west4',
1234
+ 'europe-west6',
1235
+ 'europe-west8',
1236
+ 'europe-west9',
1237
+ 'fsn1',
1238
+ 'hel1',
1239
+ 'hil',
1240
+ 'me-central1',
1241
+ 'me-central2',
1242
+ 'me-west1',
1243
+ 'nbg1',
1244
+ 'northamerica-northeast1',
1245
+ 'northamerica-northeast2',
1246
+ 'sa-east-1',
1247
+ 'sin',
1248
+ 'southamerica-east1',
1249
+ 'southamerica-west1',
1250
+ 'us-central1',
1251
+ 'us-east-1',
1252
+ 'us-east-2',
1253
+ 'us-east1',
1254
+ 'us-east4',
1255
+ 'us-east5',
1256
+ 'us-south1',
1257
+ 'us-west-1',
1258
+ 'us-west-2',
1259
+ 'us-west1',
1260
+ 'us-west2',
1261
+ 'us-west3',
1262
+ 'us-west4'
1263
+ ]
1264
+ },
1265
+ description: 'Allowed values for `topology.kubernetes.io/region`.'
1266
+ }
1267
+ },
1268
+ additionalProperties: false,
1269
+ 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.'
1270
+ },
1271
+ scalingProfile: {
1272
+ type: 'string',
1273
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
1274
+ default: 'conservative',
1275
+ example: 'conservative',
1276
+ enum: [
1277
+ 'aggressive',
1278
+ 'conservative'
1279
+ ]
1280
+ },
798
1281
  id: {
799
1282
  type: 'string',
800
1283
  maxLength: 63,
@@ -816,15 +1299,12 @@ export const FleetSchema = {
816
1299
  type: 'object',
817
1300
  properties: {
818
1301
  cpu: {
819
- type: 'number',
820
- format: 'float',
1302
+ type: 'integer',
821
1303
  minimum: 0,
822
- description: 'CPU limit in cores.'
1304
+ maximum: 100000,
1305
+ description: 'CPU limit in cores. Maximum 100,000.'
823
1306
  }
824
1307
  },
825
- required: [
826
- 'cpu'
827
- ],
828
1308
  additionalProperties: false,
829
1309
  description: 'Limits define a set of bounds for provisioning capacity.'
830
1310
  },
@@ -832,16 +1312,17 @@ export const FleetSchema = {
832
1312
  type: 'object',
833
1313
  properties: {
834
1314
  enabled: {
835
- type: 'boolean',
836
- default: true
1315
+ type: 'boolean'
837
1316
  },
838
1317
  project: {
839
1318
  type: 'string',
840
- description: 'Project GCP Project id to deploy instances into'
1319
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1320
+ 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.',
1321
+ example: 'my-cloudfleet-project'
841
1322
  }
842
1323
  },
843
1324
  required: [
844
- 'project'
1325
+ 'enabled'
845
1326
  ],
846
1327
  additionalProperties: false
847
1328
  },
@@ -849,16 +1330,16 @@ export const FleetSchema = {
849
1330
  type: 'object',
850
1331
  properties: {
851
1332
  enabled: {
852
- type: 'boolean',
853
- default: true
1333
+ type: 'boolean'
854
1334
  },
855
1335
  apiKey: {
856
1336
  type: 'string',
857
- description: 'Hetzner Cloud API key with read / write access'
1337
+ pattern: '^\\*{64}$',
1338
+ 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.'
858
1339
  }
859
1340
  },
860
1341
  required: [
861
- 'apiKey'
1342
+ 'enabled'
862
1343
  ],
863
1344
  additionalProperties: false
864
1345
  },
@@ -866,19 +1347,308 @@ export const FleetSchema = {
866
1347
  type: 'object',
867
1348
  properties: {
868
1349
  enabled: {
869
- type: 'boolean',
870
- default: true
1350
+ type: 'boolean'
871
1351
  },
872
1352
  controllerRoleArn: {
873
1353
  type: 'string',
874
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1354
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1355
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1356
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
875
1357
  }
876
1358
  },
877
1359
  required: [
878
- 'controllerRoleArn'
1360
+ 'enabled'
879
1361
  ],
880
1362
  additionalProperties: false
881
1363
  },
1364
+ constraints: {
1365
+ type: 'object',
1366
+ properties: {
1367
+ 'karpenter.sh/capacity-type': {
1368
+ type: 'array',
1369
+ items: {
1370
+ type: 'string',
1371
+ enum: [
1372
+ 'on-demand',
1373
+ 'spot'
1374
+ ]
1375
+ },
1376
+ minItems: 1,
1377
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1378
+ default: [
1379
+ 'on-demand',
1380
+ 'spot'
1381
+ ]
1382
+ },
1383
+ 'kubernetes.io/arch': {
1384
+ type: 'array',
1385
+ items: {
1386
+ type: 'string',
1387
+ enum: [
1388
+ 'amd64',
1389
+ 'arm64'
1390
+ ]
1391
+ },
1392
+ minItems: 1,
1393
+ description: 'Allowed values for `kubernetes.io/arch`.',
1394
+ default: [
1395
+ 'amd64'
1396
+ ]
1397
+ },
1398
+ 'cfke.io/instance-family': {
1399
+ type: 'array',
1400
+ items: {
1401
+ type: 'string',
1402
+ enum: [
1403
+ 'a1',
1404
+ 'a2',
1405
+ 'a3',
1406
+ 'a4',
1407
+ 'c1',
1408
+ 'c2',
1409
+ 'c2d',
1410
+ 'c3',
1411
+ 'c3d',
1412
+ 'c4',
1413
+ 'c4a',
1414
+ 'c4d',
1415
+ 'c5',
1416
+ 'c5a',
1417
+ 'c5ad',
1418
+ 'c5d',
1419
+ 'c5n',
1420
+ 'c6a',
1421
+ 'c6g',
1422
+ 'c6gd',
1423
+ 'c6gn',
1424
+ 'c6i',
1425
+ 'c6id',
1426
+ 'c6in',
1427
+ 'c7a',
1428
+ 'c7g',
1429
+ 'c7gd',
1430
+ 'c7gn',
1431
+ 'c7i',
1432
+ 'c7i-flex',
1433
+ 'c8g',
1434
+ 'c8gd',
1435
+ 'cax',
1436
+ 'ccx',
1437
+ 'cpx',
1438
+ 'cx',
1439
+ 'd2',
1440
+ 'd3',
1441
+ 'd3en',
1442
+ 'dl1',
1443
+ 'dl2q',
1444
+ 'e2',
1445
+ 'f1',
1446
+ 'f2',
1447
+ 'g1',
1448
+ 'g2',
1449
+ 'g4ad',
1450
+ 'g4dn',
1451
+ 'g5',
1452
+ 'g5g',
1453
+ 'g6',
1454
+ 'g6e',
1455
+ 'gr6',
1456
+ 'h1',
1457
+ 'h3',
1458
+ 'hpc6a',
1459
+ 'hpc6id',
1460
+ 'hpc7a',
1461
+ 'hpc7g',
1462
+ 'i2',
1463
+ 'i3',
1464
+ 'i3en',
1465
+ 'i4g',
1466
+ 'i4i',
1467
+ 'i7i',
1468
+ 'i7ie',
1469
+ 'i8g',
1470
+ 'im4gn',
1471
+ 'inf1',
1472
+ 'inf2',
1473
+ 'is4gen',
1474
+ 'm1',
1475
+ 'm2',
1476
+ 'm3',
1477
+ 'm4',
1478
+ 'm5',
1479
+ 'm5a',
1480
+ 'm5ad',
1481
+ 'm5d',
1482
+ 'm5dn',
1483
+ 'm5n',
1484
+ 'm5zn',
1485
+ 'm6a',
1486
+ 'm6g',
1487
+ 'm6gd',
1488
+ 'm6i',
1489
+ 'm6id',
1490
+ 'm6idn',
1491
+ 'm6in',
1492
+ 'm7a',
1493
+ 'm7g',
1494
+ 'm7gd',
1495
+ 'm7i',
1496
+ 'm7i-flex',
1497
+ 'm8g',
1498
+ 'm8gd',
1499
+ 'n1',
1500
+ 'n2',
1501
+ 'n2d',
1502
+ 'n4',
1503
+ 'p3',
1504
+ 'p3dn',
1505
+ 'p4d',
1506
+ 'p4de',
1507
+ 'p5',
1508
+ 'p5e',
1509
+ 'p5en',
1510
+ 'p6-b200',
1511
+ 'r3',
1512
+ 'r4',
1513
+ 'r5',
1514
+ 'r5a',
1515
+ 'r5ad',
1516
+ 'r5b',
1517
+ 'r5d',
1518
+ 'r5dn',
1519
+ 'r5n',
1520
+ 'r6a',
1521
+ 'r6g',
1522
+ 'r6gd',
1523
+ 'r6i',
1524
+ 'r6id',
1525
+ 'r6idn',
1526
+ 'r6in',
1527
+ 'r7a',
1528
+ 'r7g',
1529
+ 'r7gd',
1530
+ 'r7i',
1531
+ 'r7iz',
1532
+ 'r8g',
1533
+ 'r8gd',
1534
+ 't2',
1535
+ 't2a',
1536
+ 't2d',
1537
+ 't3',
1538
+ 't3a',
1539
+ 't4g',
1540
+ 'trn1',
1541
+ 'trn1n',
1542
+ 'u-3tb1',
1543
+ 'u-6tb1',
1544
+ 'u7i-12tb',
1545
+ 'u7i-6tb',
1546
+ 'u7i-8tb',
1547
+ 'u7in-16tb',
1548
+ 'u7in-24tb',
1549
+ 'u7in-32tb',
1550
+ 'vt1',
1551
+ 'x1',
1552
+ 'x1e',
1553
+ 'x2gd',
1554
+ 'x2idn',
1555
+ 'x2iedn',
1556
+ 'x2iezn',
1557
+ 'x4',
1558
+ 'x8g',
1559
+ 'z1d',
1560
+ 'z3'
1561
+ ]
1562
+ },
1563
+ description: 'Allowed values for `cfke.io/instance-family`.'
1564
+ },
1565
+ 'topology.kubernetes.io/region': {
1566
+ type: 'array',
1567
+ items: {
1568
+ type: 'string',
1569
+ enum: [
1570
+ 'africa-south1',
1571
+ 'ap-northeast-1',
1572
+ 'ap-northeast-2',
1573
+ 'ap-northeast-3',
1574
+ 'ap-south-1',
1575
+ 'ap-southeast-1',
1576
+ 'ap-southeast-2',
1577
+ 'ash',
1578
+ 'asia-east1',
1579
+ 'asia-east2',
1580
+ 'asia-northeast1',
1581
+ 'asia-northeast2',
1582
+ 'asia-northeast3',
1583
+ 'asia-south1',
1584
+ 'asia-south2',
1585
+ 'asia-southeast1',
1586
+ 'asia-southeast2',
1587
+ 'australia-southeast1',
1588
+ 'australia-southeast2',
1589
+ 'ca-central-1',
1590
+ 'eu-central-1',
1591
+ 'eu-central-2',
1592
+ 'eu-north-1',
1593
+ 'eu-west-1',
1594
+ 'eu-west-2',
1595
+ 'eu-west-3',
1596
+ 'europe-central2',
1597
+ 'europe-north1',
1598
+ 'europe-southwest1',
1599
+ 'europe-west1',
1600
+ 'europe-west10',
1601
+ 'europe-west12',
1602
+ 'europe-west2',
1603
+ 'europe-west3',
1604
+ 'europe-west4',
1605
+ 'europe-west6',
1606
+ 'europe-west8',
1607
+ 'europe-west9',
1608
+ 'fsn1',
1609
+ 'hel1',
1610
+ 'hil',
1611
+ 'me-central1',
1612
+ 'me-central2',
1613
+ 'me-west1',
1614
+ 'nbg1',
1615
+ 'northamerica-northeast1',
1616
+ 'northamerica-northeast2',
1617
+ 'sa-east-1',
1618
+ 'sin',
1619
+ 'southamerica-east1',
1620
+ 'southamerica-west1',
1621
+ 'us-central1',
1622
+ 'us-east-1',
1623
+ 'us-east-2',
1624
+ 'us-east1',
1625
+ 'us-east4',
1626
+ 'us-east5',
1627
+ 'us-south1',
1628
+ 'us-west-1',
1629
+ 'us-west-2',
1630
+ 'us-west1',
1631
+ 'us-west2',
1632
+ 'us-west3',
1633
+ 'us-west4'
1634
+ ]
1635
+ },
1636
+ description: 'Allowed values for `topology.kubernetes.io/region`.'
1637
+ }
1638
+ },
1639
+ additionalProperties: false,
1640
+ 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.'
1641
+ },
1642
+ scalingProfile: {
1643
+ type: 'string',
1644
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
1645
+ default: 'conservative',
1646
+ example: 'conservative',
1647
+ enum: [
1648
+ 'aggressive',
1649
+ 'conservative'
1650
+ ]
1651
+ },
882
1652
  id: {
883
1653
  type: 'string',
884
1654
  maxLength: 63,
@@ -886,10 +1656,34 @@ export const FleetSchema = {
886
1656
  pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
887
1657
  description: 'Unique identifier of the kubernetes fleet.',
888
1658
  example: 'new-clouds-fleet'
1659
+ },
1660
+ ready: {
1661
+ type: 'boolean',
1662
+ description: 'Indicates whether the fleet configuration is healthy.',
1663
+ example: true
1664
+ },
1665
+ status_message: {
1666
+ type: 'string',
1667
+ description: 'Human-readable reason the fleet is not ready. Present only when `ready` is false.',
1668
+ example: 'Invalid provider permissions.'
1669
+ },
1670
+ created_at: {
1671
+ type: 'string',
1672
+ description: 'Creation date and time of the fleet.',
1673
+ example: '2024-09-12T09:11:27Z'
1674
+ },
1675
+ updated_at: {
1676
+ type: 'string',
1677
+ description: 'Date and time the fleet was last updated.',
1678
+ example: '2024-09-12T09:11:27Z'
889
1679
  }
890
1680
  },
891
1681
  required: [
892
- 'id'
1682
+ 'scalingProfile',
1683
+ 'id',
1684
+ 'ready',
1685
+ 'created_at',
1686
+ 'updated_at'
893
1687
  ],
894
1688
  additionalProperties: false
895
1689
  };
@@ -900,15 +1694,12 @@ export const FleetUpdateInputSchema = {
900
1694
  type: 'object',
901
1695
  properties: {
902
1696
  cpu: {
903
- type: 'number',
904
- format: 'float',
1697
+ type: 'integer',
905
1698
  minimum: 0,
906
- description: 'CPU limit in cores.'
1699
+ maximum: 100000,
1700
+ description: 'CPU limit in cores. Maximum 100,000.'
907
1701
  }
908
1702
  },
909
- required: [
910
- 'cpu'
911
- ],
912
1703
  additionalProperties: false,
913
1704
  description: 'Limits define a set of bounds for provisioning capacity.'
914
1705
  },
@@ -916,16 +1707,17 @@ export const FleetUpdateInputSchema = {
916
1707
  type: 'object',
917
1708
  properties: {
918
1709
  enabled: {
919
- type: 'boolean',
920
- default: true
1710
+ type: 'boolean'
921
1711
  },
922
1712
  project: {
923
1713
  type: 'string',
924
- description: 'Project GCP Project id to deploy instances into'
1714
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1715
+ 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.',
1716
+ example: 'my-cloudfleet-project'
925
1717
  }
926
1718
  },
927
1719
  required: [
928
- 'project'
1720
+ 'enabled'
929
1721
  ],
930
1722
  additionalProperties: false
931
1723
  },
@@ -933,16 +1725,18 @@ export const FleetUpdateInputSchema = {
933
1725
  type: 'object',
934
1726
  properties: {
935
1727
  enabled: {
936
- type: 'boolean',
937
- default: true
1728
+ type: 'boolean'
938
1729
  },
939
1730
  apiKey: {
940
1731
  type: 'string',
941
- description: 'Hetzner Cloud API key with read / write access'
1732
+ maxLength: 64,
1733
+ minLength: 64,
1734
+ pattern: '^[A-Za-z0-9]+$',
1735
+ description: 'Hetzner Cloud API token with read / write access (64 alphanumeric characters). Omit this field to keep the existing value.'
942
1736
  }
943
1737
  },
944
1738
  required: [
945
- 'apiKey'
1739
+ 'enabled'
946
1740
  ],
947
1741
  additionalProperties: false
948
1742
  },
@@ -950,52 +1744,371 @@ export const FleetUpdateInputSchema = {
950
1744
  type: 'object',
951
1745
  properties: {
952
1746
  enabled: {
953
- type: 'boolean',
954
- default: true
1747
+ type: 'boolean'
955
1748
  },
956
1749
  controllerRoleArn: {
957
1750
  type: 'string',
958
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1751
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1752
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1753
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
959
1754
  }
960
1755
  },
961
1756
  required: [
962
- 'controllerRoleArn'
1757
+ 'enabled'
963
1758
  ],
964
1759
  additionalProperties: false
965
- }
966
- },
967
- additionalProperties: false
968
- };
969
- export const InviteSchema = {
970
- type: 'object',
971
- properties: {
972
- id: {
973
- type: 'string',
974
- description: 'Unique identifier of the invitation.',
975
- example: '65831dd20d20165489cbb868'
976
1760
  },
977
- organization_id: {
978
- type: 'string',
979
- format: 'uuid',
980
- description: 'Unique identifier of the organization the project belongs to. UUID v4 string in canonical form',
981
- example: 'e94d30ec-a2dd-4dcb-832c-ac2be144ba91'
982
- },
983
- date_created: {
984
- type: 'string',
985
- format: 'date-time',
986
- description: 'Creation date of the project. ISO 8601 date string in UTC timezone',
987
- example: '2023-11-02T16:08:14.338Z'
988
- },
989
- email: {
990
- type: 'string',
991
- format: 'email',
992
- description: 'User email address.',
1761
+ constraints: {
1762
+ type: 'object',
1763
+ properties: {
1764
+ 'karpenter.sh/capacity-type': {
1765
+ type: 'array',
1766
+ items: {
1767
+ type: 'string',
1768
+ enum: [
1769
+ 'on-demand',
1770
+ 'spot'
1771
+ ]
1772
+ },
1773
+ minItems: 1,
1774
+ description: 'Allowed values for `karpenter.sh/capacity-type`.'
1775
+ },
1776
+ 'kubernetes.io/arch': {
1777
+ type: 'array',
1778
+ items: {
1779
+ type: 'string',
1780
+ enum: [
1781
+ 'amd64',
1782
+ 'arm64'
1783
+ ]
1784
+ },
1785
+ minItems: 1,
1786
+ description: 'Allowed values for `kubernetes.io/arch`.'
1787
+ },
1788
+ 'cfke.io/instance-family': {
1789
+ type: 'array',
1790
+ items: {
1791
+ type: 'string',
1792
+ enum: [
1793
+ 'a1',
1794
+ 'a2',
1795
+ 'a3',
1796
+ 'a4',
1797
+ 'c1',
1798
+ 'c2',
1799
+ 'c2d',
1800
+ 'c3',
1801
+ 'c3d',
1802
+ 'c4',
1803
+ 'c4a',
1804
+ 'c4d',
1805
+ 'c5',
1806
+ 'c5a',
1807
+ 'c5ad',
1808
+ 'c5d',
1809
+ 'c5n',
1810
+ 'c6a',
1811
+ 'c6g',
1812
+ 'c6gd',
1813
+ 'c6gn',
1814
+ 'c6i',
1815
+ 'c6id',
1816
+ 'c6in',
1817
+ 'c7a',
1818
+ 'c7g',
1819
+ 'c7gd',
1820
+ 'c7gn',
1821
+ 'c7i',
1822
+ 'c7i-flex',
1823
+ 'c8g',
1824
+ 'c8gd',
1825
+ 'cax',
1826
+ 'ccx',
1827
+ 'cpx',
1828
+ 'cx',
1829
+ 'd2',
1830
+ 'd3',
1831
+ 'd3en',
1832
+ 'dl1',
1833
+ 'dl2q',
1834
+ 'e2',
1835
+ 'f1',
1836
+ 'f2',
1837
+ 'g1',
1838
+ 'g2',
1839
+ 'g4ad',
1840
+ 'g4dn',
1841
+ 'g5',
1842
+ 'g5g',
1843
+ 'g6',
1844
+ 'g6e',
1845
+ 'gr6',
1846
+ 'h1',
1847
+ 'h3',
1848
+ 'hpc6a',
1849
+ 'hpc6id',
1850
+ 'hpc7a',
1851
+ 'hpc7g',
1852
+ 'i2',
1853
+ 'i3',
1854
+ 'i3en',
1855
+ 'i4g',
1856
+ 'i4i',
1857
+ 'i7i',
1858
+ 'i7ie',
1859
+ 'i8g',
1860
+ 'im4gn',
1861
+ 'inf1',
1862
+ 'inf2',
1863
+ 'is4gen',
1864
+ 'm1',
1865
+ 'm2',
1866
+ 'm3',
1867
+ 'm4',
1868
+ 'm5',
1869
+ 'm5a',
1870
+ 'm5ad',
1871
+ 'm5d',
1872
+ 'm5dn',
1873
+ 'm5n',
1874
+ 'm5zn',
1875
+ 'm6a',
1876
+ 'm6g',
1877
+ 'm6gd',
1878
+ 'm6i',
1879
+ 'm6id',
1880
+ 'm6idn',
1881
+ 'm6in',
1882
+ 'm7a',
1883
+ 'm7g',
1884
+ 'm7gd',
1885
+ 'm7i',
1886
+ 'm7i-flex',
1887
+ 'm8g',
1888
+ 'm8gd',
1889
+ 'n1',
1890
+ 'n2',
1891
+ 'n2d',
1892
+ 'n4',
1893
+ 'p3',
1894
+ 'p3dn',
1895
+ 'p4d',
1896
+ 'p4de',
1897
+ 'p5',
1898
+ 'p5e',
1899
+ 'p5en',
1900
+ 'p6-b200',
1901
+ 'r3',
1902
+ 'r4',
1903
+ 'r5',
1904
+ 'r5a',
1905
+ 'r5ad',
1906
+ 'r5b',
1907
+ 'r5d',
1908
+ 'r5dn',
1909
+ 'r5n',
1910
+ 'r6a',
1911
+ 'r6g',
1912
+ 'r6gd',
1913
+ 'r6i',
1914
+ 'r6id',
1915
+ 'r6idn',
1916
+ 'r6in',
1917
+ 'r7a',
1918
+ 'r7g',
1919
+ 'r7gd',
1920
+ 'r7i',
1921
+ 'r7iz',
1922
+ 'r8g',
1923
+ 'r8gd',
1924
+ 't2',
1925
+ 't2a',
1926
+ 't2d',
1927
+ 't3',
1928
+ 't3a',
1929
+ 't4g',
1930
+ 'trn1',
1931
+ 'trn1n',
1932
+ 'u-3tb1',
1933
+ 'u-6tb1',
1934
+ 'u7i-12tb',
1935
+ 'u7i-6tb',
1936
+ 'u7i-8tb',
1937
+ 'u7in-16tb',
1938
+ 'u7in-24tb',
1939
+ 'u7in-32tb',
1940
+ 'vt1',
1941
+ 'x1',
1942
+ 'x1e',
1943
+ 'x2gd',
1944
+ 'x2idn',
1945
+ 'x2iedn',
1946
+ 'x2iezn',
1947
+ 'x4',
1948
+ 'x8g',
1949
+ 'z1d',
1950
+ 'z3'
1951
+ ]
1952
+ },
1953
+ description: 'Allowed values for `cfke.io/instance-family`.'
1954
+ },
1955
+ 'topology.kubernetes.io/region': {
1956
+ type: 'array',
1957
+ items: {
1958
+ type: 'string',
1959
+ enum: [
1960
+ 'africa-south1',
1961
+ 'ap-northeast-1',
1962
+ 'ap-northeast-2',
1963
+ 'ap-northeast-3',
1964
+ 'ap-south-1',
1965
+ 'ap-southeast-1',
1966
+ 'ap-southeast-2',
1967
+ 'ash',
1968
+ 'asia-east1',
1969
+ 'asia-east2',
1970
+ 'asia-northeast1',
1971
+ 'asia-northeast2',
1972
+ 'asia-northeast3',
1973
+ 'asia-south1',
1974
+ 'asia-south2',
1975
+ 'asia-southeast1',
1976
+ 'asia-southeast2',
1977
+ 'australia-southeast1',
1978
+ 'australia-southeast2',
1979
+ 'ca-central-1',
1980
+ 'eu-central-1',
1981
+ 'eu-central-2',
1982
+ 'eu-north-1',
1983
+ 'eu-west-1',
1984
+ 'eu-west-2',
1985
+ 'eu-west-3',
1986
+ 'europe-central2',
1987
+ 'europe-north1',
1988
+ 'europe-southwest1',
1989
+ 'europe-west1',
1990
+ 'europe-west10',
1991
+ 'europe-west12',
1992
+ 'europe-west2',
1993
+ 'europe-west3',
1994
+ 'europe-west4',
1995
+ 'europe-west6',
1996
+ 'europe-west8',
1997
+ 'europe-west9',
1998
+ 'fsn1',
1999
+ 'hel1',
2000
+ 'hil',
2001
+ 'me-central1',
2002
+ 'me-central2',
2003
+ 'me-west1',
2004
+ 'nbg1',
2005
+ 'northamerica-northeast1',
2006
+ 'northamerica-northeast2',
2007
+ 'sa-east-1',
2008
+ 'sin',
2009
+ 'southamerica-east1',
2010
+ 'southamerica-west1',
2011
+ 'us-central1',
2012
+ 'us-east-1',
2013
+ 'us-east-2',
2014
+ 'us-east1',
2015
+ 'us-east4',
2016
+ 'us-east5',
2017
+ 'us-south1',
2018
+ 'us-west-1',
2019
+ 'us-west-2',
2020
+ 'us-west1',
2021
+ 'us-west2',
2022
+ 'us-west3',
2023
+ 'us-west4'
2024
+ ]
2025
+ },
2026
+ description: 'Allowed values for `topology.kubernetes.io/region`.'
2027
+ }
2028
+ },
2029
+ additionalProperties: false,
2030
+ 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.'
2031
+ },
2032
+ scalingProfile: {
2033
+ type: 'string',
2034
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
2035
+ example: 'conservative',
2036
+ enum: [
2037
+ 'aggressive',
2038
+ 'conservative'
2039
+ ]
2040
+ }
2041
+ },
2042
+ required: [
2043
+ 'scalingProfile'
2044
+ ],
2045
+ additionalProperties: false
2046
+ };
2047
+ export const InviteCreateInputSchema = {
2048
+ type: 'object',
2049
+ properties: {
2050
+ email: {
2051
+ type: 'string',
2052
+ format: 'email',
2053
+ description: 'Email address of the user to invite.',
2054
+ example: 'email@example.com'
2055
+ },
2056
+ role: {
2057
+ type: 'string',
2058
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2059
+ default: 'User',
2060
+ example: 'User',
2061
+ enum: [
2062
+ 'Administrator',
2063
+ 'User'
2064
+ ]
2065
+ }
2066
+ },
2067
+ required: [
2068
+ 'email'
2069
+ ],
2070
+ additionalProperties: false
2071
+ };
2072
+ export const InviteSchema = {
2073
+ type: 'object',
2074
+ properties: {
2075
+ id: {
2076
+ type: 'string',
2077
+ description: 'Unique identifier of the invitation.',
2078
+ example: '65831dd20d20165489cbb868'
2079
+ },
2080
+ organization_id: {
2081
+ type: 'string',
2082
+ format: 'uuid',
2083
+ description: 'Unique identifier of the organization the project belongs to. UUID v4 string in canonical form',
2084
+ example: 'e94d30ec-a2dd-4dcb-832c-ac2be144ba91'
2085
+ },
2086
+ date_created: {
2087
+ type: 'string',
2088
+ format: 'date-time',
2089
+ description: 'Creation date of the project. ISO 8601 date string in UTC timezone',
2090
+ example: '2023-11-02T16:08:14.338Z'
2091
+ },
2092
+ email: {
2093
+ type: 'string',
2094
+ format: 'email',
2095
+ description: 'User email address.',
993
2096
  example: 'email@example.com'
994
2097
  },
995
2098
  code: {
996
2099
  type: 'string',
997
2100
  description: 'Generated unique invite code.',
998
2101
  example: '7kUZnH7nnKUFfvc4NK2KQF'
2102
+ },
2103
+ role: {
2104
+ type: 'string',
2105
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2106
+ default: 'User',
2107
+ example: 'User',
2108
+ enum: [
2109
+ 'Administrator',
2110
+ 'User'
2111
+ ]
999
2112
  }
1000
2113
  },
1001
2114
  required: [
@@ -1216,6 +2329,15 @@ export const MarketplaceListingSchema = {
1216
2329
  export const OrganizationCreateInputSchema = {
1217
2330
  type: 'object',
1218
2331
  properties: {
2332
+ type: {
2333
+ type: 'string',
2334
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2335
+ example: 'business',
2336
+ enum: [
2337
+ 'business',
2338
+ 'personal'
2339
+ ]
2340
+ },
1219
2341
  email: {
1220
2342
  type: 'string',
1221
2343
  format: 'email',
@@ -1224,11 +2346,13 @@ export const OrganizationCreateInputSchema = {
1224
2346
  },
1225
2347
  first_name: {
1226
2348
  type: 'string',
2349
+ minLength: 1,
1227
2350
  description: 'First name of the billing contact person.',
1228
2351
  example: 'John'
1229
2352
  },
1230
2353
  last_name: {
1231
2354
  type: 'string',
2355
+ minLength: 1,
1232
2356
  description: 'Last name of the billing contact person.',
1233
2357
  example: 'Doe'
1234
2358
  },
@@ -1247,6 +2371,7 @@ export const OrganizationCreateInputSchema = {
1247
2371
  }
1248
2372
  },
1249
2373
  required: [
2374
+ 'type',
1250
2375
  'email',
1251
2376
  'first_name',
1252
2377
  'last_name',
@@ -1255,6 +2380,20 @@ export const OrganizationCreateInputSchema = {
1255
2380
  ],
1256
2381
  additionalProperties: false
1257
2382
  };
2383
+ export const OrganizationCreateOutputSchema = {
2384
+ type: 'object',
2385
+ properties: {
2386
+ id: {
2387
+ type: 'string',
2388
+ description: 'Unique identifier of the newly created organization. Generated by the API and safe to use for client-side tracking immediately.',
2389
+ example: 'organization-id'
2390
+ }
2391
+ },
2392
+ required: [
2393
+ 'id'
2394
+ ],
2395
+ additionalProperties: false
2396
+ };
1258
2397
  export const OrganizationSchema = {
1259
2398
  type: 'object',
1260
2399
  properties: {
@@ -1271,6 +2410,15 @@ export const OrganizationSchema = {
1271
2410
  description: 'Name of the legal entity. This name will be used in invoices. Use your first and last name for individual accounts.',
1272
2411
  example: 'ACME Corp.'
1273
2412
  },
2413
+ type: {
2414
+ type: 'string',
2415
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2416
+ example: 'business',
2417
+ enum: [
2418
+ 'business',
2419
+ 'personal'
2420
+ ]
2421
+ },
1274
2422
  date_created: {
1275
2423
  type: 'string',
1276
2424
  format: 'date-time',
@@ -1321,7 +2469,7 @@ export const OrganizationSchema = {
1321
2469
  type: 'array',
1322
2470
  items: {
1323
2471
  type: 'string',
1324
- example: 'northamerica-central-1'
2472
+ example: 'northamerica-central-1a'
1325
2473
  },
1326
2474
  minItems: 1,
1327
2475
  description: 'List of Cloudfleet control plane regions available for the organization.'
@@ -1380,13 +2528,25 @@ export const OrganizationSchema = {
1380
2528
  'closed',
1381
2529
  'suspended'
1382
2530
  ]
2531
+ },
2532
+ verification: {
2533
+ type: 'string',
2534
+ 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.',
2535
+ example: 'verified',
2536
+ enum: [
2537
+ 'none',
2538
+ 'submitted',
2539
+ 'verified'
2540
+ ]
1383
2541
  }
1384
2542
  },
1385
2543
  required: [
1386
2544
  'id',
2545
+ 'type',
1387
2546
  'date_created',
1388
2547
  'quota',
1389
- 'status'
2548
+ 'status',
2549
+ 'verification'
1390
2550
  ],
1391
2551
  additionalProperties: false
1392
2552
  };
@@ -1395,28 +2555,23 @@ export const PaymentMethodSchema = {
1395
2555
  properties: {
1396
2556
  id: {
1397
2557
  type: 'string',
1398
- format: 'uuid',
1399
- description: 'Unique identifier of the organization. UUID v4 string in canonical form.',
1400
- example: 'e94d30ec-a2dd-4dcb-832c-ac2be144ba91'
1401
- },
1402
- setup: {
1403
- type: 'boolean',
1404
- description: 'Whether organization payment method was set up and ready to use for payments.',
1405
- example: true
2558
+ 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.',
2559
+ example: 'pm_1MtwBwLkdIwHu7ix28a3tqPa'
1406
2560
  },
1407
2561
  type: {
1408
2562
  type: 'string',
1409
- nullable: true,
1410
- description: 'Payment method type type. Only `card` payments supported at the moment.',
2563
+ description: 'Payment method type. `card`, `sepa_debit` for SEPA Direct Debit (business accounts only), or `bank_transfer` for paying invoices by bank transfer.',
1411
2564
  example: 'card',
1412
2565
  enum: [
1413
- 'card'
2566
+ 'card',
2567
+ 'sepa_debit',
2568
+ 'bank_transfer'
1414
2569
  ]
1415
2570
  },
1416
2571
  last4: {
1417
2572
  type: 'string',
1418
2573
  nullable: true,
1419
- description: 'Last 4 digits of the payment card number.',
2574
+ 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.',
1420
2575
  example: '4242'
1421
2576
  },
1422
2577
  exp_month: {
@@ -1424,42 +2579,56 @@ export const PaymentMethodSchema = {
1424
2579
  minimum: 1,
1425
2580
  maximum: 12,
1426
2581
  nullable: true,
1427
- description: 'Two-digit number representing the card\'s expiration month.',
1428
- example: '12'
2582
+ description: 'Two-digit number representing the card\'s expiration month. Null for SEPA Direct Debit and bank transfer.',
2583
+ example: 12
1429
2584
  },
1430
2585
  exp_year: {
1431
2586
  type: 'integer',
1432
- minimum: 2024,
1433
2587
  nullable: true,
1434
- description: 'Four-digit number representing the card\'s expiration year.',
1435
- example: '2028'
2588
+ 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.',
2589
+ example: 2028
1436
2590
  },
1437
2591
  brand: {
1438
2592
  type: 'string',
1439
2593
  nullable: true,
1440
- description: 'Payment card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.',
1441
- example: 'visa',
1442
- enum: [
1443
- 'amex',
1444
- 'diners',
1445
- 'discover',
1446
- 'eftpos_au',
1447
- 'jcb',
1448
- 'mastercard',
1449
- 'unionpay',
1450
- 'visa',
1451
- 'unknown'
1452
- ]
2594
+ 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.',
2595
+ example: 'visa'
2596
+ },
2597
+ iban: {
2598
+ type: 'string',
2599
+ nullable: true,
2600
+ 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.',
2601
+ example: 'DE11243015658023127510'
2602
+ },
2603
+ bic: {
2604
+ type: 'string',
2605
+ nullable: true,
2606
+ description: 'BIC/SWIFT of the destination bank for bank transfers. Set only for `bank_transfer`; null otherwise.',
2607
+ example: 'SOGEDEFFXXX'
2608
+ },
2609
+ account_holder_name: {
2610
+ type: 'string',
2611
+ nullable: true,
2612
+ description: 'Account holder name of the destination bank account for bank transfers. Set only for `bank_transfer`; null otherwise.',
2613
+ example: 'Cloudfleet GmbH'
2614
+ },
2615
+ is_default: {
2616
+ type: 'boolean',
2617
+ 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).',
2618
+ example: true
1453
2619
  }
1454
2620
  },
1455
2621
  required: [
1456
2622
  'id',
1457
- 'setup',
1458
2623
  'type',
1459
2624
  'last4',
1460
2625
  'exp_month',
1461
2626
  'exp_year',
1462
- 'brand'
2627
+ 'brand',
2628
+ 'iban',
2629
+ 'bic',
2630
+ 'account_holder_name',
2631
+ 'is_default'
1463
2632
  ],
1464
2633
  additionalProperties: false
1465
2634
  };
@@ -1507,7 +2676,7 @@ export const PlatformQuotaSchema = {
1507
2676
  type: 'array',
1508
2677
  items: {
1509
2678
  type: 'string',
1510
- example: 'northamerica-central-1'
2679
+ example: 'northamerica-central-1a'
1511
2680
  },
1512
2681
  minItems: 1,
1513
2682
  description: 'List of Cloudfleet control plane regions available for the organization.'
@@ -1822,6 +2991,492 @@ export const RegistryTagSchema = {
1822
2991
  ],
1823
2992
  additionalProperties: false
1824
2993
  };
2994
+ export const TicketAttachmentSchema = {
2995
+ type: 'object',
2996
+ properties: {
2997
+ id: {
2998
+ type: 'string',
2999
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3000
+ example: '60c72b2f9f1b2c001f8e4d3c'
3001
+ },
3002
+ filename: {
3003
+ type: 'string',
3004
+ description: 'Original filename as uploaded.',
3005
+ example: 'debug.log'
3006
+ },
3007
+ content_type: {
3008
+ type: 'string',
3009
+ description: 'MIME content type of the attachment.',
3010
+ example: 'text/plain'
3011
+ },
3012
+ size: {
3013
+ type: 'integer',
3014
+ description: 'Size of the attachment in bytes.',
3015
+ example: 12345
3016
+ }
3017
+ },
3018
+ required: [
3019
+ 'id',
3020
+ 'filename',
3021
+ 'content_type',
3022
+ 'size'
3023
+ ],
3024
+ additionalProperties: false
3025
+ };
3026
+ export const TicketCreateInputSchema = {
3027
+ type: 'object',
3028
+ properties: {
3029
+ category: {
3030
+ type: 'string',
3031
+ description: 'Ticket category. Drives auto-assignment and may carry a subcategory in `properties`.',
3032
+ example: 'technical',
3033
+ enum: [
3034
+ 'billing',
3035
+ 'technical',
3036
+ 'general'
3037
+ ]
3038
+ },
3039
+ body: {
3040
+ type: 'string',
3041
+ maxLength: 50000,
3042
+ minLength: 1,
3043
+ pattern: '\\S',
3044
+ description: 'Initial message body in markdown. There is no separate subject — the first message body is the description.',
3045
+ example: 'My cluster cannot reach the registry. Logs attached.'
3046
+ },
3047
+ properties: {
3048
+ type: 'object',
3049
+ additionalProperties: true,
3050
+ description: 'Free-form key/value bag set by the UI (e.g. `subcategory`, `cluster_id`, `cluster_name`, `region`).',
3051
+ example: {
3052
+ subcategory: 'cluster-question',
3053
+ cluster_id: '60c72b2f9f1b2c001f8e4d3a'
3054
+ }
3055
+ }
3056
+ },
3057
+ required: [
3058
+ 'category',
3059
+ 'body'
3060
+ ],
3061
+ additionalProperties: false
3062
+ };
3063
+ export const TicketListResponseSchema = {
3064
+ type: 'object',
3065
+ properties: {
3066
+ items: {
3067
+ type: 'array',
3068
+ items: {
3069
+ type: 'object',
3070
+ properties: {
3071
+ id: {
3072
+ type: 'string',
3073
+ description: 'Unique identifier of the ticket (Mongo ObjectId).',
3074
+ example: '60c72b2f9f1b2c001f8e4d3a'
3075
+ },
3076
+ status: {
3077
+ type: 'string',
3078
+ description: 'Current state of the ticket.',
3079
+ example: 'waiting_on_us',
3080
+ enum: [
3081
+ 'waiting_on_us',
3082
+ 'waiting_on_user',
3083
+ 'closed'
3084
+ ]
3085
+ },
3086
+ category: {
3087
+ type: 'string',
3088
+ description: 'Ticket category.',
3089
+ example: 'technical',
3090
+ enum: [
3091
+ 'billing',
3092
+ 'technical',
3093
+ 'general'
3094
+ ]
3095
+ },
3096
+ summary: {
3097
+ type: 'string',
3098
+ description: 'First 128 characters of the initial message body, with markdown formatting and newlines stripped. Used for ticket list previews.',
3099
+ example: 'My cluster cannot reach the registry. Logs attached.'
3100
+ },
3101
+ closed_at: {
3102
+ type: 'string',
3103
+ format: 'date-time',
3104
+ nullable: true,
3105
+ description: 'Closure timestamp. Null while the ticket is open.',
3106
+ example: '2026-05-18T16:08:14.338Z'
3107
+ },
3108
+ date_created: {
3109
+ type: 'string',
3110
+ format: 'date-time',
3111
+ description: 'Creation date of the ticket. ISO 8601 UTC.',
3112
+ example: '2026-05-11T16:08:14.338Z'
3113
+ },
3114
+ date_updated: {
3115
+ type: 'string',
3116
+ format: 'date-time',
3117
+ description: 'Last update date of the ticket. ISO 8601 UTC.',
3118
+ example: '2026-05-11T16:08:14.338Z'
3119
+ },
3120
+ messages: {
3121
+ type: 'array',
3122
+ items: {
3123
+ type: 'object',
3124
+ properties: {
3125
+ id: {
3126
+ type: 'string',
3127
+ description: 'Unique identifier of the message (Mongo ObjectId).',
3128
+ example: '60c72b2f9f1b2c001f8e4d3b'
3129
+ },
3130
+ type: {
3131
+ type: 'string',
3132
+ description: 'Message type. Internal notes are filtered out of customer-facing responses.',
3133
+ example: 'customer_reply',
3134
+ enum: [
3135
+ 'customer_reply',
3136
+ 'agent_reply'
3137
+ ]
3138
+ },
3139
+ body: {
3140
+ type: 'string',
3141
+ description: 'Message body in markdown.',
3142
+ example: 'Thanks — that resolved it on my side.'
3143
+ },
3144
+ author_first_name: {
3145
+ type: 'string',
3146
+ nullable: true,
3147
+ description: 'First name of the author. Null when not provided.',
3148
+ example: 'Jane'
3149
+ },
3150
+ author_last_name: {
3151
+ type: 'string',
3152
+ nullable: true,
3153
+ description: 'Last name of the author. Null when not provided.',
3154
+ example: 'Doe'
3155
+ },
3156
+ attachments: {
3157
+ type: 'array',
3158
+ items: {
3159
+ type: 'object',
3160
+ properties: {
3161
+ id: {
3162
+ type: 'string',
3163
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3164
+ example: '60c72b2f9f1b2c001f8e4d3c'
3165
+ },
3166
+ filename: {
3167
+ type: 'string',
3168
+ description: 'Original filename as uploaded.',
3169
+ example: 'debug.log'
3170
+ },
3171
+ content_type: {
3172
+ type: 'string',
3173
+ description: 'MIME content type of the attachment.',
3174
+ example: 'text/plain'
3175
+ },
3176
+ size: {
3177
+ type: 'integer',
3178
+ description: 'Size of the attachment in bytes.',
3179
+ example: 12345
3180
+ }
3181
+ },
3182
+ required: [
3183
+ 'id',
3184
+ 'filename',
3185
+ 'content_type',
3186
+ 'size'
3187
+ ],
3188
+ additionalProperties: false
3189
+ },
3190
+ description: 'Attachments associated with this message.',
3191
+ example: []
3192
+ },
3193
+ date_created: {
3194
+ type: 'string',
3195
+ format: 'date-time',
3196
+ description: 'Creation date of the message. ISO 8601 UTC.',
3197
+ example: '2026-05-11T16:08:14.338Z'
3198
+ }
3199
+ },
3200
+ required: [
3201
+ 'id',
3202
+ 'type',
3203
+ 'body',
3204
+ 'date_created'
3205
+ ],
3206
+ additionalProperties: false
3207
+ },
3208
+ description: 'Messages on the ticket in chronological order. Internal notes are excluded. Returned by the detail endpoint only.'
3209
+ }
3210
+ },
3211
+ required: [
3212
+ 'id',
3213
+ 'status',
3214
+ 'category',
3215
+ 'summary',
3216
+ 'date_created',
3217
+ 'date_updated'
3218
+ ],
3219
+ additionalProperties: false
3220
+ },
3221
+ description: 'Tickets for the organization, ordered newest first. Messages are omitted from list responses.'
3222
+ }
3223
+ },
3224
+ required: [
3225
+ 'items'
3226
+ ],
3227
+ additionalProperties: false
3228
+ };
3229
+ export const TicketMessageInputSchema = {
3230
+ type: 'object',
3231
+ properties: {
3232
+ body: {
3233
+ type: 'string',
3234
+ maxLength: 50000,
3235
+ minLength: 1,
3236
+ pattern: '\\S',
3237
+ description: 'Reply body in markdown.',
3238
+ example: 'Thanks — that resolved it on my side.'
3239
+ }
3240
+ },
3241
+ required: [
3242
+ 'body'
3243
+ ],
3244
+ additionalProperties: false
3245
+ };
3246
+ export const TicketMessageSchema = {
3247
+ type: 'object',
3248
+ properties: {
3249
+ id: {
3250
+ type: 'string',
3251
+ description: 'Unique identifier of the message (Mongo ObjectId).',
3252
+ example: '60c72b2f9f1b2c001f8e4d3b'
3253
+ },
3254
+ type: {
3255
+ type: 'string',
3256
+ description: 'Message type. Internal notes are filtered out of customer-facing responses.',
3257
+ example: 'customer_reply',
3258
+ enum: [
3259
+ 'customer_reply',
3260
+ 'agent_reply'
3261
+ ]
3262
+ },
3263
+ body: {
3264
+ type: 'string',
3265
+ description: 'Message body in markdown.',
3266
+ example: 'Thanks — that resolved it on my side.'
3267
+ },
3268
+ author_first_name: {
3269
+ type: 'string',
3270
+ description: 'First name of the author. Null when not provided.',
3271
+ example: 'Jane'
3272
+ },
3273
+ author_last_name: {
3274
+ type: 'string',
3275
+ description: 'Last name of the author. Null when not provided.',
3276
+ example: 'Doe'
3277
+ },
3278
+ attachments: {
3279
+ type: 'array',
3280
+ items: {
3281
+ type: 'object',
3282
+ properties: {
3283
+ id: {
3284
+ type: 'string',
3285
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3286
+ example: '60c72b2f9f1b2c001f8e4d3c'
3287
+ },
3288
+ filename: {
3289
+ type: 'string',
3290
+ description: 'Original filename as uploaded.',
3291
+ example: 'debug.log'
3292
+ },
3293
+ content_type: {
3294
+ type: 'string',
3295
+ description: 'MIME content type of the attachment.',
3296
+ example: 'text/plain'
3297
+ },
3298
+ size: {
3299
+ type: 'integer',
3300
+ description: 'Size of the attachment in bytes.',
3301
+ example: 12345
3302
+ }
3303
+ },
3304
+ required: [
3305
+ 'id',
3306
+ 'filename',
3307
+ 'content_type',
3308
+ 'size'
3309
+ ],
3310
+ additionalProperties: false
3311
+ },
3312
+ description: 'Attachments associated with this message.',
3313
+ example: []
3314
+ },
3315
+ date_created: {
3316
+ type: 'string',
3317
+ format: 'date-time',
3318
+ description: 'Creation date of the message. ISO 8601 UTC.',
3319
+ example: '2026-05-11T16:08:14.338Z'
3320
+ }
3321
+ },
3322
+ required: [
3323
+ 'id',
3324
+ 'type',
3325
+ 'body',
3326
+ 'date_created'
3327
+ ],
3328
+ additionalProperties: false
3329
+ };
3330
+ export const TicketSchema = {
3331
+ type: 'object',
3332
+ properties: {
3333
+ id: {
3334
+ type: 'string',
3335
+ description: 'Unique identifier of the ticket (Mongo ObjectId).',
3336
+ example: '60c72b2f9f1b2c001f8e4d3a'
3337
+ },
3338
+ status: {
3339
+ type: 'string',
3340
+ description: 'Current state of the ticket.',
3341
+ example: 'waiting_on_us',
3342
+ enum: [
3343
+ 'waiting_on_us',
3344
+ 'waiting_on_user',
3345
+ 'closed'
3346
+ ]
3347
+ },
3348
+ category: {
3349
+ type: 'string',
3350
+ description: 'Ticket category.',
3351
+ example: 'technical',
3352
+ enum: [
3353
+ 'billing',
3354
+ 'technical',
3355
+ 'general'
3356
+ ]
3357
+ },
3358
+ summary: {
3359
+ type: 'string',
3360
+ description: 'First 128 characters of the initial message body, with markdown formatting and newlines stripped. Used for ticket list previews.',
3361
+ example: 'My cluster cannot reach the registry. Logs attached.'
3362
+ },
3363
+ closed_at: {
3364
+ type: 'string',
3365
+ format: 'date-time',
3366
+ description: 'Closure timestamp. Null while the ticket is open.',
3367
+ example: '2026-05-18T16:08:14.338Z'
3368
+ },
3369
+ date_created: {
3370
+ type: 'string',
3371
+ format: 'date-time',
3372
+ description: 'Creation date of the ticket. ISO 8601 UTC.',
3373
+ example: '2026-05-11T16:08:14.338Z'
3374
+ },
3375
+ date_updated: {
3376
+ type: 'string',
3377
+ format: 'date-time',
3378
+ description: 'Last update date of the ticket. ISO 8601 UTC.',
3379
+ example: '2026-05-11T16:08:14.338Z'
3380
+ },
3381
+ messages: {
3382
+ type: 'array',
3383
+ items: {
3384
+ type: 'object',
3385
+ properties: {
3386
+ id: {
3387
+ type: 'string',
3388
+ description: 'Unique identifier of the message (Mongo ObjectId).',
3389
+ example: '60c72b2f9f1b2c001f8e4d3b'
3390
+ },
3391
+ type: {
3392
+ type: 'string',
3393
+ description: 'Message type. Internal notes are filtered out of customer-facing responses.',
3394
+ example: 'customer_reply',
3395
+ enum: [
3396
+ 'customer_reply',
3397
+ 'agent_reply'
3398
+ ]
3399
+ },
3400
+ body: {
3401
+ type: 'string',
3402
+ description: 'Message body in markdown.',
3403
+ example: 'Thanks — that resolved it on my side.'
3404
+ },
3405
+ author_first_name: {
3406
+ type: 'string',
3407
+ description: 'First name of the author. Null when not provided.',
3408
+ example: 'Jane'
3409
+ },
3410
+ author_last_name: {
3411
+ type: 'string',
3412
+ description: 'Last name of the author. Null when not provided.',
3413
+ example: 'Doe'
3414
+ },
3415
+ attachments: {
3416
+ type: 'array',
3417
+ items: {
3418
+ type: 'object',
3419
+ properties: {
3420
+ id: {
3421
+ type: 'string',
3422
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3423
+ example: '60c72b2f9f1b2c001f8e4d3c'
3424
+ },
3425
+ filename: {
3426
+ type: 'string',
3427
+ description: 'Original filename as uploaded.',
3428
+ example: 'debug.log'
3429
+ },
3430
+ content_type: {
3431
+ type: 'string',
3432
+ description: 'MIME content type of the attachment.',
3433
+ example: 'text/plain'
3434
+ },
3435
+ size: {
3436
+ type: 'integer',
3437
+ description: 'Size of the attachment in bytes.',
3438
+ example: 12345
3439
+ }
3440
+ },
3441
+ required: [
3442
+ 'id',
3443
+ 'filename',
3444
+ 'content_type',
3445
+ 'size'
3446
+ ],
3447
+ additionalProperties: false
3448
+ },
3449
+ description: 'Attachments associated with this message.',
3450
+ example: []
3451
+ },
3452
+ date_created: {
3453
+ type: 'string',
3454
+ format: 'date-time',
3455
+ description: 'Creation date of the message. ISO 8601 UTC.',
3456
+ example: '2026-05-11T16:08:14.338Z'
3457
+ }
3458
+ },
3459
+ required: [
3460
+ 'id',
3461
+ 'type',
3462
+ 'body',
3463
+ 'date_created'
3464
+ ],
3465
+ additionalProperties: false
3466
+ },
3467
+ description: 'Messages on the ticket in chronological order. Internal notes are excluded. Returned by the detail endpoint only.'
3468
+ }
3469
+ },
3470
+ required: [
3471
+ 'id',
3472
+ 'status',
3473
+ 'category',
3474
+ 'summary',
3475
+ 'date_created',
3476
+ 'date_updated'
3477
+ ],
3478
+ additionalProperties: false
3479
+ };
1825
3480
  export const TokenCreateInputSchema = {
1826
3481
  type: 'object',
1827
3482
  properties: {
@@ -2110,24 +3765,6 @@ export const UserCreateInputSchema = {
2110
3765
  type: 'string',
2111
3766
  minLength: 8,
2112
3767
  description: 'User password. Must be at least 8 characters long.'
2113
- },
2114
- status: {
2115
- type: 'string',
2116
- description: 'Status of the user. Can be `active` or `inactive`. Inactive users cannot log in or manage organization resources.',
2117
- example: 'active',
2118
- enum: [
2119
- 'active',
2120
- 'inactive'
2121
- ]
2122
- },
2123
- role: {
2124
- type: 'string',
2125
- description: 'User role. Can be \'Administrator\', \'User\'.',
2126
- example: 'User',
2127
- enum: [
2128
- 'Administrator',
2129
- 'User'
2130
- ]
2131
3768
  }
2132
3769
  },
2133
3770
  required: [