@cloudfleet/sdk 0.0.1-017af9f → 0.0.1-03062e4

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.
@@ -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',
@@ -446,43 +440,117 @@ export const ClusterCreateInputSchema = {
446
440
  tier: {
447
441
  type: 'string',
448
442
  description: 'Tier of the cluster.',
443
+ default: 'basic',
449
444
  example: 'pro',
450
445
  enum: [
451
446
  'basic',
452
447
  'pro'
453
448
  ]
454
449
  },
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'
465
- ]
466
- },
467
450
  version_channel: {
468
451
  type: 'string',
469
452
  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
453
  description: 'Version of the kubernetes cluster.',
471
454
  default: '1.x.x-cfke.x',
472
- example: '1.x.x-cfke.x',
455
+ example: '1.x.x-cfke.x'
456
+ },
457
+ release_channel: {
458
+ type: 'string',
459
+ description: 'Release channel for the cluster\'s control plane.',
460
+ default: 'rapid',
461
+ example: 'rapid',
473
462
  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'
463
+ 'rapid',
464
+ 'stable',
465
+ 'extended'
478
466
  ]
467
+ },
468
+ features: {
469
+ type: 'object',
470
+ properties: {
471
+ gpu_sharing_strategy: {
472
+ type: 'string',
473
+ description: 'GPU sharing strategy.',
474
+ default: 'none',
475
+ example: 'none',
476
+ enum: [
477
+ 'none',
478
+ 'mps',
479
+ 'time_slicing'
480
+ ]
481
+ },
482
+ gpu_max_shared_clients_per_gpu: {
483
+ type: 'integer',
484
+ minimum: 2,
485
+ maximum: 48,
486
+ description: 'Maximum number of pods that may share a single GPU.',
487
+ default: 4,
488
+ example: 10
489
+ },
490
+ cilium_socket_lb_host_namespace_only: {
491
+ type: 'boolean',
492
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
493
+ example: false
494
+ }
495
+ },
496
+ additionalProperties: false,
497
+ description: 'Cluster feature toggles.',
498
+ default: {
499
+ gpu_sharing_strategy: 'none',
500
+ gpu_max_shared_clients_per_gpu: 4,
501
+ cilium_socket_lb_host_namespace_only: false
502
+ }
503
+ },
504
+ region: {
505
+ type: 'string',
506
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
507
+ example: 'europe-central-1a'
508
+ },
509
+ networking: {
510
+ type: 'object',
511
+ properties: {
512
+ pod_cidr: {
513
+ type: 'string',
514
+ description: 'CIDR block for pod IPs.',
515
+ default: '10.244.0.0/16'
516
+ },
517
+ service_cidr: {
518
+ type: 'string',
519
+ description: 'CIDR block for service IPs.',
520
+ default: '10.96.0.0/12'
521
+ },
522
+ dual_stack: {
523
+ type: 'boolean',
524
+ description: 'Enable IPv4+IPv6 dual-stack networking.'
525
+ },
526
+ pod_cidr_v6: {
527
+ type: 'string',
528
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
529
+ default: '2001:db8:1:2::/48'
530
+ },
531
+ service_cidr_v6: {
532
+ type: 'string',
533
+ description: 'IPv6 service CIDR. Requires dual_stack.',
534
+ default: '2001:db8:1:1::/112'
535
+ }
536
+ },
537
+ additionalProperties: false,
538
+ description: 'Cluster networking configuration. Immutable after creation.',
539
+ default: {
540
+ pod_cidr: '10.244.0.0/16',
541
+ service_cidr: '10.96.0.0/12',
542
+ dual_stack: false,
543
+ pod_cidr_v6: '2001:db8:1:2::/48',
544
+ service_cidr_v6: '2001:db8:1:1::/112'
545
+ }
479
546
  }
480
547
  },
481
548
  required: [
482
549
  'name',
483
- 'tier'
550
+ 'region'
484
551
  ],
485
- additionalProperties: false
552
+ additionalProperties: false,
553
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
486
554
  };
487
555
  export const ClusterJoinInformationSchema = {
488
556
  type: 'object',
@@ -503,6 +571,11 @@ export const ClusterJoinInformationSchema = {
503
571
  description: 'Cluster DNS IP address. This is the IP address of the kube-dns service in the cluster.',
504
572
  example: '10.96.0.10'
505
573
  },
574
+ pod_cidr: {
575
+ type: 'string',
576
+ description: 'Pod CIDR for the cluster. Used to configure iptables rules on nodes to prevent Tailscale routing loops.',
577
+ example: '10.244.0.0/16'
578
+ },
506
579
  auth_key: {
507
580
  type: 'string',
508
581
  description: 'Authentication key for the cluster.',
@@ -578,6 +651,7 @@ export const ClusterJoinInformationSchema = {
578
651
  'certificate_authority',
579
652
  'endpoint',
580
653
  'cluster_dns',
654
+ 'pod_cidr',
581
655
  'auth_key',
582
656
  'bootstrap_token',
583
657
  'versions',
@@ -599,24 +673,122 @@ export const ClusterSchema = {
599
673
  tier: {
600
674
  type: 'string',
601
675
  description: 'Tier of the cluster.',
676
+ default: 'basic',
602
677
  example: 'pro',
603
678
  enum: [
604
679
  'basic',
605
680
  'pro'
606
681
  ]
607
682
  },
608
- region: {
683
+ version_channel: {
609
684
  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',
685
+ 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-]+)*))?$',
686
+ description: 'Version of the kubernetes cluster.',
687
+ default: '1.x.x-cfke.x',
688
+ example: '1.x.x-cfke.x'
689
+ },
690
+ release_channel: {
691
+ type: 'string',
692
+ description: 'Release channel for the cluster\'s control plane.',
693
+ default: 'rapid',
694
+ example: 'rapid',
613
695
  enum: [
614
- 'staging-1a',
615
- 'northamerica-central-1',
616
- 'europe-central-1a',
617
- 'northamerica-central-1a'
696
+ 'rapid',
697
+ 'stable',
698
+ 'extended'
618
699
  ]
619
700
  },
701
+ features: {
702
+ type: 'object',
703
+ properties: {
704
+ gpu_sharing_strategy: {
705
+ type: 'string',
706
+ description: 'GPU sharing strategy.',
707
+ default: 'none',
708
+ example: 'none',
709
+ enum: [
710
+ 'none',
711
+ 'mps',
712
+ 'time_slicing'
713
+ ]
714
+ },
715
+ gpu_max_shared_clients_per_gpu: {
716
+ type: 'integer',
717
+ minimum: 2,
718
+ maximum: 48,
719
+ description: 'Maximum number of pods that may share a single GPU.',
720
+ default: 4,
721
+ example: 10
722
+ },
723
+ cilium_socket_lb_host_namespace_only: {
724
+ type: 'boolean',
725
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
726
+ example: false
727
+ }
728
+ },
729
+ required: [
730
+ 'gpu_sharing_strategy',
731
+ 'gpu_max_shared_clients_per_gpu',
732
+ 'cilium_socket_lb_host_namespace_only'
733
+ ],
734
+ additionalProperties: false,
735
+ description: 'Cluster feature toggles.',
736
+ default: {
737
+ gpu_sharing_strategy: 'none',
738
+ gpu_max_shared_clients_per_gpu: 4,
739
+ cilium_socket_lb_host_namespace_only: false
740
+ }
741
+ },
742
+ region: {
743
+ type: 'string',
744
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
745
+ example: 'europe-central-1a'
746
+ },
747
+ networking: {
748
+ type: 'object',
749
+ properties: {
750
+ pod_cidr: {
751
+ type: 'string',
752
+ description: 'CIDR block for pod IPs.',
753
+ default: '10.244.0.0/16'
754
+ },
755
+ service_cidr: {
756
+ type: 'string',
757
+ description: 'CIDR block for service IPs.',
758
+ default: '10.96.0.0/12'
759
+ },
760
+ dual_stack: {
761
+ type: 'boolean',
762
+ description: 'Enable IPv4+IPv6 dual-stack networking.'
763
+ },
764
+ pod_cidr_v6: {
765
+ type: 'string',
766
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
767
+ default: '2001:db8:1:2::/48'
768
+ },
769
+ service_cidr_v6: {
770
+ type: 'string',
771
+ description: 'IPv6 service CIDR. Requires dual_stack.',
772
+ default: '2001:db8:1:1::/112'
773
+ }
774
+ },
775
+ required: [
776
+ 'pod_cidr',
777
+ 'service_cidr',
778
+ 'dual_stack',
779
+ 'pod_cidr_v6',
780
+ 'service_cidr_v6'
781
+ ],
782
+ additionalProperties: false,
783
+ description: 'Cluster networking configuration. Immutable after creation.',
784
+ default: {
785
+ pod_cidr: '10.244.0.0/16',
786
+ service_cidr: '10.96.0.0/12',
787
+ dual_stack: false,
788
+ pod_cidr_v6: '2001:db8:1:2::/48',
789
+ service_cidr_v6: '2001:db8:1:1::/112'
790
+ }
791
+ },
620
792
  id: {
621
793
  type: 'string',
622
794
  format: 'uuid',
@@ -625,16 +797,13 @@ export const ClusterSchema = {
625
797
  },
626
798
  status: {
627
799
  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',
800
+ description: 'Status of the cluster.',
801
+ example: 'deployed',
630
802
  enum: [
631
- 'active',
632
- 'disabled',
633
- 'deleted',
634
803
  'creating',
635
804
  'deployed',
636
- 'failed',
637
- 'updating'
805
+ 'updating',
806
+ 'disabled'
638
807
  ]
639
808
  },
640
809
  endpoint: {
@@ -642,8 +811,8 @@ export const ClusterSchema = {
642
811
  {
643
812
  type: 'string',
644
813
  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'
814
+ 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.',
815
+ example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
647
816
  },
648
817
  {
649
818
  type: 'string',
@@ -658,7 +827,7 @@ export const ClusterSchema = {
658
827
  {
659
828
  type: 'string',
660
829
  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.',
830
+ description: 'Deprecated alias of `endpoint`; retained for backward compatibility.',
662
831
  example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
663
832
  },
664
833
  {
@@ -693,21 +862,22 @@ export const ClusterSchema = {
693
862
  type: 'boolean',
694
863
  description: 'Indicates if the cluster is ready to be used.',
695
864
  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
865
  }
703
866
  },
704
867
  required: [
705
868
  'name',
706
869
  'tier',
870
+ 'version_channel',
871
+ 'release_channel',
872
+ 'features',
873
+ 'region',
874
+ 'networking',
707
875
  'id',
708
- 'status'
876
+ 'status',
877
+ 'ready'
709
878
  ],
710
- additionalProperties: false
879
+ additionalProperties: false,
880
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
711
881
  };
712
882
  export const ClusterUpdateInputSchema = {
713
883
  type: 'object',
@@ -723,6 +893,7 @@ export const ClusterUpdateInputSchema = {
723
893
  tier: {
724
894
  type: 'string',
725
895
  description: 'Tier of the cluster.',
896
+ default: 'basic',
726
897
  example: 'pro',
727
898
  enum: [
728
899
  'basic',
@@ -733,13 +904,62 @@ export const ClusterUpdateInputSchema = {
733
904
  type: 'string',
734
905
  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
906
  description: 'Version of the kubernetes cluster.',
907
+ default: '1.x.x-cfke.x',
736
908
  example: '1.x.x-cfke.x'
909
+ },
910
+ release_channel: {
911
+ type: 'string',
912
+ description: 'Release channel for the cluster\'s control plane.',
913
+ default: 'rapid',
914
+ example: 'rapid',
915
+ enum: [
916
+ 'rapid',
917
+ 'stable',
918
+ 'extended'
919
+ ]
920
+ },
921
+ features: {
922
+ type: 'object',
923
+ properties: {
924
+ gpu_sharing_strategy: {
925
+ type: 'string',
926
+ description: 'GPU sharing strategy.',
927
+ default: 'none',
928
+ example: 'none',
929
+ enum: [
930
+ 'none',
931
+ 'mps',
932
+ 'time_slicing'
933
+ ]
934
+ },
935
+ gpu_max_shared_clients_per_gpu: {
936
+ type: 'integer',
937
+ minimum: 2,
938
+ maximum: 48,
939
+ description: 'Maximum number of pods that may share a single GPU.',
940
+ default: 4,
941
+ example: 10
942
+ },
943
+ cilium_socket_lb_host_namespace_only: {
944
+ type: 'boolean',
945
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
946
+ example: false
947
+ }
948
+ },
949
+ additionalProperties: false,
950
+ description: 'Cluster feature toggles.',
951
+ default: {
952
+ gpu_sharing_strategy: 'none',
953
+ gpu_max_shared_clients_per_gpu: 4,
954
+ cilium_socket_lb_host_namespace_only: false
955
+ }
737
956
  }
738
957
  },
739
958
  required: [
740
- 'tier'
959
+ 'name'
741
960
  ],
742
- additionalProperties: false
961
+ additionalProperties: false,
962
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
743
963
  };
744
964
  export const FleetCreateInputSchema = {
745
965
  type: 'object',
@@ -748,10 +968,10 @@ export const FleetCreateInputSchema = {
748
968
  type: 'object',
749
969
  properties: {
750
970
  cpu: {
751
- type: 'number',
752
- format: 'float',
971
+ type: 'integer',
753
972
  minimum: 0,
754
- description: 'CPU limit in cores.'
973
+ maximum: 100000,
974
+ description: 'CPU limit in cores. Maximum 100,000.'
755
975
  }
756
976
  },
757
977
  additionalProperties: false,
@@ -761,16 +981,17 @@ export const FleetCreateInputSchema = {
761
981
  type: 'object',
762
982
  properties: {
763
983
  enabled: {
764
- type: 'boolean',
765
- default: true
984
+ type: 'boolean'
766
985
  },
767
986
  project: {
768
987
  type: 'string',
769
- description: 'Project GCP Project id to deploy instances into'
988
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
989
+ 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.',
990
+ example: 'my-cloudfleet-project'
770
991
  }
771
992
  },
772
993
  required: [
773
- 'project'
994
+ 'enabled'
774
995
  ],
775
996
  additionalProperties: false
776
997
  },
@@ -778,30 +999,36 @@ export const FleetCreateInputSchema = {
778
999
  type: 'object',
779
1000
  properties: {
780
1001
  enabled: {
781
- type: 'boolean',
782
- default: true
1002
+ type: 'boolean'
783
1003
  },
784
1004
  apiKey: {
785
1005
  type: 'string',
786
- description: 'Hetzner Cloud API key with read / write access. On update, omit this field to keep the existing value.'
1006
+ maxLength: 64,
1007
+ minLength: 64,
1008
+ pattern: '^([A-Za-z0-9]{64}|\\*{64})$',
1009
+ 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.'
787
1010
  }
788
1011
  },
1012
+ required: [
1013
+ 'enabled'
1014
+ ],
789
1015
  additionalProperties: false
790
1016
  },
791
1017
  aws: {
792
1018
  type: 'object',
793
1019
  properties: {
794
1020
  enabled: {
795
- type: 'boolean',
796
- default: true
1021
+ type: 'boolean'
797
1022
  },
798
1023
  controllerRoleArn: {
799
1024
  type: 'string',
800
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1025
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1026
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1027
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
801
1028
  }
802
1029
  },
803
1030
  required: [
804
- 'controllerRoleArn'
1031
+ 'enabled'
805
1032
  ],
806
1033
  additionalProperties: false
807
1034
  },
@@ -817,7 +1044,12 @@ export const FleetCreateInputSchema = {
817
1044
  'spot'
818
1045
  ]
819
1046
  },
820
- description: 'Allowed values for `karpenter.sh/capacity-type`.'
1047
+ minItems: 1,
1048
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1049
+ default: [
1050
+ 'on-demand',
1051
+ 'spot'
1052
+ ]
821
1053
  },
822
1054
  'kubernetes.io/arch': {
823
1055
  type: 'array',
@@ -828,7 +1060,11 @@ export const FleetCreateInputSchema = {
828
1060
  'arm64'
829
1061
  ]
830
1062
  },
831
- description: 'Allowed values for `kubernetes.io/arch`.'
1063
+ minItems: 1,
1064
+ description: 'Allowed values for `kubernetes.io/arch`.',
1065
+ default: [
1066
+ 'amd64'
1067
+ ]
832
1068
  },
833
1069
  'cfke.io/instance-family': {
834
1070
  type: 'array',
@@ -995,7 +1231,8 @@ export const FleetCreateInputSchema = {
995
1231
  'z3'
996
1232
  ]
997
1233
  },
998
- description: 'Allowed values for `cfke.io/instance-family`.'
1234
+ description: 'Allowed values for `cfke.io/instance-family`.',
1235
+ default: []
999
1236
  },
1000
1237
  'topology.kubernetes.io/region': {
1001
1238
  type: 'array',
@@ -1068,15 +1305,28 @@ export const FleetCreateInputSchema = {
1068
1305
  'us-west4'
1069
1306
  ]
1070
1307
  },
1071
- description: 'Allowed values for `topology.kubernetes.io/region`.'
1308
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
1309
+ default: []
1072
1310
  }
1073
1311
  },
1074
1312
  additionalProperties: false,
1075
- 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.'
1313
+ 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.',
1314
+ default: {
1315
+ 'karpenter.sh/capacity-type': [
1316
+ 'on-demand',
1317
+ 'spot'
1318
+ ],
1319
+ 'kubernetes.io/arch': [
1320
+ 'amd64'
1321
+ ],
1322
+ 'cfke.io/instance-family': [],
1323
+ 'topology.kubernetes.io/region': []
1324
+ }
1076
1325
  },
1077
1326
  scalingProfile: {
1078
1327
  type: 'string',
1079
- description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
1328
+ 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`).',
1329
+ default: 'conservative',
1080
1330
  example: 'conservative',
1081
1331
  enum: [
1082
1332
  'aggressive',
@@ -1095,7 +1345,8 @@ export const FleetCreateInputSchema = {
1095
1345
  required: [
1096
1346
  'id'
1097
1347
  ],
1098
- additionalProperties: false
1348
+ additionalProperties: false,
1349
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
1099
1350
  };
1100
1351
  export const FleetSchema = {
1101
1352
  type: 'object',
@@ -1104,10 +1355,10 @@ export const FleetSchema = {
1104
1355
  type: 'object',
1105
1356
  properties: {
1106
1357
  cpu: {
1107
- type: 'number',
1108
- format: 'float',
1358
+ type: 'integer',
1109
1359
  minimum: 0,
1110
- description: 'CPU limit in cores.'
1360
+ maximum: 100000,
1361
+ description: 'CPU limit in cores. Maximum 100,000.'
1111
1362
  }
1112
1363
  },
1113
1364
  additionalProperties: false,
@@ -1117,16 +1368,17 @@ export const FleetSchema = {
1117
1368
  type: 'object',
1118
1369
  properties: {
1119
1370
  enabled: {
1120
- type: 'boolean',
1121
- default: true
1371
+ type: 'boolean'
1122
1372
  },
1123
1373
  project: {
1124
1374
  type: 'string',
1125
- description: 'Project GCP Project id to deploy instances into'
1375
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1376
+ 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.',
1377
+ example: 'my-cloudfleet-project'
1126
1378
  }
1127
1379
  },
1128
1380
  required: [
1129
- 'project'
1381
+ 'enabled'
1130
1382
  ],
1131
1383
  additionalProperties: false
1132
1384
  },
@@ -1134,30 +1386,34 @@ export const FleetSchema = {
1134
1386
  type: 'object',
1135
1387
  properties: {
1136
1388
  enabled: {
1137
- type: 'boolean',
1138
- default: true
1389
+ type: 'boolean'
1139
1390
  },
1140
1391
  apiKey: {
1141
1392
  type: 'string',
1142
- description: 'Hetzner Cloud API key with read / write access. On update, omit this field to keep the existing value.'
1393
+ pattern: '^\\*{64}$',
1394
+ 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.'
1143
1395
  }
1144
1396
  },
1397
+ required: [
1398
+ 'enabled'
1399
+ ],
1145
1400
  additionalProperties: false
1146
1401
  },
1147
1402
  aws: {
1148
1403
  type: 'object',
1149
1404
  properties: {
1150
1405
  enabled: {
1151
- type: 'boolean',
1152
- default: true
1406
+ type: 'boolean'
1153
1407
  },
1154
1408
  controllerRoleArn: {
1155
1409
  type: 'string',
1156
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1410
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1411
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1412
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
1157
1413
  }
1158
1414
  },
1159
1415
  required: [
1160
- 'controllerRoleArn'
1416
+ 'enabled'
1161
1417
  ],
1162
1418
  additionalProperties: false
1163
1419
  },
@@ -1173,7 +1429,12 @@ export const FleetSchema = {
1173
1429
  'spot'
1174
1430
  ]
1175
1431
  },
1176
- description: 'Allowed values for `karpenter.sh/capacity-type`.'
1432
+ minItems: 1,
1433
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1434
+ default: [
1435
+ 'on-demand',
1436
+ 'spot'
1437
+ ]
1177
1438
  },
1178
1439
  'kubernetes.io/arch': {
1179
1440
  type: 'array',
@@ -1184,7 +1445,11 @@ export const FleetSchema = {
1184
1445
  'arm64'
1185
1446
  ]
1186
1447
  },
1187
- description: 'Allowed values for `kubernetes.io/arch`.'
1448
+ minItems: 1,
1449
+ description: 'Allowed values for `kubernetes.io/arch`.',
1450
+ default: [
1451
+ 'amd64'
1452
+ ]
1188
1453
  },
1189
1454
  'cfke.io/instance-family': {
1190
1455
  type: 'array',
@@ -1351,7 +1616,8 @@ export const FleetSchema = {
1351
1616
  'z3'
1352
1617
  ]
1353
1618
  },
1354
- description: 'Allowed values for `cfke.io/instance-family`.'
1619
+ description: 'Allowed values for `cfke.io/instance-family`.',
1620
+ default: []
1355
1621
  },
1356
1622
  'topology.kubernetes.io/region': {
1357
1623
  type: 'array',
@@ -1424,15 +1690,32 @@ export const FleetSchema = {
1424
1690
  'us-west4'
1425
1691
  ]
1426
1692
  },
1427
- description: 'Allowed values for `topology.kubernetes.io/region`.'
1693
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
1694
+ default: []
1428
1695
  }
1429
1696
  },
1697
+ required: [
1698
+ 'karpenter.sh/capacity-type',
1699
+ 'kubernetes.io/arch'
1700
+ ],
1430
1701
  additionalProperties: false,
1431
- 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.'
1702
+ 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.',
1703
+ default: {
1704
+ 'karpenter.sh/capacity-type': [
1705
+ 'on-demand',
1706
+ 'spot'
1707
+ ],
1708
+ 'kubernetes.io/arch': [
1709
+ 'amd64'
1710
+ ],
1711
+ 'cfke.io/instance-family': [],
1712
+ 'topology.kubernetes.io/region': []
1713
+ }
1432
1714
  },
1433
1715
  scalingProfile: {
1434
1716
  type: 'string',
1435
- description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
1717
+ 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`).',
1718
+ default: 'conservative',
1436
1719
  example: 'conservative',
1437
1720
  enum: [
1438
1721
  'aggressive',
@@ -1446,12 +1729,38 @@ export const FleetSchema = {
1446
1729
  pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
1447
1730
  description: 'Unique identifier of the kubernetes fleet.',
1448
1731
  example: 'new-clouds-fleet'
1732
+ },
1733
+ ready: {
1734
+ type: 'boolean',
1735
+ description: 'Indicates whether the fleet configuration is healthy.',
1736
+ example: true
1737
+ },
1738
+ status_message: {
1739
+ type: 'string',
1740
+ description: 'Human-readable reason the fleet is not ready. Present only when `ready` is false.',
1741
+ example: 'Invalid provider permissions.'
1742
+ },
1743
+ created_at: {
1744
+ type: 'string',
1745
+ description: 'Creation date and time of the fleet.',
1746
+ example: '2024-09-12T09:11:27Z'
1747
+ },
1748
+ updated_at: {
1749
+ type: 'string',
1750
+ description: 'Date and time the fleet was last updated.',
1751
+ example: '2024-09-12T09:11:27Z'
1449
1752
  }
1450
1753
  },
1451
1754
  required: [
1452
- 'id'
1755
+ 'constraints',
1756
+ 'scalingProfile',
1757
+ 'id',
1758
+ 'ready',
1759
+ 'created_at',
1760
+ 'updated_at'
1453
1761
  ],
1454
- additionalProperties: false
1762
+ additionalProperties: false,
1763
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
1455
1764
  };
1456
1765
  export const FleetUpdateInputSchema = {
1457
1766
  type: 'object',
@@ -1460,10 +1769,10 @@ export const FleetUpdateInputSchema = {
1460
1769
  type: 'object',
1461
1770
  properties: {
1462
1771
  cpu: {
1463
- type: 'number',
1464
- format: 'float',
1772
+ type: 'integer',
1465
1773
  minimum: 0,
1466
- description: 'CPU limit in cores.'
1774
+ maximum: 100000,
1775
+ description: 'CPU limit in cores. Maximum 100,000.'
1467
1776
  }
1468
1777
  },
1469
1778
  additionalProperties: false,
@@ -1473,16 +1782,17 @@ export const FleetUpdateInputSchema = {
1473
1782
  type: 'object',
1474
1783
  properties: {
1475
1784
  enabled: {
1476
- type: 'boolean',
1477
- default: true
1785
+ type: 'boolean'
1478
1786
  },
1479
1787
  project: {
1480
1788
  type: 'string',
1481
- description: 'Project GCP Project id to deploy instances into'
1789
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1790
+ 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.',
1791
+ example: 'my-cloudfleet-project'
1482
1792
  }
1483
1793
  },
1484
1794
  required: [
1485
- 'project'
1795
+ 'enabled'
1486
1796
  ],
1487
1797
  additionalProperties: false
1488
1798
  },
@@ -1490,30 +1800,36 @@ export const FleetUpdateInputSchema = {
1490
1800
  type: 'object',
1491
1801
  properties: {
1492
1802
  enabled: {
1493
- type: 'boolean',
1494
- default: true
1803
+ type: 'boolean'
1495
1804
  },
1496
1805
  apiKey: {
1497
1806
  type: 'string',
1498
- description: 'Hetzner Cloud API key with read / write access. On update, omit this field to keep the existing value.'
1807
+ maxLength: 64,
1808
+ minLength: 64,
1809
+ pattern: '^([A-Za-z0-9]{64}|\\*{64})$',
1810
+ 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.'
1499
1811
  }
1500
1812
  },
1813
+ required: [
1814
+ 'enabled'
1815
+ ],
1501
1816
  additionalProperties: false
1502
1817
  },
1503
1818
  aws: {
1504
1819
  type: 'object',
1505
1820
  properties: {
1506
1821
  enabled: {
1507
- type: 'boolean',
1508
- default: true
1822
+ type: 'boolean'
1509
1823
  },
1510
1824
  controllerRoleArn: {
1511
1825
  type: 'string',
1512
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1826
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1827
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1828
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
1513
1829
  }
1514
1830
  },
1515
1831
  required: [
1516
- 'controllerRoleArn'
1832
+ 'enabled'
1517
1833
  ],
1518
1834
  additionalProperties: false
1519
1835
  },
@@ -1529,7 +1845,12 @@ export const FleetUpdateInputSchema = {
1529
1845
  'spot'
1530
1846
  ]
1531
1847
  },
1532
- description: 'Allowed values for `karpenter.sh/capacity-type`.'
1848
+ minItems: 1,
1849
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1850
+ default: [
1851
+ 'on-demand',
1852
+ 'spot'
1853
+ ]
1533
1854
  },
1534
1855
  'kubernetes.io/arch': {
1535
1856
  type: 'array',
@@ -1540,7 +1861,11 @@ export const FleetUpdateInputSchema = {
1540
1861
  'arm64'
1541
1862
  ]
1542
1863
  },
1543
- description: 'Allowed values for `kubernetes.io/arch`.'
1864
+ minItems: 1,
1865
+ description: 'Allowed values for `kubernetes.io/arch`.',
1866
+ default: [
1867
+ 'amd64'
1868
+ ]
1544
1869
  },
1545
1870
  'cfke.io/instance-family': {
1546
1871
  type: 'array',
@@ -1707,7 +2032,8 @@ export const FleetUpdateInputSchema = {
1707
2032
  'z3'
1708
2033
  ]
1709
2034
  },
1710
- description: 'Allowed values for `cfke.io/instance-family`.'
2035
+ description: 'Allowed values for `cfke.io/instance-family`.',
2036
+ default: []
1711
2037
  },
1712
2038
  'topology.kubernetes.io/region': {
1713
2039
  type: 'array',
@@ -1780,15 +2106,28 @@ export const FleetUpdateInputSchema = {
1780
2106
  'us-west4'
1781
2107
  ]
1782
2108
  },
1783
- description: 'Allowed values for `topology.kubernetes.io/region`.'
2109
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
2110
+ default: []
1784
2111
  }
1785
2112
  },
1786
2113
  additionalProperties: false,
1787
- 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.'
2114
+ 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.',
2115
+ default: {
2116
+ 'karpenter.sh/capacity-type': [
2117
+ 'on-demand',
2118
+ 'spot'
2119
+ ],
2120
+ 'kubernetes.io/arch': [
2121
+ 'amd64'
2122
+ ],
2123
+ 'cfke.io/instance-family': [],
2124
+ 'topology.kubernetes.io/region': []
2125
+ }
1788
2126
  },
1789
2127
  scalingProfile: {
1790
2128
  type: 'string',
1791
- description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
2129
+ 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`).',
2130
+ default: 'conservative',
1792
2131
  example: 'conservative',
1793
2132
  enum: [
1794
2133
  'aggressive',
@@ -1796,6 +2135,32 @@ export const FleetUpdateInputSchema = {
1796
2135
  ]
1797
2136
  }
1798
2137
  },
2138
+ additionalProperties: false,
2139
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
2140
+ };
2141
+ export const InviteCreateInputSchema = {
2142
+ type: 'object',
2143
+ properties: {
2144
+ email: {
2145
+ type: 'string',
2146
+ format: 'email',
2147
+ description: 'Email address of the user to invite.',
2148
+ example: 'email@example.com'
2149
+ },
2150
+ role: {
2151
+ type: 'string',
2152
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2153
+ default: 'User',
2154
+ example: 'User',
2155
+ enum: [
2156
+ 'Administrator',
2157
+ 'User'
2158
+ ]
2159
+ }
2160
+ },
2161
+ required: [
2162
+ 'email'
2163
+ ],
1799
2164
  additionalProperties: false
1800
2165
  };
1801
2166
  export const InviteSchema = {
@@ -1828,6 +2193,16 @@ export const InviteSchema = {
1828
2193
  type: 'string',
1829
2194
  description: 'Generated unique invite code.',
1830
2195
  example: '7kUZnH7nnKUFfvc4NK2KQF'
2196
+ },
2197
+ role: {
2198
+ type: 'string',
2199
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2200
+ default: 'User',
2201
+ example: 'User',
2202
+ enum: [
2203
+ 'Administrator',
2204
+ 'User'
2205
+ ]
1831
2206
  }
1832
2207
  },
1833
2208
  required: [
@@ -2048,6 +2423,15 @@ export const MarketplaceListingSchema = {
2048
2423
  export const OrganizationCreateInputSchema = {
2049
2424
  type: 'object',
2050
2425
  properties: {
2426
+ type: {
2427
+ type: 'string',
2428
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2429
+ example: 'business',
2430
+ enum: [
2431
+ 'business',
2432
+ 'personal'
2433
+ ]
2434
+ },
2051
2435
  email: {
2052
2436
  type: 'string',
2053
2437
  format: 'email',
@@ -2056,11 +2440,13 @@ export const OrganizationCreateInputSchema = {
2056
2440
  },
2057
2441
  first_name: {
2058
2442
  type: 'string',
2443
+ minLength: 1,
2059
2444
  description: 'First name of the billing contact person.',
2060
2445
  example: 'John'
2061
2446
  },
2062
2447
  last_name: {
2063
2448
  type: 'string',
2449
+ minLength: 1,
2064
2450
  description: 'Last name of the billing contact person.',
2065
2451
  example: 'Doe'
2066
2452
  },
@@ -2079,6 +2465,7 @@ export const OrganizationCreateInputSchema = {
2079
2465
  }
2080
2466
  },
2081
2467
  required: [
2468
+ 'type',
2082
2469
  'email',
2083
2470
  'first_name',
2084
2471
  'last_name',
@@ -2087,6 +2474,20 @@ export const OrganizationCreateInputSchema = {
2087
2474
  ],
2088
2475
  additionalProperties: false
2089
2476
  };
2477
+ export const OrganizationCreateOutputSchema = {
2478
+ type: 'object',
2479
+ properties: {
2480
+ id: {
2481
+ type: 'string',
2482
+ description: 'Unique identifier of the newly created organization. Generated by the API and safe to use for client-side tracking immediately.',
2483
+ example: 'organization-id'
2484
+ }
2485
+ },
2486
+ required: [
2487
+ 'id'
2488
+ ],
2489
+ additionalProperties: false
2490
+ };
2090
2491
  export const OrganizationSchema = {
2091
2492
  type: 'object',
2092
2493
  properties: {
@@ -2103,6 +2504,15 @@ export const OrganizationSchema = {
2103
2504
  description: 'Name of the legal entity. This name will be used in invoices. Use your first and last name for individual accounts.',
2104
2505
  example: 'ACME Corp.'
2105
2506
  },
2507
+ type: {
2508
+ type: 'string',
2509
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2510
+ example: 'business',
2511
+ enum: [
2512
+ 'business',
2513
+ 'personal'
2514
+ ]
2515
+ },
2106
2516
  date_created: {
2107
2517
  type: 'string',
2108
2518
  format: 'date-time',
@@ -2153,7 +2563,7 @@ export const OrganizationSchema = {
2153
2563
  type: 'array',
2154
2564
  items: {
2155
2565
  type: 'string',
2156
- example: 'northamerica-central-1'
2566
+ example: 'northamerica-central-1a'
2157
2567
  },
2158
2568
  minItems: 1,
2159
2569
  description: 'List of Cloudfleet control plane regions available for the organization.'
@@ -2212,13 +2622,25 @@ export const OrganizationSchema = {
2212
2622
  'closed',
2213
2623
  'suspended'
2214
2624
  ]
2625
+ },
2626
+ verification: {
2627
+ type: 'string',
2628
+ 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.',
2629
+ example: 'verified',
2630
+ enum: [
2631
+ 'none',
2632
+ 'submitted',
2633
+ 'verified'
2634
+ ]
2215
2635
  }
2216
2636
  },
2217
2637
  required: [
2218
2638
  'id',
2639
+ 'type',
2219
2640
  'date_created',
2220
2641
  'quota',
2221
- 'status'
2642
+ 'status',
2643
+ 'verification'
2222
2644
  ],
2223
2645
  additionalProperties: false
2224
2646
  };
@@ -2227,28 +2649,23 @@ export const PaymentMethodSchema = {
2227
2649
  properties: {
2228
2650
  id: {
2229
2651
  type: 'string',
2230
- format: 'uuid',
2231
- description: 'Unique identifier of the organization. UUID v4 string in canonical form.',
2232
- example: 'e94d30ec-a2dd-4dcb-832c-ac2be144ba91'
2233
- },
2234
- setup: {
2235
- type: 'boolean',
2236
- description: 'Whether organization payment method was set up and ready to use for payments.',
2237
- example: true
2652
+ 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.',
2653
+ example: 'pm_1MtwBwLkdIwHu7ix28a3tqPa'
2238
2654
  },
2239
2655
  type: {
2240
2656
  type: 'string',
2241
- nullable: true,
2242
- description: 'Payment method type type. Only `card` payments supported at the moment.',
2657
+ description: 'Payment method type. `card`, `sepa_debit` for SEPA Direct Debit (business accounts only), or `bank_transfer` for paying invoices by bank transfer.',
2243
2658
  example: 'card',
2244
2659
  enum: [
2245
- 'card'
2660
+ 'card',
2661
+ 'sepa_debit',
2662
+ 'bank_transfer'
2246
2663
  ]
2247
2664
  },
2248
2665
  last4: {
2249
2666
  type: 'string',
2250
2667
  nullable: true,
2251
- description: 'Last 4 digits of the payment card number.',
2668
+ 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.',
2252
2669
  example: '4242'
2253
2670
  },
2254
2671
  exp_month: {
@@ -2256,42 +2673,56 @@ export const PaymentMethodSchema = {
2256
2673
  minimum: 1,
2257
2674
  maximum: 12,
2258
2675
  nullable: true,
2259
- description: 'Two-digit number representing the card\'s expiration month.',
2260
- example: '12'
2676
+ description: 'Two-digit number representing the card\'s expiration month. Null for SEPA Direct Debit and bank transfer.',
2677
+ example: 12
2261
2678
  },
2262
2679
  exp_year: {
2263
2680
  type: 'integer',
2264
- minimum: 2024,
2265
2681
  nullable: true,
2266
- description: 'Four-digit number representing the card\'s expiration year.',
2267
- example: '2028'
2682
+ 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.',
2683
+ example: 2028
2268
2684
  },
2269
2685
  brand: {
2270
2686
  type: 'string',
2271
2687
  nullable: true,
2272
- description: 'Payment card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.',
2273
- example: 'visa',
2274
- enum: [
2275
- 'amex',
2276
- 'diners',
2277
- 'discover',
2278
- 'eftpos_au',
2279
- 'jcb',
2280
- 'mastercard',
2281
- 'unionpay',
2282
- 'visa',
2283
- 'unknown'
2284
- ]
2688
+ 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.',
2689
+ example: 'visa'
2690
+ },
2691
+ iban: {
2692
+ type: 'string',
2693
+ nullable: true,
2694
+ 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.',
2695
+ example: 'DE11243015658023127510'
2696
+ },
2697
+ bic: {
2698
+ type: 'string',
2699
+ nullable: true,
2700
+ description: 'BIC/SWIFT of the destination bank for bank transfers. Set only for `bank_transfer`; null otherwise.',
2701
+ example: 'SOGEDEFFXXX'
2702
+ },
2703
+ account_holder_name: {
2704
+ type: 'string',
2705
+ nullable: true,
2706
+ description: 'Account holder name of the destination bank account for bank transfers. Set only for `bank_transfer`; null otherwise.',
2707
+ example: 'Cloudfleet GmbH'
2708
+ },
2709
+ is_default: {
2710
+ type: 'boolean',
2711
+ 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).',
2712
+ example: true
2285
2713
  }
2286
2714
  },
2287
2715
  required: [
2288
2716
  'id',
2289
- 'setup',
2290
2717
  'type',
2291
2718
  'last4',
2292
2719
  'exp_month',
2293
2720
  'exp_year',
2294
- 'brand'
2721
+ 'brand',
2722
+ 'iban',
2723
+ 'bic',
2724
+ 'account_holder_name',
2725
+ 'is_default'
2295
2726
  ],
2296
2727
  additionalProperties: false
2297
2728
  };
@@ -2339,7 +2770,7 @@ export const PlatformQuotaSchema = {
2339
2770
  type: 'array',
2340
2771
  items: {
2341
2772
  type: 'string',
2342
- example: 'northamerica-central-1'
2773
+ example: 'northamerica-central-1a'
2343
2774
  },
2344
2775
  minItems: 1,
2345
2776
  description: 'List of Cloudfleet control plane regions available for the organization.'
@@ -3428,24 +3859,6 @@ export const UserCreateInputSchema = {
3428
3859
  type: 'string',
3429
3860
  minLength: 8,
3430
3861
  description: 'User password. Must be at least 8 characters long.'
3431
- },
3432
- status: {
3433
- type: 'string',
3434
- description: 'Status of the user. Can be `active` or `inactive`. Inactive users cannot log in or manage organization resources.',
3435
- example: 'active',
3436
- enum: [
3437
- 'active',
3438
- 'inactive'
3439
- ]
3440
- },
3441
- role: {
3442
- type: 'string',
3443
- description: 'User role. Can be \'Administrator\', \'User\'.',
3444
- example: 'User',
3445
- enum: [
3446
- 'Administrator',
3447
- 'User'
3448
- ]
3449
3862
  }
3450
3863
  },
3451
3864
  required: [