{
  "openapi": "3.0.0",
  "info": {
    "title": "NodeRings API",
    "version": "1.0",
    "contact": {
      "name": "NodeRings",
      "url": "https://noderings.com"
    }
  },
  "tags": [
    {
      "name": "OrganizationService"
    },
    {
      "name": "UserService"
    },
    {
      "name": "GroupService"
    },
    {
      "name": "RoleService"
    },
    {
      "name": "PermissionService"
    },
    {
      "name": "InviteService"
    },
    {
      "name": "SecretService"
    },
    {
      "name": "EnvironmentVariableService"
    },
    {
      "name": "SSHKeyService"
    },
    {
      "name": "ServiceAccountService"
    },
    {
      "name": "OAuth2Service"
    },
    {
      "name": "EnforcementService"
    },
    {
      "name": "VirtualMachineService"
    },
    {
      "name": "TicketService"
    },
    {
      "name": "MarketplaceService"
    },
    {
      "name": "FirewallService"
    },
    {
      "name": "ChatService"
    },
    {
      "name": "BackupService"
    },
    {
      "name": "SnapshotService"
    },
    {
      "name": "ClientDashboardService"
    },
    {
      "name": "ClientProviderReviewService"
    },
    {
      "name": "CloudInitUserDataService"
    },
    {
      "name": "InstantAppService"
    },
    {
      "name": "DnsZoneService"
    },
    {
      "name": "DnsRecordService"
    },
    {
      "name": "DnssecService"
    },
    {
      "name": "GameServerService"
    },
    {
      "name": "GameServerTemplateService"
    },
    {
      "name": "MetadataService"
    },
    {
      "name": "NotificationTemplateService"
    },
    {
      "name": "NotificationSettingService"
    },
    {
      "name": "DomainService"
    },
    {
      "name": "AgentService"
    },
    {
      "name": "MetricsCredentialService"
    },
    {
      "name": "PlatformService"
    },
    {
      "name": "NodeService"
    },
    {
      "name": "RegionService"
    },
    {
      "name": "NodePlacementService"
    },
    {
      "name": "VMTemplateService"
    },
    {
      "name": "CloudInitTemplateService"
    },
    {
      "name": "ProviderPlanService"
    },
    {
      "name": "ProviderConnectService"
    },
    {
      "name": "ProviderOnboardingService"
    },
    {
      "name": "ManualPayoutService"
    },
    {
      "name": "PayoutInvoiceService"
    },
    {
      "name": "PayoutConfigurationService"
    },
    {
      "name": "IPAMService"
    },
    {
      "name": "ProviderDashboardService"
    },
    {
      "name": "ProviderDashboardPlansTabService"
    },
    {
      "name": "ProviderCustomerService"
    },
    {
      "name": "PreflightService"
    },
    {
      "name": "LiveValidationService"
    },
    {
      "name": "ProviderReviewService"
    },
    {
      "name": "ProviderNetworkService"
    },
    {
      "name": "HookScriptService"
    },
    {
      "name": "ProviderTicketNotificationService"
    },
    {
      "name": "ProviderStorefrontService"
    },
    {
      "name": "RoadmapService"
    },
    {
      "name": "SubscriptionService"
    },
    {
      "name": "PlanService"
    },
    {
      "name": "UsageReportService"
    },
    {
      "name": "MetricService"
    },
    {
      "name": "AddonService"
    },
    {
      "name": "WebhookService"
    },
    {
      "name": "PaymentMethodService"
    },
    {
      "name": "InvoiceService"
    },
    {
      "name": "PaymentService"
    },
    {
      "name": "RefundService"
    },
    {
      "name": "CreditService"
    },
    {
      "name": "ExchangeRateService"
    },
    {
      "name": "CouponService"
    }
  ],
  "paths": {
    "/api/v1/webhooks/{provider}": {
      "post": {
        "summary": "Handle webhook events from payment providers (Stripe, PayPal, etc.)\nThis endpoint receives webhook payloads and processes payment/subscription\nevents Note: The actual implementation will read raw HTTP body and headers\ndirectly to support webhook signature verification",
        "operationId": "WebhookService_HandleWebhook",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1HandleWebhookResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "provider",
            "description": "Payment provider identifier (e.g., \"stripe\", \"paypal\")\nValidated in implementation to ensure supported providers",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookServiceHandleWebhookBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "WebhookService"
        ]
      }
    },
    "/v1/addon-subscriptions/{addonSubscriptionId}": {
      "delete": {
        "summary": "Remove an addon from a subscription.\ncancel_immediately=false keeps the add-on (and IP/backup) until the parent\nsubscription period ends; the renewal task then deprovisions it.",
        "operationId": "AddonService_RemoveAddon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1RemoveAddonResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "addonSubscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cancelImmediately",
            "description": "If false, cancels at period end",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "tags": [
          "AddonService"
        ]
      }
    },
    "/v1/addon-subscriptions/{addonSubscriptionId}:undo-cancel": {
      "post": {
        "summary": "UndoCancelAddon clears cancel_at_period_end so the add-on renews with the VM.",
        "operationId": "AddonService_UndoCancelAddon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1RemoveAddonResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "addonSubscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddonServiceUndoCancelAddonBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "AddonService"
        ]
      }
    },
    "/v1/addons": {
      "get": {
        "summary": "List available addons",
        "operationId": "AddonService_ListAddons",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListAddonsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "subscriptionId",
            "description": "Filter by compatible with subscription",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "addonType",
            "description": "Filter by type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "ADDON_TYPE_UNSPECIFIED",
                "ADDON_TYPE_BACKUP",
                "ADDON_TYPE_SNAPSHOT",
                "ADDON_TYPE_ADDITIONAL_IP"
              ],
              "default": "ADDON_TYPE_UNSPECIFIED"
            }
          },
          {
            "name": "isTemplate",
            "description": "Filter by template status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "billingType",
            "description": "Filter by billing type (usage-based or fixed/subscription)\n\n - BILLING_TYPE_PERCENTAGE: Percentage-based pricing (e.g., 30% of parent plan)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "BILLING_TYPE_UNSPECIFIED",
                "BILLING_TYPE_SUBSCRIPTION",
                "BILLING_TYPE_USAGE",
                "BILLING_TYPE_FREE",
                "BILLING_TYPE_PERCENTAGE"
              ],
              "default": "BILLING_TYPE_UNSPECIFIED"
            }
          },
          {
            "name": "search",
            "description": "Search filter for addon name, code, or description",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "AddonService"
        ]
      },
      "post": {
        "summary": "Create an addon from a template addon",
        "operationId": "AddonService_CreateAddon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateAddonRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "AddonService"
        ]
      }
    },
    "/v1/addons/{id}": {
      "get": {
        "summary": "Get a specific addon with its prices",
        "operationId": "AddonService_GetAddon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetAddonResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "AddonService"
        ]
      },
      "delete": {
        "summary": "Delete an addon (soft delete)",
        "operationId": "AddonService_DeleteAddon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "AddonService"
        ]
      },
      "patch": {
        "summary": "Update an addon (allows changing price and currency)",
        "operationId": "AddonService_UpdateAddon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddonServiceUpdateAddonBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "AddonService"
        ]
      }
    },
    "/v1/admin/coupons/high-risk": {
      "get": {
        "summary": "Platform admins only: high-risk coupons across all providers, most redeemed first.",
        "operationId": "CouponService_ListHighRiskCoupons",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListHighRiskCouponsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "providerOrganizationId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "includeInactive",
            "description": "Also list inactive and banned coupons.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/agents": {
      "get": {
        "operationId": "AgentService_ListAgents",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListAgentsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "gatewayRegion",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "AGENT_GATEWAY_REGION_UNSPECIFIED",
                "AGENT_GATEWAY_REGION_AMS01"
              ],
              "default": "AGENT_GATEWAY_REGION_UNSPECIFIED"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "AgentService"
        ]
      },
      "post": {
        "operationId": "AgentService_CreateAgent",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetAgentResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateAgentRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "AgentService"
        ]
      }
    },
    "/v1/agents/{id}": {
      "get": {
        "operationId": "AgentService_GetAgent",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetAgentResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "AgentService"
        ]
      },
      "delete": {
        "operationId": "AgentService_DeleteAgent",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "AgentService"
        ]
      },
      "patch": {
        "operationId": "AgentService_UpdateAgent",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdateAgentResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AgentServiceUpdateAgentBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "AgentService"
        ]
      }
    },
    "/v1/agents/{id}:generateInstallCommand": {
      "post": {
        "operationId": "AgentService_GenerateInstallCommand",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GenerateInstallCommandResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "description": "The ID of the agent to generate the install command for",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AgentServiceGenerateInstallCommandBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "AgentService"
        ]
      }
    },
    "/v1/agents/{id}:generatePeeringConfig": {
      "post": {
        "operationId": "AgentService_GeneratePeeringConfig",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GeneratePeeringConfigResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AgentServiceGeneratePeeringConfigBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "AgentService"
        ]
      }
    },
    "/v1/agents/{id}:uploadInboundPeeringConfig": {
      "post": {
        "operationId": "AgentService_UploadInboundPeeringConfig",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UploadInboundPeeringConfigResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AgentServiceUploadInboundPeeringConfigBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "AgentService"
        ]
      }
    },
    "/v1/auth/change-password": {
      "post": {
        "operationId": "UserService_ChangePassword",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1ChangePasswordRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/forgot-password": {
      "post": {
        "operationId": "UserService_ForgotPassword",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1ForgotPasswordRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/identities": {
      "get": {
        "operationId": "UserService_ListLinkedIdentities",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListLinkedIdentitiesResponse"
                }
              }
            }
          }
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/identities/{provider}": {
      "delete": {
        "operationId": "UserService_UnlinkIdentity",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/login": {
      "post": {
        "operationId": "UserService_Login",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1LoginResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1LoginRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/login/mfa": {
      "post": {
        "operationId": "UserService_LoginMfaVerify",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1LoginResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1LoginMfaVerifyRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/logout": {
      "post": {
        "operationId": "UserService_Logout",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1LogoutRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/mfa/backup-codes/regenerate": {
      "post": {
        "operationId": "UserService_RegenerateMfaBackupCodes",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1RegenerateMfaBackupCodesResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1RegenerateMfaBackupCodesRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/mfa/disable": {
      "post": {
        "operationId": "UserService_DisableMfa",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1DisableMfaRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/mfa/enroll": {
      "post": {
        "operationId": "UserService_EnrollMfaTotp",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1EnrollMfaTotpResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1EnrollMfaTotpRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/mfa/status": {
      "get": {
        "operationId": "UserService_GetMfaStatus",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetMfaStatusResponse"
                }
              }
            }
          }
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/mfa/verify-enrollment": {
      "post": {
        "operationId": "UserService_VerifyMfaEnrollment",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VerifyMfaEnrollmentResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1VerifyMfaEnrollmentRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/register": {
      "post": {
        "operationId": "UserService_RegisterUser",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1RegisterUserRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/resend-verification-email": {
      "post": {
        "operationId": "UserService_ResendVerificationEmail",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1ResendVerificationEmailRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/reset-password": {
      "post": {
        "operationId": "UserService_ResetPassword",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1ResetPasswordRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/sessions": {
      "get": {
        "operationId": "UserService_GetActiveSessions",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetActiveSessionsResponse"
                }
              }
            }
          }
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/set-password": {
      "post": {
        "operationId": "UserService_SetPassword",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1SetPasswordRequest"
              }
            }
          },
          "description": "SetPassword is for passwordless (SSO-only) accounts that have never set a local password.",
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/sso/exchange": {
      "post": {
        "operationId": "UserService_ExchangeSSOCode",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1LoginResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1ExchangeSSOCodeRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/sso/link": {
      "post": {
        "operationId": "UserService_CompleteSSOLink",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1LoginResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CompleteSSOLinkRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/auth/verify-email": {
      "get": {
        "operationId": "UserService_VerifyEmail",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "userId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/chat": {
      "post": {
        "summary": "Chat provides a non-streaming chat endpoint",
        "operationId": "ChatService_Chat",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ChatResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "$ref": "#/components/requestBodies/v1ChatRequest"
        },
        "tags": [
          "ChatService"
        ]
      }
    },
    "/v1/chat/anonymous": {
      "post": {
        "summary": "ChatAnonymous provides a non-streaming chat endpoint for anonymous users\nSession ID is extracted from the cookie header (managed by the frontend)",
        "operationId": "ChatService_ChatAnonymous",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ChatResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "$ref": "#/components/requestBodies/v1ChatRequest"
        },
        "tags": [
          "ChatService"
        ]
      }
    },
    "/v1/chat/conversations": {
      "get": {
        "summary": "ListConversations returns all conversation IDs for the authenticated user",
        "operationId": "ChatService_ListConversations",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListConversationsResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ChatService"
        ]
      }
    },
    "/v1/chat/conversations/{conversationId}": {
      "delete": {
        "summary": "DeleteConversation marks a conversation as deleted (soft delete)",
        "operationId": "ChatService_DeleteConversation",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "conversationId",
            "description": "Conversation ID",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ChatService"
        ]
      }
    },
    "/v1/chat/conversations/{conversationId}/history": {
      "get": {
        "summary": "GetConversationHistory returns the full message history for a conversation",
        "operationId": "ChatService_GetConversationHistory",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetConversationHistoryResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "conversationId",
            "description": "Conversation ID",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ChatService"
        ]
      }
    },
    "/v1/client/dashboard/billing": {
      "get": {
        "operationId": "ClientDashboardService_GetClientDashboardBilling",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetClientDashboardBillingResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ClientDashboardService"
        ]
      }
    },
    "/v1/client/dashboard/summary": {
      "get": {
        "operationId": "ClientDashboardService_GetClientDashboardSummary",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetClientDashboardSummaryResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ClientDashboardService"
        ]
      }
    },
    "/v1/client/provider-review-assets": {
      "get": {
        "operationId": "ClientProviderReviewService_ListClientProviderReviewAssets",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListClientProviderReviewAssetsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "search",
            "description": "Optional filter (hostname / provider name), case-insensitive substring.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ClientProviderReviewService"
        ]
      }
    },
    "/v1/cloudinittemplate": {
      "post": {
        "operationId": "CloudInitTemplateService_CreateCloudInitTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateCloudInitTemplateRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CloudInitTemplateService"
        ]
      }
    },
    "/v1/cloudinittemplate/{id}": {
      "get": {
        "operationId": "CloudInitTemplateService_GetCloudInitTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetCloudInitTemplateResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "CloudInitTemplateService"
        ]
      },
      "delete": {
        "operationId": "CloudInitTemplateService_DeleteCloudInitTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "CloudInitTemplateService"
        ]
      },
      "patch": {
        "operationId": "CloudInitTemplateService_UpdateCloudInitTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdateCloudInitTemplateResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CloudInitTemplateServiceUpdateCloudInitTemplateBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CloudInitTemplateService"
        ]
      }
    },
    "/v1/cloudinittemplates": {
      "get": {
        "operationId": "CloudInitTemplateService_ListCloudInitTemplates",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListCloudInitTemplatesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filterIsTemplate",
            "description": "If not set, returns both template and non-template. If true, returns only templates. If false, returns only non-templates.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "tags": [
          "CloudInitTemplateService"
        ]
      }
    },
    "/v1/cloudinituserdata": {
      "get": {
        "operationId": "CloudInitUserDataService_ListCloudInitUserData",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListCloudInitUserDataResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "CloudInitUserDataService"
        ]
      },
      "post": {
        "operationId": "CloudInitUserDataService_CreateCloudInitUserData",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CloudInitUserData"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateCloudInitUserDataRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CloudInitUserDataService"
        ]
      }
    },
    "/v1/cloudinituserdata/{id}": {
      "get": {
        "operationId": "CloudInitUserDataService_GetCloudInitUserData",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CloudInitUserData"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "CloudInitUserDataService"
        ]
      },
      "delete": {
        "operationId": "CloudInitUserDataService_DeleteCloudInitUserData",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "CloudInitUserDataService"
        ]
      },
      "patch": {
        "operationId": "CloudInitUserDataService_UpdateCloudInitUserData",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CloudInitUserData"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CloudInitUserDataServiceUpdateCloudInitUserDataBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CloudInitUserDataService"
        ]
      }
    },
    "/v1/countries-cities": {
      "get": {
        "operationId": "RegionService_ListCountriesCities",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListCountriesCitiesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "RegionService"
        ]
      }
    },
    "/v1/coupon-codes/{id}": {
      "patch": {
        "operationId": "CouponService_UpdateCouponCode",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CouponCode"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CouponServiceUpdateCouponCodeBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/coupons": {
      "get": {
        "operationId": "CouponService_ListCoupons",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListCouponsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "assetType",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expiringSoon",
            "description": "Only coupons whose validity ends within 14 days.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "CouponService"
        ]
      },
      "post": {
        "operationId": "CouponService_CreateCoupon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateCouponResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateCouponRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/coupons/{couponId}/code-batches": {
      "get": {
        "operationId": "CouponService_ListCouponCodeBatches",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListCouponCodeBatchesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "couponId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/coupons/{couponId}/code-batches/{batchId}": {
      "get": {
        "operationId": "CouponService_GetCouponCodeBatch",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CouponCodeBatch"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "couponId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "batchId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/coupons/{couponId}/codes": {
      "get": {
        "operationId": "CouponService_ListCouponCodes",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListCouponCodesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "couponId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "batchId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "campaign",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "channel",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "CouponService"
        ]
      },
      "post": {
        "operationId": "CouponService_CreateCouponCode",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CouponCode"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "couponId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CouponServiceCreateCouponCodeBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/coupons/{couponId}/codes:export": {
      "get": {
        "operationId": "CouponService_ExportCouponCodes",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ExportCouponCodesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "couponId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "batchId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/coupons/{couponId}/codes:generate": {
      "post": {
        "operationId": "CouponService_GenerateCouponCodes",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GenerateCouponCodesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "couponId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CouponServiceGenerateCouponCodesBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/coupons/{couponId}/redemptions": {
      "get": {
        "operationId": "CouponService_ListCouponRedemptions",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListCouponRedemptionsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "couponId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "assetType",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/coupons/{couponId}/report": {
      "get": {
        "summary": "Attribution and ROI figures, grouped by code, campaign, channel, or asset type.",
        "operationId": "CouponService_GetCouponReport",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetCouponReportResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "couponId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "groupBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "COUPON_REPORT_GROUP_BY_UNSPECIFIED",
                "COUPON_REPORT_GROUP_BY_CODE",
                "COUPON_REPORT_GROUP_BY_CAMPAIGN",
                "COUPON_REPORT_GROUP_BY_CHANNEL",
                "COUPON_REPORT_GROUP_BY_ASSET_TYPE"
              ],
              "default": "COUPON_REPORT_GROUP_BY_UNSPECIFIED"
            }
          },
          {
            "name": "code",
            "description": "Narrow the report to one code, campaign, or channel.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "campaign",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "channel",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "startTime",
            "description": "Applications created in [start_time, end_time); open ends are unbounded.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "endTime",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/coupons/{id}": {
      "get": {
        "operationId": "CouponService_GetCoupon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1Coupon"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "CouponService"
        ]
      },
      "patch": {
        "operationId": "CouponService_UpdateCoupon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1Coupon"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CouponServiceUpdateCouponBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/coupons/{id}:deactivate": {
      "post": {
        "summary": "Blocks new attachments; customers keep the periods they were promised.",
        "operationId": "CouponService_DeactivateCoupon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1Coupon"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CouponServiceDeactivateCouponBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/coupons/{id}:revoke": {
      "post": {
        "summary": "Ends the discount for every customer from their next invoice.",
        "operationId": "CouponService_RevokeCoupon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1RevokeCouponResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CouponServiceRevokeCouponBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/coupons:preview": {
      "post": {
        "summary": "Checks a code against a plan without attaching it.",
        "operationId": "CouponService_PreviewCoupon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1PreviewCouponResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1PreviewCouponRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/credits/balance": {
      "get": {
        "operationId": "CreditService_GetCreditBalance",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetCreditBalanceResponse"
                }
              }
            }
          }
        },
        "tags": [
          "CreditService"
        ]
      }
    },
    "/v1/credits/ledger": {
      "get": {
        "operationId": "CreditService_ListCreditLedgerEntries",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListCreditLedgerEntriesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "entryType",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "CREDIT_LEDGER_ENTRY_TYPE_UNSPECIFIED",
                "CREDIT_LEDGER_ENTRY_TYPE_PURCHASE",
                "CREDIT_LEDGER_ENTRY_TYPE_PROMOTIONAL",
                "CREDIT_LEDGER_ENTRY_TYPE_PROVISION_RESERVE",
                "CREDIT_LEDGER_ENTRY_TYPE_PROVISION_RELEASE",
                "CREDIT_LEDGER_ENTRY_TYPE_USAGE_HOLD",
                "CREDIT_LEDGER_ENTRY_TYPE_HOLD_RELEASE",
                "CREDIT_LEDGER_ENTRY_TYPE_INVOICE_SETTLEMENT",
                "CREDIT_LEDGER_ENTRY_TYPE_CHARGEBACK_REVERSAL",
                "CREDIT_LEDGER_ENTRY_TYPE_EXPIRY",
                "CREDIT_LEDGER_ENTRY_TYPE_FORFEITURE",
                "CREDIT_LEDGER_ENTRY_TYPE_MANUAL_ADJUSTMENT"
              ],
              "default": "CREDIT_LEDGER_ENTRY_TYPE_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "CreditService"
        ]
      }
    },
    "/v1/credits/promo": {
      "get": {
        "operationId": "CreditService_ListPromoCreditGrants",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListPromoCreditGrantsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "CreditService"
        ]
      }
    },
    "/v1/credits:purchase": {
      "post": {
        "operationId": "CreditService_PurchaseCredits",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1PurchaseCreditsResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1PurchaseCreditsRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CreditService"
        ]
      }
    },
    "/v1/credits:redeemPromoCode": {
      "post": {
        "operationId": "CreditService_RedeemPromoCode",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1RedeemPromoCodeResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1RedeemPromoCodeRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CreditService"
        ]
      }
    },
    "/v1/datacenters": {
      "get": {
        "operationId": "RegionService_ListDatacenters",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListDatacentersResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "RegionService"
        ]
      }
    },
    "/v1/distros": {
      "get": {
        "summary": "ListDistros returns the guest OS catalog used by the virtual machine image picker.",
        "operationId": "MetadataService_ListDistros",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListDistrosResponse"
                }
              }
            }
          }
        },
        "tags": [
          "MetadataService"
        ]
      }
    },
    "/v1/dns/geo-locations": {
      "get": {
        "operationId": "DnsRecordService_ListDnsGeoLocations",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListDnsGeoLocationsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "kind",
            "description": "Optional filter: continent, country, region, or group.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "DnsRecordService"
        ]
      }
    },
    "/v1/dns/scan": {
      "get": {
        "operationId": "DnsZoneService_ScanDnsZoneRecords",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ScanDnsZoneRecordsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "zoneId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "DnsZoneService"
        ]
      }
    },
    "/v1/dns/zones": {
      "get": {
        "operationId": "DnsZoneService_ListDnsZones",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListDnsZonesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "DnsZoneService"
        ]
      },
      "post": {
        "operationId": "DnsZoneService_CreateDnsZone",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateDnsZoneResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateDnsZoneRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "DnsZoneService"
        ]
      }
    },
    "/v1/dns/zones/{id}": {
      "get": {
        "operationId": "DnsZoneService_GetDnsZone",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetDnsZoneResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "DnsZoneService"
        ]
      },
      "delete": {
        "operationId": "DnsZoneService_DeleteDnsZone",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "force",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "tags": [
          "DnsZoneService"
        ]
      }
    },
    "/v1/dns/zones/{id}/check-delegation": {
      "post": {
        "operationId": "DnsZoneService_CheckDnsZoneDelegation",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetDnsZoneResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DnsZoneServiceCheckDnsZoneDelegationBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "DnsZoneService"
        ]
      }
    },
    "/v1/dns/zones/{id}/export": {
      "get": {
        "operationId": "DnsZoneService_ExportDnsZone",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ExportDnsZoneResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "DnsZoneService"
        ]
      }
    },
    "/v1/dns/zones/{id}/import": {
      "post": {
        "operationId": "DnsZoneService_ImportDnsZone",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DnsZoneServiceImportDnsZoneBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "DnsZoneService"
        ]
      }
    },
    "/v1/dns/zones/{zoneId}/dnssec": {
      "get": {
        "operationId": "DnssecService_GetDnssec",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1DnssecInfo"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "zoneId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "DnssecService"
        ]
      }
    },
    "/v1/dns/zones/{zoneId}/dnssec/check-ds": {
      "post": {
        "operationId": "DnssecService_CheckDnssecDs",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1DnssecInfo"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "zoneId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DnssecServiceCheckDnssecDsBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "DnssecService"
        ]
      }
    },
    "/v1/dns/zones/{zoneId}/dnssec/disable": {
      "post": {
        "operationId": "DnssecService_DisableDnssec",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1DnssecInfo"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "zoneId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DnssecServiceDisableDnssecBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "DnssecService"
        ]
      }
    },
    "/v1/dns/zones/{zoneId}/dnssec/enable": {
      "post": {
        "operationId": "DnssecService_EnableDnssec",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1DnssecInfo"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "zoneId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DnssecServiceEnableDnssecBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "DnssecService"
        ]
      }
    },
    "/v1/dns/zones/{zoneId}/geo-records": {
      "get": {
        "operationId": "DnsRecordService_ListDnsGeoRecords",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListDnsGeoRecordsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "zoneId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "DnsRecordService"
        ]
      },
      "delete": {
        "operationId": "DnsRecordService_DeleteDnsGeoRecord",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "zoneId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "DnsRecordService"
        ]
      },
      "put": {
        "operationId": "DnsRecordService_UpsertDnsGeoRecord",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1DnsGeoRecord"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "zoneId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DnsRecordServiceUpsertDnsGeoRecordBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "DnsRecordService"
        ]
      }
    },
    "/v1/dns/zones/{zoneId}/geo-records:check": {
      "post": {
        "operationId": "DnsRecordService_CheckDnsGeoRecord",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CheckDnsGeoRecordResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "zoneId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DnsRecordServiceCheckDnsGeoRecordBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "DnsRecordService"
        ]
      }
    },
    "/v1/dns/zones/{zoneId}/geo-records:get": {
      "get": {
        "operationId": "DnsRecordService_GetDnsGeoRecord",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1DnsGeoRecord"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "zoneId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "DnsRecordService"
        ]
      }
    },
    "/v1/dns/zones/{zoneId}/records": {
      "get": {
        "operationId": "DnsRecordService_ListDnsRecords",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListDnsRecordsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "zoneId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "DnsRecordService"
        ]
      },
      "delete": {
        "operationId": "DnsRecordService_DeleteDnsRecord",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "zoneId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "DnsRecordService"
        ]
      },
      "put": {
        "operationId": "DnsRecordService_UpsertDnsRecord",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1DnsRecord"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "zoneId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DnsRecordServiceUpsertDnsRecordBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "DnsRecordService"
        ]
      }
    },
    "/v1/dns/zones/{zoneId}/records:import": {
      "post": {
        "operationId": "DnsZoneService_ImportDnsRecords",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "zoneId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DnsZoneServiceImportDnsRecordsBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "DnsZoneService"
        ]
      }
    },
    "/v1/dns/zones/{zoneId}/scan": {
      "get": {
        "operationId": "DnsZoneService_ScanDnsZoneRecords2",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ScanDnsZoneRecordsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "zoneId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "DnsZoneService"
        ]
      }
    },
    "/v1/domain": {
      "get": {
        "operationId": "DomainService_GetDomain",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetDomainResponse"
                }
              }
            }
          }
        },
        "tags": [
          "DomainService"
        ]
      },
      "post": {
        "operationId": "DomainService_CreateDomain",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateDomainRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "DomainService"
        ]
      }
    },
    "/v1/domain/verify/{id}": {
      "get": {
        "operationId": "DomainService_VerifyDomain",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "DomainService"
        ]
      }
    },
    "/v1/domain/{id}": {
      "delete": {
        "operationId": "DomainService_DeleteDomain",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "DomainService"
        ]
      }
    },
    "/v1/environment-variables": {
      "get": {
        "operationId": "EnvironmentVariableService_ListEnvironmentVariables",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListEnvironmentVariablesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filterKey",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "EnvironmentVariableService"
        ]
      },
      "post": {
        "operationId": "EnvironmentVariableService_CreateEnvironmentVariable",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateEnvironmentVariableRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "EnvironmentVariableService"
        ]
      }
    },
    "/v1/environment-variables/{id}": {
      "get": {
        "operationId": "EnvironmentVariableService_GetEnvironmentVariable",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetEnvironmentVariableResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "EnvironmentVariableService"
        ]
      },
      "delete": {
        "operationId": "EnvironmentVariableService_DeleteEnvironmentVariable",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "EnvironmentVariableService"
        ]
      },
      "patch": {
        "operationId": "EnvironmentVariableService_UpdateEnvironmentVariable",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnvironmentVariableServiceUpdateEnvironmentVariableBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "EnvironmentVariableService"
        ]
      }
    },
    "/v1/exchange-rate/convert": {
      "post": {
        "summary": "Convert an amount from USD to a target currency",
        "operationId": "ExchangeRateService_ConvertCurrency",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ConvertCurrencyResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1ConvertCurrencyRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ExchangeRateService"
        ]
      }
    },
    "/v1/exchange-rate/currencies": {
      "get": {
        "summary": "List all supported currency codes",
        "operationId": "ExchangeRateService_ListSupportedCurrencies",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListSupportedCurrenciesResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ExchangeRateService"
        ]
      }
    },
    "/v1/exchange-rate/rate/{currencyCode}": {
      "get": {
        "summary": "Get the current exchange rate for a specific currency (from USD)",
        "operationId": "ExchangeRateService_GetExchangeRate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetExchangeRateResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "currencyCode",
            "description": "Currency code to get exchange rate for (from USD)",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ExchangeRateService"
        ]
      }
    },
    "/v1/exchange-rate/rates": {
      "get": {
        "summary": "Get all exchange rates at once (returns map of currency codes to rates)",
        "operationId": "ExchangeRateService_GetAllExchangeRates",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetAllExchangeRatesResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ExchangeRateService"
        ]
      }
    },
    "/v1/firewall/address-groups": {
      "get": {
        "operationId": "FirewallService_ListFirewallAddressGroups",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListFirewallAddressGroupsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "name",
            "description": "Note: family filter removed as address groups can now contain mixed IPv4/IPv6",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "FirewallService"
        ]
      },
      "post": {
        "operationId": "FirewallService_CreateFirewallAddressGroup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateFirewallAddressGroupRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "FirewallService"
        ]
      }
    },
    "/v1/firewall/address-groups/{id}": {
      "get": {
        "operationId": "FirewallService_GetFirewallAddressGroup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1FirewallAddressGroup"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "FirewallService"
        ]
      },
      "delete": {
        "operationId": "FirewallService_DeleteFirewallAddressGroup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "FirewallService"
        ]
      },
      "patch": {
        "operationId": "FirewallService_UpdateFirewallAddressGroup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1FirewallAddressGroup"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FirewallServiceUpdateFirewallAddressGroupBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "FirewallService"
        ]
      }
    },
    "/v1/firewall/rules/{id}": {
      "get": {
        "operationId": "FirewallService_GetFirewallRule",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1FirewallRuleResource"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "direction",
            "description": "Optional: Filter by direction. If not specified, returns the rule regardless of direction.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "FIREWALL_DIRECTION_UNSPECIFIED",
                "FIREWALL_DIRECTION_INGRESS",
                "FIREWALL_DIRECTION_EGRESS"
              ],
              "default": "FIREWALL_DIRECTION_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "FirewallService"
        ]
      },
      "delete": {
        "operationId": "FirewallService_DeleteFirewallRule",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "FirewallService"
        ]
      },
      "patch": {
        "operationId": "FirewallService_UpdateFirewallRule",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1FirewallRuleResource"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FirewallServiceUpdateFirewallRuleBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "FirewallService"
        ]
      }
    },
    "/v1/firewall/rules/{id}/move": {
      "post": {
        "operationId": "FirewallService_MoveFirewallRule",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1FirewallRuleResource"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "description": "ID of the rule to move",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FirewallServiceMoveFirewallRuleBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "FirewallService"
        ]
      }
    },
    "/v1/firewall/rulesets": {
      "get": {
        "operationId": "FirewallService_ListFirewallRuleSets",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListFirewallRuleSetsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterAttachment",
            "description": "Optional: Filter by whether any virtual machine is attached to the ruleset.\n\n - FIREWALL_RULESET_ATTACHMENT_FILTER_UNSPECIFIED: All rulesets\n - FIREWALL_RULESET_ATTACHMENT_FILTER_ATTACHED: Rulesets with at least one VM attached\n - FIREWALL_RULESET_ATTACHMENT_FILTER_UNATTACHED: Rulesets with no VMs attached",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "FIREWALL_RULESET_ATTACHMENT_FILTER_UNSPECIFIED",
                "FIREWALL_RULESET_ATTACHMENT_FILTER_ATTACHED",
                "FIREWALL_RULESET_ATTACHMENT_FILTER_UNATTACHED"
              ],
              "default": "FIREWALL_RULESET_ATTACHMENT_FILTER_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "FirewallService"
        ]
      },
      "post": {
        "operationId": "FirewallService_CreateFirewallRuleSet",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateFirewallRuleSetRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "FirewallService"
        ]
      }
    },
    "/v1/firewall/rulesets/{id}": {
      "get": {
        "operationId": "FirewallService_GetFirewallRuleSet",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1FirewallRuleSet"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "FirewallService"
        ]
      },
      "delete": {
        "operationId": "FirewallService_DeleteFirewallRuleSet",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "force",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "tags": [
          "FirewallService"
        ]
      },
      "patch": {
        "operationId": "FirewallService_UpdateFirewallRuleSet",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1FirewallRuleSet"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FirewallServiceUpdateFirewallRuleSetBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "FirewallService"
        ]
      }
    },
    "/v1/firewall/rulesets/{rulesetId}/rules": {
      "get": {
        "operationId": "FirewallService_ListFirewallRules",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListFirewallRulesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "rulesetId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "direction",
            "description": "Optional: Filter by direction. If not specified, returns all rules regardless of direction.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "FIREWALL_DIRECTION_UNSPECIFIED",
                "FIREWALL_DIRECTION_INGRESS",
                "FIREWALL_DIRECTION_EGRESS"
              ],
              "default": "FIREWALL_DIRECTION_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "FirewallService"
        ]
      },
      "post": {
        "operationId": "FirewallService_CreateFirewallRule",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "rulesetId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FirewallServiceCreateFirewallRuleBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "FirewallService"
        ]
      }
    },
    "/v1/game-server-templates": {
      "get": {
        "operationId": "GameServerTemplateService_ListGameServerTemplates",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListGameServerTemplatesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "platformId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerTemplateService"
        ]
      }
    },
    "/v1/game-server-templates/{id}": {
      "patch": {
        "operationId": "GameServerTemplateService_UpdateGameServerTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServerTemplate"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerTemplateServiceUpdateGameServerTemplateBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerTemplateService"
        ]
      }
    },
    "/v1/game-server-templates/{id}:duplicate": {
      "post": {
        "operationId": "GameServerTemplateService_DuplicateGameServerTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServerTemplate"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerTemplateServiceDuplicateGameServerTemplateBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerTemplateService"
        ]
      }
    },
    "/v1/game-server-templates:import": {
      "post": {
        "operationId": "GameServerTemplateService_ImportGameServerTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServerTemplate"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1ImportGameServerTemplateRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerTemplateService"
        ]
      }
    },
    "/v1/game-server-templates:nest-ordering": {
      "post": {
        "operationId": "GameServerTemplateService_SetGameNestOrdering",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1SetGameNestOrderingRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerTemplateService"
        ]
      }
    },
    "/v1/game-servers": {
      "get": {
        "operationId": "GameServerService_ListGameServers",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListGameServersResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      },
      "post": {
        "operationId": "GameServerService_CreateGameServer",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServer"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateGameServerRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}": {
      "get": {
        "operationId": "GameServerService_GetGameServer",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServer"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      },
      "delete": {
        "operationId": "GameServerService_DeleteGameServer",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/allocations": {
      "get": {
        "operationId": "GameServerService_ListAllocations",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListGameServerAllocationsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      },
      "post": {
        "operationId": "GameServerService_CreateAllocation",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServerAllocation"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceCreateAllocationBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/allocations/{allocationId}": {
      "delete": {
        "operationId": "GameServerService_DeleteAllocation",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "allocationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      },
      "post": {
        "operationId": "GameServerService_UpdateAllocation",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServerAllocation"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "allocationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceUpdateAllocationBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/allocations/{allocationId}:primary": {
      "post": {
        "operationId": "GameServerService_SetPrimaryAllocation",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "allocationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceSetPrimaryAllocationBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/backups": {
      "get": {
        "operationId": "GameServerService_ListBackups",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListGameServerBackupsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      },
      "post": {
        "operationId": "GameServerService_CreateBackup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServerBackup"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceCreateBackupBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/backups/{backupUuid}": {
      "delete": {
        "operationId": "GameServerService_DeleteBackup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "backupUuid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "truncate",
            "description": "Restore only. When true, the panel deletes every file before extracting the backup.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/backups/{backupUuid}:lock": {
      "post": {
        "operationId": "GameServerService_LockBackup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "backupUuid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceLockBackupBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/backups/{backupUuid}:restore": {
      "post": {
        "operationId": "GameServerService_RestoreBackup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "backupUuid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1GameServerServiceRestoreBackupBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/databases": {
      "get": {
        "operationId": "GameServerService_ListDatabases",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListDatabasesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      },
      "post": {
        "operationId": "GameServerService_CreateDatabase",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServerDatabase"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceCreateDatabaseBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/databases/{databaseId}": {
      "delete": {
        "operationId": "GameServerService_DeleteDatabase",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "databaseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/databases/{databaseId}:rotate": {
      "post": {
        "operationId": "GameServerService_RotateDatabasePassword",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServerDatabase"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "databaseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceRotateDatabasePasswordBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/docker-image": {
      "put": {
        "operationId": "GameServerService_UpdateDockerImage",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceUpdateDockerImageBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/files": {
      "get": {
        "operationId": "GameServerService_ListFiles",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListFilesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "directory",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      },
      "put": {
        "operationId": "GameServerService_WriteFile",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceWriteFileBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/files/content": {
      "get": {
        "operationId": "GameServerService_ReadFile",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ReadFileResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "path",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/files/download": {
      "get": {
        "operationId": "GameServerService_DownloadFile",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1DownloadFileResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "path",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/files:archive": {
      "post": {
        "operationId": "GameServerService_ArchiveFiles",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ArchiveFilesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceArchiveFilesBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/files:copy": {
      "post": {
        "operationId": "GameServerService_CopyFile",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceCopyFileBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/files:delete": {
      "post": {
        "operationId": "GameServerService_DeleteFiles",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceDeleteFilesBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/files:folder": {
      "post": {
        "operationId": "GameServerService_CreateFolder",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceCreateFolderBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/files:rename": {
      "post": {
        "operationId": "GameServerService_RenameFile",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceRenameFileBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/files:upload": {
      "post": {
        "operationId": "GameServerService_UploadFile",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceUploadFileBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/resources": {
      "get": {
        "operationId": "GameServerService_GetGameServerResources",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServerResources"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/schedules": {
      "get": {
        "operationId": "GameServerService_ListSchedules",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListSchedulesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      },
      "post": {
        "operationId": "GameServerService_CreateSchedule",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServerSchedule"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceCreateScheduleBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/schedules/{scheduleId}": {
      "delete": {
        "operationId": "GameServerService_DeleteSchedule",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "scheduleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      },
      "post": {
        "operationId": "GameServerService_UpdateSchedule",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServerSchedule"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "scheduleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceUpdateScheduleBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/schedules/{scheduleId}/tasks": {
      "post": {
        "operationId": "GameServerService_CreateScheduleTask",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "scheduleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceCreateScheduleTaskBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/schedules/{scheduleId}/tasks/{taskId}": {
      "delete": {
        "operationId": "GameServerService_DeleteScheduleTask",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "scheduleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      },
      "post": {
        "operationId": "GameServerService_UpdateScheduleTask",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "scheduleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceUpdateScheduleTaskBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/schedules/{scheduleId}:execute": {
      "post": {
        "operationId": "GameServerService_ExecuteSchedule",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "scheduleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceExecuteScheduleBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}/startup": {
      "get": {
        "operationId": "GameServerService_GetStartup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetStartupResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      },
      "put": {
        "operationId": "GameServerService_UpdateStartupVariable",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceUpdateStartupVariableBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}:changeGame": {
      "post": {
        "operationId": "GameServerService_ChangeGameServerGame",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServer"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceChangeGameServerGameBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}:console": {
      "post": {
        "operationId": "GameServerService_OpenConsole",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1OpenConsoleResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceOpenConsoleBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}:power": {
      "post": {
        "operationId": "GameServerService_PowerGameServer",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServer"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServicePowerGameServerBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}:reinstall": {
      "post": {
        "operationId": "GameServerService_ReinstallGameServer",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServer"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceReinstallGameServerBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers/{id}:rename": {
      "post": {
        "operationId": "GameServerService_RenameGameServer",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GameServer"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GameServerServiceRenameGameServerBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/game-servers:order-games": {
      "get": {
        "operationId": "GameServerService_ListOrderGames",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListOrderGamesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "planId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GameServerService"
        ]
      }
    },
    "/v1/groups": {
      "get": {
        "operationId": "GroupService_ListGroups",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListGroupsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filterName",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterStatus",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "STATUS_UNSPECIFIED",
                "STATUS_ACTIVE",
                "STATUS_INACTIVE",
                "STATUS_BANNED",
                "STATUS_SOFT_DELETED"
              ],
              "default": "STATUS_UNSPECIFIED"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GroupService"
        ]
      },
      "post": {
        "operationId": "GroupService_CreateGroup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateGroupRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GroupService"
        ]
      }
    },
    "/v1/groups/add-service-account": {
      "post": {
        "operationId": "GroupService_AddServiceAccountToGroup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1AddServiceAccountToGroupRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GroupService"
        ]
      }
    },
    "/v1/groups/add-user": {
      "post": {
        "operationId": "GroupService_AddUserToGroup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1AddUserToGroupRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GroupService"
        ]
      }
    },
    "/v1/groups/remove-service-account": {
      "delete": {
        "operationId": "GroupService_RemoveServiceAccountFromGroup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "groupId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "serviceAccountIds",
            "in": "query",
            "required": false,
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        ],
        "tags": [
          "GroupService"
        ]
      }
    },
    "/v1/groups/remove-user": {
      "delete": {
        "operationId": "GroupService_RemoveUserFromGroup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "groupId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "userIds",
            "in": "query",
            "required": false,
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        ],
        "tags": [
          "GroupService"
        ]
      }
    },
    "/v1/groups/{id}": {
      "get": {
        "operationId": "GroupService_GetGroup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetGroupResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GroupService"
        ]
      },
      "delete": {
        "operationId": "GroupService_DeleteGroup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "GroupService"
        ]
      },
      "patch": {
        "operationId": "GroupService_UpdateGroup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdateGroupResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GroupServiceUpdateGroupBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "GroupService"
        ]
      }
    },
    "/v1/healthz": {
      "get": {
        "operationId": "MetadataService_HealthCheck",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1HealthCheckResponse"
                }
              }
            }
          }
        },
        "tags": [
          "MetadataService"
        ]
      }
    },
    "/v1/hook-scripts": {
      "get": {
        "operationId": "HookScriptService_ListHookScripts",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListHookScriptsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "subject",
            "description": "Unspecified lists VM scripts, which is the previous behavior.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "HOOK_SUBJECT_UNSPECIFIED",
                "HOOK_SUBJECT_VM",
                "HOOK_SUBJECT_GAMESERVER"
              ],
              "default": "HOOK_SUBJECT_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "HookScriptService"
        ]
      },
      "put": {
        "operationId": "HookScriptService_UpsertHookScript",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1HookScript"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1UpsertHookScriptRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "HookScriptService"
        ]
      }
    },
    "/v1/hook-scripts/{id}": {
      "delete": {
        "operationId": "HookScriptService_DeleteHookScript",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "HookScriptService"
        ]
      }
    },
    "/v1/instantapps": {
      "get": {
        "operationId": "InstantAppService_ListInstantApps",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListInstantAppsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "description": "-1 returns all apps (create/reinstall picker); otherwise 1..100.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "query",
            "description": "Case-insensitive match on name or slug.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "categories",
            "description": "Filter: app must include all listed categories when non-empty.",
            "in": "query",
            "required": false,
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "distro",
            "description": " - DISTRO_UBUNTU_22_04: Ubuntu distributions\n - DISTRO_FEDORA_43: Fedora distributions\n - DISTRO_DEBIAN_12: Debian distributions\n - DISTRO_CENTOS_9: CentOS distributions\n - DISTRO_ROCKY_9: Rocky Linux distributions\n - DISTRO_ALMALINUX_9: AlmaLinux distributions",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "DISTRO_UNSPECIFIED",
                "DISTRO_UBUNTU_22_04",
                "DISTRO_UBUNTU_24_04",
                "DISTRO_UBUNTU_26_04",
                "DISTRO_FEDORA_43",
                "DISTRO_FEDORA_44",
                "DISTRO_DEBIAN_12",
                "DISTRO_DEBIAN_13",
                "DISTRO_CENTOS_9",
                "DISTRO_CENTOS_10",
                "DISTRO_ROCKY_9",
                "DISTRO_ROCKY_10",
                "DISTRO_ALMALINUX_9",
                "DISTRO_ALMALINUX_10"
              ],
              "default": "DISTRO_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "InstantAppService"
        ]
      }
    },
    "/v1/instantapps/slug/{slug}": {
      "get": {
        "operationId": "InstantAppService_GetInstantApp2",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1InstantApp"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "description": "Exactly one of id or slug must be set.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "InstantAppService"
        ]
      }
    },
    "/v1/instantapps/{id}": {
      "get": {
        "operationId": "InstantAppService_GetInstantApp",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1InstantApp"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "description": "Exactly one of id or slug must be set.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "InstantAppService"
        ]
      }
    },
    "/v1/invites": {
      "get": {
        "operationId": "InviteService_ListInvites",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListInvitesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filterEmail",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "InviteService"
        ]
      },
      "post": {
        "operationId": "InviteService_CreateInvite",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateInviteRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "InviteService"
        ]
      },
      "patch": {
        "operationId": "InviteService_UpdateInvite",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1UpdateInviteRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "InviteService"
        ]
      }
    },
    "/v1/invites/accept": {
      "get": {
        "operationId": "InviteService_AcceptInvite",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "inviteId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "InviteService"
        ]
      }
    },
    "/v1/invites/decline": {
      "get": {
        "operationId": "InviteService_DeclineInvite",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "inviteId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "InviteService"
        ]
      }
    },
    "/v1/invites/me": {
      "get": {
        "operationId": "InviteService_ListMyInvites",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListMyInvitesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "InviteService"
        ]
      }
    },
    "/v1/invites/resend/{inviteId}": {
      "post": {
        "operationId": "InviteService_ResendInvite",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "inviteId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "InviteService"
        ]
      }
    },
    "/v1/invites/{id}": {
      "delete": {
        "operationId": "InviteService_DeleteInvite",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "InviteService"
        ]
      }
    },
    "/v1/invoices": {
      "get": {
        "summary": "ListInvoices lists invoices for a subscription or organization",
        "operationId": "InvoiceService_ListInvoices",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListInvoicesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "INVOICE_STATUS_UNSPECIFIED",
                "INVOICE_STATUS_DRAFT",
                "INVOICE_STATUS_OPEN",
                "INVOICE_STATUS_PAID",
                "INVOICE_STATUS_PAST_DUE",
                "INVOICE_STATUS_VOID",
                "INVOICE_STATUS_UNCOLLECTIBLE"
              ],
              "default": "INVOICE_STATUS_UNSPECIFIED"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "orderBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "InvoiceService"
        ]
      }
    },
    "/v1/invoices/{invoiceId}": {
      "get": {
        "summary": "GetInvoice retrieves a single invoice with line items",
        "operationId": "InvoiceService_GetInvoice",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetInvoiceResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "invoiceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "InvoiceService"
        ]
      }
    },
    "/v1/invoices/{invoiceId}:pay": {
      "post": {
        "summary": "PayInvoice charges the organization's default card for an open or past-due\ninvoice and returns the updated invoice. Idempotent when the invoice is\nalready paid.",
        "operationId": "InvoiceService_PayInvoice",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1PayInvoiceResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "invoiceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InvoiceServicePayInvoiceBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "InvoiceService"
        ]
      }
    },
    "/v1/ipam/allocations": {
      "get": {
        "summary": "IP Allocation (read-only - allocations are managed automatically)",
        "operationId": "IPAMService_ListAllocations",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListAllocationsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "prefixId",
            "description": "Filter by prefix ID (required for filtering allocations)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/networks": {
      "get": {
        "operationId": "IPAMService_ListNetworks",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListNetworksResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "IPAMService"
        ]
      },
      "post": {
        "summary": "IPAM Network management",
        "operationId": "IPAMService_CreateNetwork",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateNetworkRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/networks/{id}": {
      "get": {
        "operationId": "IPAMService_GetNetwork",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetNetworkResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "IPAMService"
        ]
      },
      "delete": {
        "operationId": "IPAMService_DeleteNetwork",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "IPAMService"
        ]
      },
      "patch": {
        "operationId": "IPAMService_UpdateNetwork",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdateNetworkResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IPAMServiceUpdateNetworkBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/networks/{networkId}/assign-node": {
      "post": {
        "summary": "Node-Network assignment",
        "operationId": "IPAMService_AssignNetworkToNode",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "networkId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IPAMServiceAssignNetworkToNodeBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/networks/{networkId}/nodes": {
      "get": {
        "operationId": "IPAMService_ListNetworkNodes",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListNetworkNodesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "networkId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/nodes/{nodeId}/network": {
      "get": {
        "operationId": "IPAMService_GetNodeNetwork",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetNodeNetworkResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "nodeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/nodes/{nodeId}/unassign-network": {
      "post": {
        "operationId": "IPAMService_UnassignNetworkFromNode",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "nodeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/prefixes": {
      "get": {
        "operationId": "IPAMService_ListPrefixes",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListPrefixesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filterNetworkId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "IPAMService"
        ]
      },
      "post": {
        "summary": "Prefix management",
        "operationId": "IPAMService_CreatePrefix",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreatePrefixRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/prefixes/{id}": {
      "get": {
        "operationId": "IPAMService_GetPrefix",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetPrefixResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "IPAMService"
        ]
      },
      "delete": {
        "operationId": "IPAMService_DeletePrefix",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "IPAMService"
        ]
      },
      "patch": {
        "operationId": "IPAMService_UpdatePrefix",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdatePrefixResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IPAMServiceUpdatePrefixBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/prefixes/{prefixId}/available-ips": {
      "get": {
        "operationId": "IPAMService_ListAvailableIPs",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListAvailableIPsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "prefixId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "description": "Limit number of IPs returned (default: 100)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/prefixes/{prefixId}/reserved-ips": {
      "post": {
        "summary": "IP Reservation (manage reserved_ips array in prefix)",
        "operationId": "IPAMService_AddReservedIP",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "prefixId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IPAMServiceAddReservedIPBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/prefixes/{prefixId}/reserved-ips/clear-all": {
      "post": {
        "operationId": "IPAMService_ClearAllPrefixReservedIPs",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "prefixId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IPAMServiceClearAllPrefixReservedIPsBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/prefixes/{prefixId}/reserved-ips/reserve-all": {
      "post": {
        "operationId": "IPAMService_ReserveAllPrefixIPs",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "prefixId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IPAMServiceReserveAllPrefixIPsBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/prefixes/{prefixId}/reserved-ips/{ipAddress}": {
      "delete": {
        "operationId": "IPAMService_RemoveReservedIP",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "prefixId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ipAddress",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/prefixes/{prefixId}/reserved-prefixes": {
      "delete": {
        "operationId": "IPAMService_RemoveReservedPrefix",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "prefixId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cidr",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "IPAMService"
        ]
      },
      "post": {
        "operationId": "IPAMService_AddReservedPrefix",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "prefixId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IPAMServiceAddReservedPrefixBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/ipam/prefixes/{prefixId}/utilization": {
      "get": {
        "summary": "Utility",
        "operationId": "IPAMService_GetPrefixUtilization",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetPrefixUtilizationResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "prefixId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "IPAMService"
        ]
      }
    },
    "/v1/marketplace/addons": {
      "get": {
        "operationId": "MarketplaceService_ListAvailableAddons",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListAvailableAddonsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "filterProviderId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "vmId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterAddonType",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "ADDON_TYPE_UNSPECIFIED",
                "ADDON_TYPE_BACKUP",
                "ADDON_TYPE_SNAPSHOT",
                "ADDON_TYPE_ADDITIONAL_IP"
              ],
              "default": "ADDON_TYPE_UNSPECIFIED"
            }
          },
          {
            "name": "filterBillingType",
            "description": " - BILLING_TYPE_PERCENTAGE: Percentage-based pricing (e.g., 30% of parent plan)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "BILLING_TYPE_UNSPECIFIED",
                "BILLING_TYPE_SUBSCRIPTION",
                "BILLING_TYPE_USAGE",
                "BILLING_TYPE_FREE",
                "BILLING_TYPE_PERCENTAGE"
              ],
              "default": "BILLING_TYPE_UNSPECIFIED"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "MarketplaceService"
        ]
      }
    },
    "/v1/marketplace/plans": {
      "get": {
        "operationId": "MarketplaceService_ListAvailablePlans",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListAvailablePlansResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "filterCountry",
            "description": "Optional filters\n\nFilter by country name (case-insensitive)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterCity",
            "description": "Filter by city name (case-insensitive)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterBillingType",
            "description": "Filter by billing type\n\n - BILLING_TYPE_PERCENTAGE: Percentage-based pricing (e.g., 30% of parent plan)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "BILLING_TYPE_UNSPECIFIED",
                "BILLING_TYPE_SUBSCRIPTION",
                "BILLING_TYPE_USAGE",
                "BILLING_TYPE_FREE",
                "BILLING_TYPE_PERCENTAGE"
              ],
              "default": "BILLING_TYPE_UNSPECIFIED"
            }
          },
          {
            "name": "filterComputeType",
            "description": "Filter by compute type\n\n - COMPUTE_TYPE_GENERAL_COMPUTE: GC - General Compute (balanced performance)\n - COMPUTE_TYPE_HIGH_FREQUENCY: HF - High Frequency (CPU-optimized, high clock speeds)\n - COMPUTE_TYPE_HIGH_PERFORMANCE: HP - High Performance (next-gen CPUs, NVMe storage)\n - COMPUTE_TYPE_GENERAL_PURPOSE: GP - General Purpose (balanced dedicated resources)\n - COMPUTE_TYPE_CPU_OPTIMIZED: CPU - CPU Optimized (high CPU-to-memory ratio)\n - COMPUTE_TYPE_MEMORY_OPTIMIZED: MEM - Memory Optimized (high memory-to-CPU ratio)\n - COMPUTE_TYPE_STORAGE_OPTIMIZED: STO - Storage Optimized (high storage capacity)\n - COMPUTE_TYPE_VERY_HIGH_FREQUENCY: VHF - Very High Frequency (highest clock dedicated CPUs)\n - COMPUTE_TYPE_GAME_SERVER: GS - Game Server (per-CPU SKU dedicated plans, e.g. DC-GS-9950X-*)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "COMPUTE_TYPE_UNSPECIFIED",
                "COMPUTE_TYPE_GENERAL_COMPUTE",
                "COMPUTE_TYPE_HIGH_FREQUENCY",
                "COMPUTE_TYPE_HIGH_PERFORMANCE",
                "COMPUTE_TYPE_GENERAL_PURPOSE",
                "COMPUTE_TYPE_CPU_OPTIMIZED",
                "COMPUTE_TYPE_MEMORY_OPTIMIZED",
                "COMPUTE_TYPE_STORAGE_OPTIMIZED",
                "COMPUTE_TYPE_VERY_HIGH_FREQUENCY",
                "COMPUTE_TYPE_GAME_SERVER"
              ],
              "default": "COMPUTE_TYPE_UNSPECIFIED"
            }
          },
          {
            "name": "filterComputeCategory",
            "description": "Filter by compute category\n\n - COMPUTE_CATEGORY_SHARED_COMPUTE: Shared compute (shared resources, cost-effective)\n - COMPUTE_CATEGORY_DEDICATED_COMPUTE: Dedicated compute (dedicated resources, higher performance)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "COMPUTE_CATEGORY_UNSPECIFIED",
                "COMPUTE_CATEGORY_SHARED_COMPUTE",
                "COMPUTE_CATEGORY_DEDICATED_COMPUTE"
              ],
              "default": "COMPUTE_CATEGORY_UNSPECIFIED"
            }
          },
          {
            "name": "filterAssetType",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "ASSET_TYPE_UNSPECIFIED",
                "ASSET_TYPE_VM",
                "ASSET_TYPE_CONTAINER",
                "ASSET_TYPE_STORAGE",
                "ASSET_TYPE_GAMESERVER",
                "ASSET_TYPE_CDN",
                "ASSET_TYPE_IP_ADDRESS",
                "ASSET_TYPE_DNS",
                "ASSET_TYPE_GPU",
                "ASSET_TYPE_GENERIC"
              ],
              "default": "ASSET_TYPE_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "MarketplaceService"
        ]
      }
    },
    "/v1/marketplace/plans/{planId}": {
      "get": {
        "operationId": "MarketplaceService_GetMarketplacePlan",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetMarketplacePlanResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "MarketplaceService"
        ]
      }
    },
    "/v1/marketplace/provider-directory": {
      "get": {
        "operationId": "MarketplaceService_ListMarketplaceProviderDirectory",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListMarketplaceProviderDirectoryResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterAssetType",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "ASSET_TYPE_UNSPECIFIED",
                "ASSET_TYPE_VM",
                "ASSET_TYPE_CONTAINER",
                "ASSET_TYPE_STORAGE",
                "ASSET_TYPE_GAMESERVER",
                "ASSET_TYPE_CDN",
                "ASSET_TYPE_IP_ADDRESS",
                "ASSET_TYPE_DNS",
                "ASSET_TYPE_GPU",
                "ASSET_TYPE_GENERIC"
              ],
              "default": "ASSET_TYPE_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "MarketplaceService"
        ]
      }
    },
    "/v1/marketplace/providers": {
      "get": {
        "operationId": "MarketplaceService_ListProviders",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListProvidersResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filterPlanCode",
            "description": "Filter providers that offer this plan code (required)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterCountry",
            "description": "Filter by country name (required, case-insensitive)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterCity",
            "description": "Filter by city name (required, case-insensitive)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterBillingType",
            "description": "Filter by billing type (subscription/fixed or usage-based)\n\n - BILLING_TYPE_PERCENTAGE: Percentage-based pricing (e.g., 30% of parent plan)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "BILLING_TYPE_UNSPECIFIED",
                "BILLING_TYPE_SUBSCRIPTION",
                "BILLING_TYPE_USAGE",
                "BILLING_TYPE_FREE",
                "BILLING_TYPE_PERCENTAGE"
              ],
              "default": "BILLING_TYPE_UNSPECIFIED"
            }
          },
          {
            "name": "search",
            "description": "Search by organization name or description",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterIpv6AvailableOnly",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "planPriceSort",
            "description": "How to order providers: default is newest first. When set, Recommendations (first\nthree in newest-first order) stay pinned; the rest are ordered by the displayed\nlist price for the selected plan and billing type.\n\n - PROVIDER_PLAN_PRICE_SORT_LEAST_EXPENSIVE_FIRST: Ascending among non-recommended providers: lowest list price first\n(usage: hourly, subscription: fixed monthly, free: 0)\n - PROVIDER_PLAN_PRICE_SORT_MOST_EXPENSIVE_FIRST: Descending among non-recommended providers: highest list price first",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "PROVIDER_PLAN_PRICE_SORT_UNSPECIFIED",
                "PROVIDER_PLAN_PRICE_SORT_LEAST_EXPENSIVE_FIRST",
                "PROVIDER_PLAN_PRICE_SORT_MOST_EXPENSIVE_FIRST"
              ],
              "default": "PROVIDER_PLAN_PRICE_SORT_UNSPECIFIED"
            }
          },
          {
            "name": "filterUnlimitedBandwidthOnly",
            "description": "Only include providers where bandwidth egress is effectively unlimited for the selected plan\n(same basis as UI badge: overage_price if > 0 else unit_amount; unlimited when effective $/GB == 0).",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "filterDdosProviders",
            "description": "When set, only organizations whose ddos_provider is one of these slugs are included.\nWhen empty, do not filter by DDoS. Mirrored by marketplace UI: all slugs \"selected\" = omit this.",
            "in": "query",
            "required": false,
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        ],
        "tags": [
          "MarketplaceService"
        ]
      }
    },
    "/v1/marketplace/providers/{providerId}": {
      "get": {
        "operationId": "MarketplaceService_GetProvider",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetProviderResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "providerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "MarketplaceService"
        ]
      }
    },
    "/v1/marketplace/regions": {
      "get": {
        "operationId": "MarketplaceService_ListAvailableRegions",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListAvailableRegionsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "filterAssetType",
            "description": "When set, only cities that sell a marketplace-listable plan of this asset type.\nUnspecified keeps every marketplace city (virtual machines and game servers).",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "ASSET_TYPE_UNSPECIFIED",
                "ASSET_TYPE_VM",
                "ASSET_TYPE_CONTAINER",
                "ASSET_TYPE_STORAGE",
                "ASSET_TYPE_GAMESERVER",
                "ASSET_TYPE_CDN",
                "ASSET_TYPE_IP_ADDRESS",
                "ASSET_TYPE_DNS",
                "ASSET_TYPE_GPU",
                "ASSET_TYPE_GENERIC"
              ],
              "default": "ASSET_TYPE_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "MarketplaceService"
        ]
      }
    },
    "/v1/marketplace/search": {
      "post": {
        "operationId": "MarketplaceService_SearchMarketplace",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SearchMarketplaceResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1SearchMarketplaceRequest"
              }
            }
          },
          "description": "Natural-language marketplace search (anonymous landing page).",
          "required": true
        },
        "tags": [
          "MarketplaceService"
        ]
      }
    },
    "/v1/metrics": {
      "get": {
        "summary": "List all available metrics",
        "operationId": "MetricService_ListMetrics",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListMetricsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "billableOnly",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "tags": [
          "MetricService"
        ]
      }
    },
    "/v1/metrics-write-credentials": {
      "get": {
        "operationId": "MetricsCredentialService_ListMetricsWriteCredentials",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListMetricsWriteCredentialsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "agentId",
            "description": "Optional: omit or leave empty to list credentials for the whole organization.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "includeRevoked",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "description": "-1 means fetch all; otherwise 1..100.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "MetricsCredentialService"
        ]
      },
      "post": {
        "operationId": "MetricsCredentialService_CreateMetricsWriteCredential",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateMetricsWriteCredentialResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateMetricsWriteCredentialRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "MetricsCredentialService"
        ]
      }
    },
    "/v1/metrics-write-credentials/{id}:revoke": {
      "post": {
        "operationId": "MetricsCredentialService_RevokeMetricsWriteCredential",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MetricsCredentialServiceRevokeMetricsWriteCredentialBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "MetricsCredentialService"
        ]
      }
    },
    "/v1/metrics-write-credentials/{id}:rotate": {
      "post": {
        "operationId": "MetricsCredentialService_RotateMetricsWriteCredential",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateMetricsWriteCredentialResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MetricsCredentialServiceRotateMetricsWriteCredentialBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "MetricsCredentialService"
        ]
      }
    },
    "/v1/metrics/{id}": {
      "get": {
        "summary": "Get a specific metric by ID or code",
        "operationId": "MetricService_GetMetric",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetMetricResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "code",
            "description": "Alternative to id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "MetricService"
        ]
      }
    },
    "/v1/node": {
      "post": {
        "operationId": "NodeService_CreateNode",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateNodeRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "NodeService"
        ]
      }
    },
    "/v1/node-placement-policy": {
      "get": {
        "operationId": "NodePlacementService_GetNodePlacementPolicy",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetNodePlacementPolicyResponse"
                }
              }
            }
          }
        },
        "tags": [
          "NodePlacementService"
        ]
      },
      "put": {
        "operationId": "NodePlacementService_UpdateNodePlacementPolicy",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdateNodePlacementPolicyResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1UpdateNodePlacementPolicyRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "NodePlacementService"
        ]
      }
    },
    "/v1/node/topology/validate": {
      "post": {
        "summary": "Dedicated CPU cores: parse-preview of a topology paste without persisting.",
        "operationId": "NodeService_ValidateNodeTopology",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ValidateNodeTopologyResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1ValidateNodeTopologyRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "NodeService"
        ]
      }
    },
    "/v1/node/{id}": {
      "get": {
        "operationId": "NodeService_GetNode",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetNodeResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "NodeService"
        ]
      },
      "delete": {
        "operationId": "NodeService_DeleteNode",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "NodeService"
        ]
      },
      "patch": {
        "operationId": "NodeService_UpdateNode",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdateNodeResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NodeServiceUpdateNodeBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "NodeService"
        ]
      }
    },
    "/v1/node/{id}/cpu-map": {
      "get": {
        "summary": "Dedicated CPU cores: full topology + per-CPU occupancy for the node\ntopology board (docs/README-DEDICATED-CPU-CORES.md §6.3/§8.3).",
        "operationId": "NodeService_GetNodeCPUMap",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetNodeCPUMapResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "NodeService"
        ]
      }
    },
    "/v1/nodes": {
      "get": {
        "operationId": "NodeService_ListNodes",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListNodesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "platformId",
            "description": "Optional filter; UUID format validated in ListNodes when set.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "serviceStatus",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "SERVICE_STATUS_UNSPECIFIED",
                "SERVICE_STATUS_ONLINE",
                "SERVICE_STATUS_OFFLINE",
                "SERVICE_STATUS_MAINTENANCE"
              ],
              "default": "SERVICE_STATUS_UNSPECIFIED"
            }
          },
          {
            "name": "expand",
            "in": "query",
            "required": false,
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "regionId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "NodeService"
        ]
      }
    },
    "/v1/oauth2/authorize": {
      "get": {
        "summary": "Authorize initiates the OAuth2 authorization flow",
        "operationId": "OAuth2Service_Authorize",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1AuthorizeResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "clientId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "responseType",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "redirectUri",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "scope",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "state",
            "description": "CSRF protection",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "codeChallenge",
            "description": "PKCE challenge",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "codeChallengeMethod",
            "description": "Only S256, not plain",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "OAuth2Service"
        ]
      }
    },
    "/v1/oauth2/clients": {
      "get": {
        "summary": "ListClients lists OAuth2 clients for the organization",
        "operationId": "OAuth2Service_ListClients",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListOAuth2ClientsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "OAuth2Service"
        ]
      },
      "post": {
        "summary": "CreateClient creates a new OAuth2 client",
        "operationId": "OAuth2Service_CreateClient",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateOAuth2ClientResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateOAuth2ClientRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "OAuth2Service"
        ]
      }
    },
    "/v1/oauth2/clients/{clientId}": {
      "delete": {
        "summary": "DeleteClient deletes an OAuth2 client",
        "operationId": "OAuth2Service_DeleteClient",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "clientId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "OAuth2Service"
        ]
      }
    },
    "/v1/oauth2/refresh": {
      "post": {
        "summary": "RefreshToken exchanges refresh token for new access token",
        "operationId": "OAuth2Service_RefreshToken",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1TokenResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1RefreshTokenRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "OAuth2Service"
        ]
      }
    },
    "/v1/oauth2/revoke": {
      "post": {
        "summary": "RevokeToken revokes an access or refresh token",
        "operationId": "OAuth2Service_RevokeToken",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1RevokeTokenRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "OAuth2Service"
        ]
      }
    },
    "/v1/oauth2/token": {
      "post": {
        "summary": "Token exchanges authorization code for access token",
        "operationId": "OAuth2Service_Token",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1TokenResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1TokenRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "OAuth2Service"
        ]
      }
    },
    "/v1/organization": {
      "get": {
        "operationId": "OrganizationService_GetOrganization",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetOrganizationResponse"
                }
              }
            }
          }
        },
        "tags": [
          "OrganizationService"
        ]
      }
    },
    "/v1/organizations": {
      "get": {
        "operationId": "OrganizationService_ListOrganizations",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListOrganizationsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "OrganizationService"
        ]
      },
      "delete": {
        "operationId": "OrganizationService_DeleteOrganization",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "tags": [
          "OrganizationService"
        ]
      },
      "post": {
        "operationId": "OrganizationService_CreateOrganization",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateOrganizationRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "OrganizationService"
        ]
      },
      "patch": {
        "operationId": "OrganizationService_UpdateOrganization",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdateOrganizationResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1UpdateOrganizationRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "OrganizationService"
        ]
      }
    },
    "/v1/payment-methods": {
      "get": {
        "summary": "List payment methods for an organization/subscription\nReturns payment method details (type, last4, brand, expiry, is_default)",
        "operationId": "PaymentMethodService_ListPaymentMethods",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListPaymentMethodsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "subscriptionId",
            "description": "Filters\n\nFilter by subscription",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "onlyDefault",
            "description": "Only return default payment method",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "page",
            "description": "Pagination",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "PaymentMethodService"
        ]
      },
      "post": {
        "summary": "Attach a payment method to a subscription/organization\nWorks for both providers (platform subscriptions) and clients (provider\nplan subscriptions) Authorization: Check organization type and rule engine\n(subscription.payment_method.manage.enabled)",
        "operationId": "PaymentMethodService_AttachPaymentMethod",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1AttachPaymentMethodResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1AttachPaymentMethodRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "PaymentMethodService"
        ]
      }
    },
    "/v1/payment-methods/{paymentMethodId}": {
      "delete": {
        "summary": "Remove a payment method\nValidation:\n- Providers: Cannot remove if only one method exists (except on free plan)\n- Clients: Cannot remove if only one method exists\n- Cannot remove if payment method is currently in use for active\nsubscriptions",
        "operationId": "PaymentMethodService_RemovePaymentMethod",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1RemovePaymentMethodResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "paymentMethodId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "PaymentMethodService"
        ]
      }
    },
    "/v1/payment-methods/{paymentMethodId}:set-default": {
      "post": {
        "summary": "Set a payment method as the default payment method\nValidates payment method belongs to organization/subscription",
        "operationId": "PaymentMethodService_SetDefaultPaymentMethod",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SetDefaultPaymentMethodResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "paymentMethodId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PaymentMethodServiceSetDefaultPaymentMethodBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "PaymentMethodService"
        ]
      }
    },
    "/v1/payments": {
      "get": {
        "summary": "ListPayments lists payments for an invoice or organization",
        "operationId": "PaymentService_ListPayments",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListPaymentsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "invoiceId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "PAYMENT_STATUS_UNSPECIFIED",
                "PAYMENT_STATUS_PENDING",
                "PAYMENT_STATUS_PROCESSING",
                "PAYMENT_STATUS_SUCCEEDED",
                "PAYMENT_STATUS_FAILED",
                "PAYMENT_STATUS_CANCELED",
                "PAYMENT_STATUS_REFUNDED",
                "PAYMENT_STATUS_PARTIALLY_REFUNDED"
              ],
              "default": "PAYMENT_STATUS_UNSPECIFIED"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "PaymentService"
        ]
      }
    },
    "/v1/payments/{paymentId}": {
      "get": {
        "summary": "GetPayment retrieves a single payment with refunds",
        "operationId": "PaymentService_GetPayment",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetPaymentResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "paymentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "PaymentService"
        ]
      }
    },
    "/v1/permissions": {
      "get": {
        "operationId": "PermissionService_ListPermissions",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListPermissionsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filterName",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "PermissionService"
        ]
      }
    },
    "/v1/permissions/assign-to-role": {
      "post": {
        "operationId": "PermissionService_AssignPermissionToRole",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1AssignPermissionToRoleRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "PermissionService"
        ]
      }
    },
    "/v1/permissions/effective": {
      "get": {
        "operationId": "PermissionService_ListEffectivePermissions",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListEffectivePermissionsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "userIds",
            "in": "query",
            "required": false,
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        ],
        "tags": [
          "PermissionService"
        ]
      }
    },
    "/v1/permissions/remove-from-role": {
      "delete": {
        "operationId": "PermissionService_RemovePermissionFromRole",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "permissionIds",
            "in": "query",
            "required": false,
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "roleId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "PermissionService"
        ]
      }
    },
    "/v1/plans": {
      "get": {
        "operationId": "PlanService_ListPlans",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListPlansResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "isTemplate",
            "description": "Filter to show only template plans (true) or only non-template plans\n(false) If not specified, shows both template and non-template plans",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "endUser",
            "description": "Filter by end user type (client, provider, or all)\nIf not specified, shows plans for all end user types based on organization\npermissions",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "END_USER_UNSPECIFIED",
                "END_USER_CLIENT",
                "END_USER_PROVIDER",
                "END_USER_ALL",
                "END_USER_USER"
              ],
              "default": "END_USER_UNSPECIFIED"
            }
          },
          {
            "name": "search",
            "description": "Search filter for plan name, code, or description",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "assetType",
            "description": "Filter by asset type (vm, gameserver, etc.)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "ASSET_TYPE_UNSPECIFIED",
                "ASSET_TYPE_VM",
                "ASSET_TYPE_CONTAINER",
                "ASSET_TYPE_STORAGE",
                "ASSET_TYPE_GAMESERVER",
                "ASSET_TYPE_CDN",
                "ASSET_TYPE_IP_ADDRESS",
                "ASSET_TYPE_DNS",
                "ASSET_TYPE_GPU",
                "ASSET_TYPE_GENERIC"
              ],
              "default": "ASSET_TYPE_UNSPECIFIED"
            }
          },
          {
            "name": "billingType",
            "description": "Filter by billing type (subscription, usage, etc.)\nIf not specified, shows plans for all billing types\n\n - BILLING_TYPE_PERCENTAGE: Percentage-based pricing (e.g., 30% of parent plan)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "BILLING_TYPE_UNSPECIFIED",
                "BILLING_TYPE_SUBSCRIPTION",
                "BILLING_TYPE_USAGE",
                "BILLING_TYPE_FREE",
                "BILLING_TYPE_PERCENTAGE"
              ],
              "default": "BILLING_TYPE_UNSPECIFIED"
            }
          },
          {
            "name": "filterComputeType",
            "description": "Filter by compute type (optional). If provided, only plans with matching compute type in their name are returned.\nExamples: \"high performance\", \"high frequency\", \"general compute\", \"general purpose\", \"cpu optimized\", \"memory optimized\", \"storage optimized\"\nFiltering is case-insensitive.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterCode",
            "description": "Filter by plan code (optional). If provided, only plans with matching code are returned.\nFiltering is case-insensitive.\nExamples: \"SC-GC-1C-1G-20\", \"DC-HF-4C-8G-160\"\nFiltering is case-insensitive.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "PlanService"
        ]
      },
      "post": {
        "operationId": "ProviderPlanService_CreatePlan",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreatePlanRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderPlanService"
        ]
      }
    },
    "/v1/plans/{id}": {
      "delete": {
        "operationId": "ProviderPlanService_DeletePlan",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ProviderPlanService"
        ]
      },
      "patch": {
        "operationId": "ProviderPlanService_UpdatePlan",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "description": "Plan ID to update (required)",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProviderPlanServiceUpdatePlanBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderPlanService"
        ]
      }
    },
    "/v1/plans/{planId}:subscribe": {
      "post": {
        "operationId": "PlanService_Subscribe",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SubscribeResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "billingPeriod",
            "description": "Optional billing period. If not provided, uses the plan's default billing\nperiod. If provided, validates that a PlanPrice exists for this billing\nperiod. If not available, returns a FailedPrecondition error.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "BILLING_PERIOD_UNSPECIFIED",
                "BILLING_PERIOD_HOUR",
                "BILLING_PERIOD_DAY",
                "BILLING_PERIOD_WEEK",
                "BILLING_PERIOD_MONTH",
                "BILLING_PERIOD_QUARTER",
                "BILLING_PERIOD_YEAR"
              ],
              "default": "BILLING_PERIOD_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "PlanService"
        ]
      }
    },
    "/v1/plans:calculate": {
      "post": {
        "operationId": "ProviderPlanService_CalculatePlanPricing",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CalculatePlanPricingResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CalculatePlanPricingRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderPlanService"
        ]
      }
    },
    "/v1/platform": {
      "post": {
        "operationId": "PlatformService_CreatePlatform",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreatePlatformRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "PlatformService"
        ]
      }
    },
    "/v1/platform-versions": {
      "get": {
        "summary": "GetPlatformVersions returns pinned versions for k3s, k3d, calico, liqo, liqoctl, and helm.",
        "operationId": "MetadataService_GetPlatformVersions",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1PlatformVersions"
                }
              }
            }
          }
        },
        "tags": [
          "MetadataService"
        ]
      }
    },
    "/v1/platform/organizations/{organizationId}:ban": {
      "post": {
        "operationId": "EnforcementService_BanOrganization",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnforcementServiceBanOrganizationBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "EnforcementService"
        ]
      }
    },
    "/v1/platform/organizations/{organizationId}:block-purchases": {
      "post": {
        "operationId": "EnforcementService_BlockOrganizationPurchases",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnforcementServiceBlockOrganizationPurchasesBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "EnforcementService"
        ]
      }
    },
    "/v1/platform/organizations/{organizationId}:unban": {
      "post": {
        "operationId": "EnforcementService_UnbanOrganization",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnforcementServiceUnbanOrganizationBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "EnforcementService"
        ]
      }
    },
    "/v1/platform/organizations/{organizationId}:unblock-purchases": {
      "post": {
        "operationId": "EnforcementService_UnblockOrganizationPurchases",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnforcementServiceUnblockOrganizationPurchasesBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "EnforcementService"
        ]
      }
    },
    "/v1/platform/users/{userId}:ban": {
      "post": {
        "operationId": "EnforcementService_BanUser",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnforcementServiceBanUserBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "EnforcementService"
        ]
      }
    },
    "/v1/platform/users/{userId}:unban": {
      "post": {
        "operationId": "EnforcementService_UnbanUser",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnforcementServiceUnbanUserBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "EnforcementService"
        ]
      }
    },
    "/v1/platform/virtual-machines/{virtualMachineId}:delete": {
      "post": {
        "operationId": "EnforcementService_DeletePlatformVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "virtualMachineId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnforcementServiceDeletePlatformVirtualMachineBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "EnforcementService"
        ]
      }
    },
    "/v1/platform/virtual-machines/{virtualMachineId}:suspend": {
      "post": {
        "operationId": "EnforcementService_SuspendPlatformVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VirtualMachine"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "virtualMachineId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnforcementServiceSuspendPlatformVirtualMachineBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "EnforcementService"
        ]
      }
    },
    "/v1/platform/virtual-machines/{virtualMachineId}:unblock": {
      "post": {
        "operationId": "EnforcementService_UnblockPlatformVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VirtualMachine"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "virtualMachineId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnforcementServiceUnblockPlatformVirtualMachineBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "EnforcementService"
        ]
      }
    },
    "/v1/platform/{id}": {
      "get": {
        "operationId": "PlatformService_GetPlatform",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetPlatformResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "PlatformService"
        ]
      },
      "delete": {
        "operationId": "PlatformService_DeletePlatform",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "PlatformService"
        ]
      },
      "patch": {
        "operationId": "PlatformService_UpdatePlatform",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdatePlatformResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PlatformServiceUpdatePlatformBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "PlatformService"
        ]
      }
    },
    "/v1/platforms": {
      "get": {
        "operationId": "PlatformService_ListPlatforms",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListPlatformsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "serviceStatus",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "SERVICE_STATUS_UNSPECIFIED",
                "SERVICE_STATUS_ONLINE",
                "SERVICE_STATUS_OFFLINE",
                "SERVICE_STATUS_MAINTENANCE"
              ],
              "default": "SERVICE_STATUS_UNSPECIFIED"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "PlatformService"
        ]
      }
    },
    "/v1/platforms/{platformId}:AssignAgent": {
      "post": {
        "operationId": "PlatformService_AssignAgent",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "platformId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PlatformServiceAssignAgentBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "PlatformService"
        ]
      }
    },
    "/v1/platforms/{platformId}:UnassignAgent": {
      "post": {
        "operationId": "PlatformService_UnassignAgent",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "platformId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PlatformServiceUnassignAgentBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "PlatformService"
        ]
      }
    },
    "/v1/provider-reviews": {
      "get": {
        "operationId": "ProviderReviewService_ListProviderReviews",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListProviderReviewsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "starRatings",
            "description": "Multi-select star filter (e.g. [5,4]); empty means any stars.",
            "in": "query",
            "required": false,
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "integer",
                "format": "int32"
              }
            }
          },
          {
            "name": "search",
            "description": "Case-insensitive substring match on review comment or provider reply; empty means no text filter.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "replyFilter",
            "description": "Inbox: 0 = awaiting provider reply / empty reply (default), 1 = replied only, 2 = all reviews.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "ProviderReviewService"
        ]
      },
      "post": {
        "operationId": "ClientProviderReviewService_CreateClientReview",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateClientReviewResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateClientReviewRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ClientProviderReviewService"
        ]
      }
    },
    "/v1/provider-reviews/virtual-machines/{virtualMachineId}": {
      "get": {
        "operationId": "ClientProviderReviewService_GetClientReviewForVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetClientReviewForVirtualMachineResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "virtualMachineId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ClientProviderReviewService"
        ]
      }
    },
    "/v1/provider-reviews/{reviewId}": {
      "delete": {
        "operationId": "ClientProviderReviewService_DeleteClientReview",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "reviewId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ClientProviderReviewService"
        ]
      },
      "patch": {
        "operationId": "ClientProviderReviewService_UpdateClientReview",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdateClientReviewResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "reviewId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ClientProviderReviewServiceUpdateClientReviewBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ClientProviderReviewService"
        ]
      }
    },
    "/v1/provider-reviews/{reviewId}/reply": {
      "delete": {
        "operationId": "ProviderReviewService_DeleteProviderReviewReply",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1DeleteProviderReviewReplyResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "reviewId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ProviderReviewService"
        ]
      },
      "post": {
        "operationId": "ProviderReviewService_CreateProviderReviewReply",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateProviderReviewReplyResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "reviewId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProviderReviewServiceCreateProviderReviewReplyBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderReviewService"
        ]
      },
      "patch": {
        "operationId": "ProviderReviewService_UpdateProviderReviewReply",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdateProviderReviewReplyResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "reviewId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProviderReviewServiceUpdateProviderReviewReplyBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderReviewService"
        ]
      }
    },
    "/v1/provider/connect/account": {
      "get": {
        "operationId": "ProviderConnectService_GetConnectAccount",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetConnectAccountResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ProviderConnectService"
        ]
      },
      "delete": {
        "operationId": "ProviderConnectService_DisconnectConnectAccount",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ProviderConnectService"
        ]
      },
      "post": {
        "operationId": "ProviderConnectService_CreateConnectAccount",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateConnectAccountResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateConnectAccountRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderConnectService"
        ]
      }
    },
    "/v1/provider/connect/oauth:complete": {
      "post": {
        "summary": "Completes Stripe Connect OAuth after Stripe redirects back with a code.",
        "operationId": "ProviderConnectService_CompleteConnectOAuth",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CompleteConnectOAuthResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CompleteConnectOAuthRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderConnectService"
        ]
      }
    },
    "/v1/provider/connect/oauth:start": {
      "post": {
        "summary": "Starts Stripe Connect OAuth so a provider can attach an existing Standard account.",
        "operationId": "ProviderConnectService_StartConnectOAuth",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1StartConnectOAuthResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1StartConnectOAuthRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderConnectService"
        ]
      }
    },
    "/v1/provider/connect/tax-registrations": {
      "get": {
        "operationId": "ProviderConnectService_ListConnectTaxRegistrations",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListConnectTaxRegistrationsResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ProviderConnectService"
        ]
      },
      "post": {
        "operationId": "ProviderConnectService_CreateConnectTaxRegistration",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateConnectTaxRegistrationResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateConnectTaxRegistrationRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderConnectService"
        ]
      }
    },
    "/v1/provider/connect/tax-registrations/{id}/expire": {
      "post": {
        "operationId": "ProviderConnectService_ExpireConnectTaxRegistration",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ExpireConnectTaxRegistrationResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProviderConnectServiceExpireConnectTaxRegistrationBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderConnectService"
        ]
      }
    },
    "/v1/provider/connect/tax-session": {
      "post": {
        "summary": "Creates a Stripe AccountSession client secret for Connect tax_settings /\ntax_registrations embedded components (legacy; prefer native tax RPCs).",
        "operationId": "ProviderConnectService_CreateConnectTaxSession",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateConnectTaxSessionResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "$ref": "#/components/requestBodies/ProviderConnectService_CreateConnectTaxSessionBody"
        },
        "tags": [
          "ProviderConnectService"
        ]
      }
    },
    "/v1/provider/connect/tax-settings": {
      "get": {
        "operationId": "ProviderConnectService_GetConnectTaxSettings",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetConnectTaxSettingsResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ProviderConnectService"
        ]
      },
      "put": {
        "operationId": "ProviderConnectService_UpdateConnectTaxSettings",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdateConnectTaxSettingsResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1UpdateConnectTaxSettingsRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderConnectService"
        ]
      }
    },
    "/v1/provider/customer-stats": {
      "get": {
        "summary": "Path must not be `/customers/stats`: some gateways match `/customers/{client_organization_id}` first and treat \"stats\" as a UUID field (validation error).",
        "operationId": "ProviderCustomerService_GetProviderCustomerStats",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetProviderCustomerStatsResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ProviderCustomerService"
        ]
      }
    },
    "/v1/provider/customers": {
      "get": {
        "operationId": "ProviderCustomerService_ListProviderCustomers",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListProviderCustomersResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "description": "0-based page (default 0).",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "description": "-1 = all matches (no server row cap; prefer paginated 1..100 for large data sets). Otherwise 1..100 per page (see ListVirtualMachinesRequest).",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "search",
            "description": "Case-insensitive match on client organization name or any member email (owners/members via roles & groups).",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "activityFilter",
            "description": "Default / UNSPECIFIED means ALL (same as PROVIDER_CUSTOMER_ACTIVITY_FILTER_ALL).\n\n - PROVIDER_CUSTOMER_ACTIVITY_FILTER_ALL: All customers (any VM history with this provider, including when every VM is soft-deleted).",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "PROVIDER_CUSTOMER_ACTIVITY_FILTER_UNSPECIFIED",
                "PROVIDER_CUSTOMER_ACTIVITY_FILTER_ALL",
                "PROVIDER_CUSTOMER_ACTIVITY_FILTER_ACTIVE",
                "PROVIDER_CUSTOMER_ACTIVITY_FILTER_INACTIVE"
              ],
              "default": "PROVIDER_CUSTOMER_ACTIVITY_FILTER_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "ProviderCustomerService"
        ]
      }
    },
    "/v1/provider/customers/{clientOrganizationId}": {
      "get": {
        "operationId": "ProviderCustomerService_GetProviderCustomer",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetProviderCustomerResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "clientOrganizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ProviderCustomerService"
        ]
      }
    },
    "/v1/provider/customers/{clientOrganizationId}/assets": {
      "get": {
        "operationId": "ProviderCustomerService_ListProviderCustomerAssets",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListProviderCustomerAssetsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "clientOrganizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "description": "Same rules as ListProviderCustomers.page_size.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "assetType",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "PROVIDER_CUSTOMER_ASSET_TYPE_UNSPECIFIED",
                "PROVIDER_CUSTOMER_ASSET_TYPE_ALL",
                "PROVIDER_CUSTOMER_ASSET_TYPE_VIRTUAL_MACHINE",
                "PROVIDER_CUSTOMER_ASSET_TYPE_DEDICATED_SERVER",
                "PROVIDER_CUSTOMER_ASSET_TYPE_GAME_SERVER"
              ],
              "default": "PROVIDER_CUSTOMER_ASSET_TYPE_UNSPECIFIED"
            }
          },
          {
            "name": "activityStatus",
            "description": "When set (not UNSPECIFIED), only assets matching this activity status are returned.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "PROVIDER_CUSTOMER_VM_ACTIVITY_STATUS_UNSPECIFIED",
                "PROVIDER_CUSTOMER_VM_ACTIVITY_STATUS_ACTIVE",
                "PROVIDER_CUSTOMER_VM_ACTIVITY_STATUS_INACTIVE"
              ],
              "default": "PROVIDER_CUSTOMER_VM_ACTIVITY_STATUS_UNSPECIFIED"
            }
          },
          {
            "name": "regionId",
            "description": "When set to a non-empty UUID, only assets whose VM node is in this region are returned.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ProviderCustomerService"
        ]
      }
    },
    "/v1/provider/customers/{clientOrganizationId}/billing": {
      "get": {
        "operationId": "ProviderCustomerService_GetProviderCustomerBilling",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetProviderCustomerBillingResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "clientOrganizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ProviderCustomerService"
        ]
      }
    },
    "/v1/provider/customers/{clientOrganizationId}/virtual-machines/{virtualMachineId}:restart": {
      "post": {
        "operationId": "ProviderCustomerService_RestartProviderCustomerVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VirtualMachine"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "clientOrganizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "virtualMachineId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProviderCustomerServiceRestartProviderCustomerVirtualMachineBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderCustomerService"
        ]
      }
    },
    "/v1/provider/customers/{clientOrganizationId}/virtual-machines/{virtualMachineId}:start": {
      "post": {
        "operationId": "ProviderCustomerService_StartProviderCustomerVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VirtualMachine"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "clientOrganizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "virtualMachineId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProviderCustomerServiceStartProviderCustomerVirtualMachineBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderCustomerService"
        ]
      }
    },
    "/v1/provider/customers/{clientOrganizationId}/virtual-machines/{virtualMachineId}:stop": {
      "post": {
        "operationId": "ProviderCustomerService_StopProviderCustomerVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VirtualMachine"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "clientOrganizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "virtualMachineId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProviderCustomerServiceStopProviderCustomerVirtualMachineBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderCustomerService"
        ]
      }
    },
    "/v1/provider/customers/{clientOrganizationId}/virtual-machines/{virtualMachineId}:suspend": {
      "post": {
        "operationId": "ProviderCustomerService_SuspendProviderCustomerVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VirtualMachine"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "clientOrganizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "virtualMachineId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProviderCustomerServiceSuspendProviderCustomerVirtualMachineBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderCustomerService"
        ]
      }
    },
    "/v1/provider/customers/{clientOrganizationId}/virtual-machines/{virtualMachineId}:unblock": {
      "post": {
        "operationId": "ProviderCustomerService_UnblockProviderCustomerVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VirtualMachine"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "clientOrganizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "virtualMachineId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProviderCustomerServiceUnblockProviderCustomerVirtualMachineBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderCustomerService"
        ]
      }
    },
    "/v1/provider/customers/{clientOrganizationId}:block-purchases": {
      "post": {
        "operationId": "ProviderCustomerService_BlockProviderCustomerPurchases",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "clientOrganizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProviderCustomerServiceBlockProviderCustomerPurchasesBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderCustomerService"
        ]
      }
    },
    "/v1/provider/customers/{clientOrganizationId}:unblock-purchases": {
      "post": {
        "operationId": "ProviderCustomerService_UnblockProviderCustomerPurchases",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "clientOrganizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProviderCustomerServiceUnblockProviderCustomerPurchasesBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderCustomerService"
        ]
      }
    },
    "/v1/provider/dashboard/addon-catalog-stats": {
      "get": {
        "operationId": "ProviderDashboardService_ListDashboardAddonCatalogStats",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListDashboardAddonCatalogStatsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "addonSearch",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "addonTypeFilter",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "addonBillingTypeFilter",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "ProviderDashboardService"
        ]
      }
    },
    "/v1/provider/dashboard/asset-sales-timeseries": {
      "get": {
        "operationId": "ProviderDashboardService_GetDashboardAssetSalesTimeseries",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetDashboardAssetSalesTimeseriesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "rangeDays",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "ProviderDashboardService"
        ]
      }
    },
    "/v1/provider/dashboard/billing-sales": {
      "get": {
        "operationId": "ProviderDashboardService_GetDashboardBillingSales",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetDashboardBillingSalesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "rangeDays",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "includePriorPeriod",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "revenueByCustomerPage",
            "description": "Revenue-by-customer table (1-based page). Omit for defaults (page 1, page size 25).",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "revenueByCustomerPageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "revenueByCustomerEmailFilter",
            "description": "Case-insensitive substring match on contact email, organization id, or organization name.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ProviderDashboardService"
        ]
      }
    },
    "/v1/provider/dashboard/customer-acquisition-timeseries": {
      "get": {
        "operationId": "ProviderDashboardService_GetDashboardCustomerAcquisitionTimeseries",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetDashboardCustomerAcquisitionTimeseriesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "rangeDays",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "ProviderDashboardService"
        ]
      }
    },
    "/v1/provider/dashboard/infrastructure": {
      "get": {
        "operationId": "ProviderDashboardService_ListDashboardInfrastructure",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListDashboardInfrastructureResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "platformId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "regionId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "ProviderDashboardService"
        ]
      }
    },
    "/v1/provider/dashboard/ipam": {
      "get": {
        "operationId": "ProviderDashboardService_ListDashboardIpam",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListDashboardIpamResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "networkId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "allocatedSampleIpsPage",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "allocatedSampleIpsPageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "ProviderDashboardService"
        ]
      }
    },
    "/v1/provider/dashboard/ipam/assignments": {
      "get": {
        "operationId": "ProviderDashboardService_ListDashboardIpamAssignments",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListDashboardIpamAssignmentsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "networkId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platformId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "ipFamily",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "DASHBOARD_IPAM_ASSIGNMENT_IP_FAMILY_UNSPECIFIED",
                "DASHBOARD_IPAM_ASSIGNMENT_IP_FAMILY_IPV4",
                "DASHBOARD_IPAM_ASSIGNMENT_IP_FAMILY_IPV6"
              ],
              "default": "DASHBOARD_IPAM_ASSIGNMENT_IP_FAMILY_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "ProviderDashboardService"
        ]
      }
    },
    "/v1/provider/dashboard/plan-subscription-stats": {
      "get": {
        "operationId": "ProviderDashboardService_ListDashboardPlanSubscriptionStats",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListDashboardPlanSubscriptionStatsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "planSearch",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "planBillingTypeFilter",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "planAssetFilter",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "plansPage",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "plansPageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "ProviderDashboardService"
        ]
      }
    },
    "/v1/provider/dashboard/plans-tab-stats": {
      "get": {
        "operationId": "ProviderDashboardPlansTabService_GetDashboardPlansTabStats",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ProviderDashboardPlansTabStats"
                }
              }
            }
          }
        },
        "tags": [
          "ProviderDashboardPlansTabService"
        ]
      }
    },
    "/v1/provider/dashboard/summary": {
      "get": {
        "operationId": "ProviderDashboardService_GetDashboardSummary",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetDashboardSummaryResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ProviderDashboardService"
        ]
      }
    },
    "/v1/provider/dashboard/tickets/statistics": {
      "get": {
        "operationId": "ProviderDashboardService_ListDashboardTicketStatistics",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListDashboardTicketStatisticsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "fromTime",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "toTime",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "tags": [
          "ProviderDashboardService"
        ]
      }
    },
    "/v1/provider/dashboard/virtual-machines": {
      "get": {
        "operationId": "ProviderDashboardService_ListDashboardVirtualMachines",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListDashboardVirtualMachinesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "platformId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "regionId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "nodeId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "customerEmailContains",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "vmPage",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "vmPageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "vmtemplateId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ProviderDashboardService"
        ]
      }
    },
    "/v1/provider/held-payouts": {
      "get": {
        "summary": "Paid client invoices whose payout to this provider is on hold, soonest release first.",
        "operationId": "PayoutInvoiceService_ListHeldPayouts",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListHeldPayoutsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "PayoutInvoiceService"
        ]
      }
    },
    "/v1/provider/live-validations": {
      "get": {
        "operationId": "LiveValidationService_ListPlanLiveValidations",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListPlanLiveValidationsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "planId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "LiveValidationService"
        ]
      }
    },
    "/v1/provider/manual-payout": {
      "get": {
        "operationId": "ManualPayoutService_GetManualPayout",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetManualPayoutResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ManualPayoutService"
        ]
      },
      "delete": {
        "operationId": "ManualPayoutService_DeleteManualPayout",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ManualPayoutService"
        ]
      },
      "post": {
        "operationId": "ManualPayoutService_CreateManualPayout",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateManualPayoutResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateManualPayoutRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ManualPayoutService"
        ]
      }
    },
    "/v1/provider/network/smtp-outbound-policies": {
      "get": {
        "operationId": "ProviderNetworkService_ListVirtualMachineSmtpOutboundPolicies",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListVirtualMachineSmtpOutboundPoliciesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "search",
            "description": "Case-insensitive substring match on hostname, customer contact email, or exact virtual machine UUID.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ProviderNetworkService"
        ]
      }
    },
    "/v1/provider/network/smtp-outbound-policies/{virtualMachineId}": {
      "put": {
        "operationId": "ProviderNetworkService_UpdateVirtualMachineSmtpOutboundPolicy",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VirtualMachineSmtpOutboundPolicyView"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "virtualMachineId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProviderNetworkServiceUpdateVirtualMachineSmtpOutboundPolicyBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderNetworkService"
        ]
      }
    },
    "/v1/provider/network/smtp-outbound-policy": {
      "get": {
        "operationId": "ProviderNetworkService_GetSmtpOutboundProviderPolicy",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetSmtpOutboundProviderPolicyResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ProviderNetworkService"
        ]
      },
      "put": {
        "operationId": "ProviderNetworkService_UpdateSmtpOutboundProviderPolicy",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetSmtpOutboundProviderPolicyResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1UpdateSmtpOutboundProviderPolicyRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderNetworkService"
        ]
      }
    },
    "/v1/provider/onboarding/checklist": {
      "get": {
        "operationId": "ProviderOnboardingService_GetProviderOnboardingChecklist",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetProviderOnboardingChecklistResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ProviderOnboardingService"
        ]
      }
    },
    "/v1/provider/payout-configuration": {
      "get": {
        "operationId": "PayoutConfigurationService_GetPayoutConfiguration",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetPayoutConfigurationResponse"
                }
              }
            }
          }
        },
        "tags": [
          "PayoutConfigurationService"
        ]
      },
      "put": {
        "operationId": "PayoutConfigurationService_UpdatePayoutConfiguration",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetPayoutConfigurationResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1UpdatePayoutConfigurationRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "PayoutConfigurationService"
        ]
      }
    },
    "/v1/provider/payout-invoices": {
      "get": {
        "operationId": "PayoutInvoiceService_ListPayoutInvoices",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListPayoutInvoicesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "status",
            "description": "Filter by payout status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "PAYOUT_STATUS_UNSPECIFIED",
                "PAYOUT_STATUS_PENDING",
                "PAYOUT_STATUS_PROCESSING",
                "PAYOUT_STATUS_COMPLETED",
                "PAYOUT_STATUS_FAILED",
                "PAYOUT_STATUS_CANCELED"
              ],
              "default": "PAYOUT_STATUS_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "PayoutInvoiceService"
        ]
      }
    },
    "/v1/provider/payout-invoices/{id}": {
      "get": {
        "operationId": "PayoutInvoiceService_GetPayoutInvoice",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetPayoutInvoiceResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "PayoutInvoiceService"
        ]
      }
    },
    "/v1/provider/plans/assignable-nodes": {
      "get": {
        "summary": "Nodes the provider may assign to a plan (catalog-eligible for tier/category).",
        "operationId": "ProviderPlanService_ListAssignableNodesForPlan",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListAssignableNodesForPlanResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "templatePlanId",
            "description": "Optional: set for create-from-template. Empty when plan_id is used.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "planId",
            "description": "Optional: set for edit existing plan. Empty when template_plan_id is used.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "regionId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ProviderPlanService"
        ]
      }
    },
    "/v1/provider/plans/{planId}/live-validation": {
      "get": {
        "operationId": "LiveValidationService_GetPlanLiveValidation",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetPlanLiveValidationResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "nodeId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "LiveValidationService"
        ]
      },
      "delete": {
        "operationId": "LiveValidationService_DeletePlanLiveValidation",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "nodeId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "LiveValidationService"
        ]
      },
      "post": {
        "operationId": "LiveValidationService_StartPlanLiveValidation",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1StartPlanLiveValidationResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LiveValidationServiceStartPlanLiveValidationBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "LiveValidationService"
        ]
      }
    },
    "/v1/provider/plans/{planId}/live-validation/benchmarks": {
      "get": {
        "operationId": "LiveValidationService_ListPlanLiveValidationBenchmarks",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListPlanLiveValidationBenchmarksResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "nodeId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "LiveValidationService"
        ]
      }
    },
    "/v1/provider/plans/{planId}/live-validation/nodes": {
      "get": {
        "operationId": "LiveValidationService_ListEligibleNodesForPlan",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListEligibleNodesForPlanResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "LiveValidationService"
        ]
      }
    },
    "/v1/provider/preflight-checks": {
      "get": {
        "operationId": "PreflightService_ListPreflightChecks",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListPreflightChecksResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "planCode",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "planId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuesOnly",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "PreflightService"
        ]
      }
    },
    "/v1/provider/revenue": {
      "get": {
        "operationId": "PayoutInvoiceService_GetProviderRevenue",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetProviderRevenueResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "startDate",
            "description": "Start date for revenue calculation (inclusive)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "endDate",
            "description": "End date for revenue calculation (inclusive)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "planId",
            "description": "Filter by plan ID (optional)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clientOrganizationId",
            "description": "Filter by client organization ID (optional)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "includePending",
            "description": "Include pending/processing payouts in calculations (default: true)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "tags": [
          "PayoutInvoiceService"
        ]
      }
    },
    "/v1/provider/storefront": {
      "get": {
        "operationId": "ProviderStorefrontService_GetMyStorefront",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetMyStorefrontResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ProviderStorefrontService"
        ]
      },
      "patch": {
        "operationId": "ProviderStorefrontService_UpdateMyStorefront",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetMyStorefrontResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1UpdateMyStorefrontRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderStorefrontService"
        ]
      }
    },
    "/v1/provider/storefront/opt-in": {
      "post": {
        "operationId": "ProviderStorefrontService_OptInStorefront",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetMyStorefrontResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "$ref": "#/components/requestBodies/ProviderConnectService_CreateConnectTaxSessionBody"
        },
        "tags": [
          "ProviderStorefrontService"
        ]
      }
    },
    "/v1/provider/storefront/opt-out": {
      "post": {
        "operationId": "ProviderStorefrontService_OptOutStorefront",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetMyStorefrontResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "$ref": "#/components/requestBodies/ProviderConnectService_CreateConnectTaxSessionBody"
        },
        "tags": [
          "ProviderStorefrontService"
        ]
      }
    },
    "/v1/provider/storefront/preview": {
      "get": {
        "operationId": "ProviderStorefrontService_PreviewMyStorefront",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1PreviewMyStorefrontResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ProviderStorefrontService"
        ]
      }
    },
    "/v1/provider/storefront/submit": {
      "post": {
        "operationId": "ProviderStorefrontService_SubmitMyStorefront",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetMyStorefrontResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "$ref": "#/components/requestBodies/ProviderConnectService_CreateConnectTaxSessionBody"
        },
        "tags": [
          "ProviderStorefrontService"
        ]
      }
    },
    "/v1/provider/ticket-notification-policy": {
      "get": {
        "operationId": "ProviderTicketNotificationService_GetProviderTicketNotificationPolicy",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetProviderTicketNotificationPolicyResponse"
                }
              }
            }
          }
        },
        "tags": [
          "ProviderTicketNotificationService"
        ]
      },
      "put": {
        "operationId": "ProviderTicketNotificationService_UpdateProviderTicketNotificationPolicy",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetProviderTicketNotificationPolicyResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1UpdateProviderTicketNotificationPolicyRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ProviderTicketNotificationService"
        ]
      }
    },
    "/v1/provider/ticket-notification-policy:send-test": {
      "post": {
        "operationId": "ProviderTicketNotificationService_SendProviderTicketNotificationTest",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "$ref": "#/components/requestBodies/ProviderConnectService_CreateConnectTaxSessionBody"
        },
        "tags": [
          "ProviderTicketNotificationService"
        ]
      }
    },
    "/v1/public/storefronts": {
      "get": {
        "operationId": "MarketplaceService_ListPublicStorefronts",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListPublicStorefrontsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterCountry",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "MarketplaceService"
        ]
      }
    },
    "/v1/public/storefronts/by-id/{providerId}": {
      "get": {
        "operationId": "MarketplaceService_GetPublicStorefrontByID",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetPublicStorefrontResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "providerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "MarketplaceService"
        ]
      }
    },
    "/v1/public/storefronts/{slug}": {
      "get": {
        "operationId": "MarketplaceService_GetPublicStorefront",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetPublicStorefrontResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "MarketplaceService"
        ]
      }
    },
    "/v1/refunds": {
      "get": {
        "summary": "ListRefunds lists refunds for a payment, invoice, or organization",
        "operationId": "RefundService_ListRefunds",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListRefundsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "paymentId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "invoiceId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "REFUND_STATUS_UNSPECIFIED",
                "REFUND_STATUS_PENDING",
                "REFUND_STATUS_PROCESSING",
                "REFUND_STATUS_SUCCEEDED",
                "REFUND_STATUS_FAILED",
                "REFUND_STATUS_CANCELED"
              ],
              "default": "REFUND_STATUS_UNSPECIFIED"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "RefundService"
        ]
      }
    },
    "/v1/refunds/{refundId}": {
      "get": {
        "summary": "GetRefund retrieves a single refund with payment and invoice details",
        "operationId": "RefundService_GetRefund",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetRefundResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "refundId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "RefundService"
        ]
      }
    },
    "/v1/regions": {
      "get": {
        "operationId": "RegionService_ListRegions",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListRegionsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platformId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "RegionService"
        ]
      },
      "post": {
        "operationId": "RegionService_CreateRegion",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1Region"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateRegionRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "RegionService"
        ]
      }
    },
    "/v1/regions/{id}": {
      "get": {
        "operationId": "RegionService_GetRegion",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1Region"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "RegionService"
        ]
      },
      "delete": {
        "operationId": "RegionService_DeleteRegion",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "RegionService"
        ]
      }
    },
    "/v1/roadmap/comments/{commentId}": {
      "delete": {
        "operationId": "RoadmapService_DeleteRoadmapFeatureRequestComment",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1DeleteRoadmapFeatureRequestCommentResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "commentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "RoadmapService"
        ]
      },
      "patch": {
        "operationId": "RoadmapService_UpdateRoadmapFeatureRequestComment",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdateRoadmapFeatureRequestCommentResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "commentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RoadmapServiceUpdateRoadmapFeatureRequestCommentBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "RoadmapService"
        ]
      }
    },
    "/v1/roadmap/products": {
      "get": {
        "operationId": "RoadmapService_ListRoadmapProductCategories",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListRoadmapProductCategoriesResponse"
                }
              }
            }
          }
        },
        "tags": [
          "RoadmapService"
        ]
      }
    },
    "/v1/roadmap/requests": {
      "get": {
        "operationId": "RoadmapService_ListRoadmapFeatureRequests",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListRoadmapFeatureRequestsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "ROADMAP_REQUEST_STATUS_UNSPECIFIED",
                "ROADMAP_REQUEST_STATUS_IN_REVIEW",
                "ROADMAP_REQUEST_STATUS_PLANNED",
                "ROADMAP_REQUEST_STATUS_IN_PROGRESS",
                "ROADMAP_REQUEST_STATUS_COMPLETED",
                "ROADMAP_REQUEST_STATUS_DECLINED"
              ],
              "default": "ROADMAP_REQUEST_STATUS_UNSPECIFIED"
            }
          },
          {
            "name": "productSlug",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "RoadmapService"
        ]
      }
    },
    "/v1/roadmap/requests/{slug}": {
      "get": {
        "operationId": "RoadmapService_GetRoadmapFeatureRequest",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetRoadmapFeatureRequestResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "RoadmapService"
        ]
      }
    },
    "/v1/roadmap/requests/{slug}/comments": {
      "get": {
        "operationId": "RoadmapService_ListRoadmapFeatureRequestComments",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListRoadmapFeatureRequestCommentsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "RoadmapService"
        ]
      },
      "post": {
        "operationId": "RoadmapService_CreateRoadmapFeatureRequestComment",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateRoadmapFeatureRequestCommentResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RoadmapServiceCreateRoadmapFeatureRequestCommentBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "RoadmapService"
        ]
      }
    },
    "/v1/roadmap/requests/{slug}/vote": {
      "delete": {
        "operationId": "RoadmapService_RemoveRoadmapFeatureRequestVote",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VoteRoadmapFeatureRequestResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "RoadmapService"
        ]
      },
      "post": {
        "operationId": "RoadmapService_VoteRoadmapFeatureRequest",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VoteRoadmapFeatureRequestResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RoadmapServiceVoteRoadmapFeatureRequestBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "RoadmapService"
        ]
      }
    },
    "/v1/roadmap/stats": {
      "get": {
        "operationId": "RoadmapService_GetRoadmapStats",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetRoadmapStatsResponse"
                }
              }
            }
          }
        },
        "tags": [
          "RoadmapService"
        ]
      }
    },
    "/v1/roadmap/submit": {
      "post": {
        "operationId": "RoadmapService_SubmitRoadmapFeatureRequest",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SubmitRoadmapFeatureRequestResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1SubmitRoadmapFeatureRequestRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "RoadmapService"
        ]
      }
    },
    "/v1/roles": {
      "get": {
        "operationId": "RoleService_ListRoles",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListRolesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filterName",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "RoleService"
        ]
      },
      "post": {
        "operationId": "RoleService_CreateRole",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateRoleRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "RoleService"
        ]
      }
    },
    "/v1/roles/replace-for-group": {
      "put": {
        "operationId": "RoleService_ReplaceRoleForGroup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1ReplaceRoleForGroupRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "RoleService"
        ]
      }
    },
    "/v1/roles/replace-for-service-account": {
      "put": {
        "operationId": "RoleService_ReplaceRoleForServiceAccount",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1ReplaceRoleForServiceAccountRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "RoleService"
        ]
      }
    },
    "/v1/roles/replace-for-user": {
      "put": {
        "operationId": "RoleService_ReplaceRoleForUser",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1ReplaceRoleForUserRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "RoleService"
        ]
      }
    },
    "/v1/roles/{id}": {
      "delete": {
        "operationId": "RoleService_DeleteRole",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "RoleService"
        ]
      },
      "patch": {
        "operationId": "RoleService_UpdateRole",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdateRoleResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RoleServiceUpdateRoleBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "RoleService"
        ]
      }
    },
    "/v1/secrets": {
      "get": {
        "operationId": "SecretService_ListSecrets",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListSecretsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "SecretService"
        ]
      },
      "post": {
        "operationId": "SecretService_CreateSecret",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateSecretResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateSecretRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "SecretService"
        ]
      }
    },
    "/v1/secrets/{id}": {
      "get": {
        "operationId": "SecretService_GetSecret",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetSecretResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "SecretService"
        ]
      },
      "delete": {
        "operationId": "SecretService_DeleteSecret",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "SecretService"
        ]
      },
      "patch": {
        "operationId": "SecretService_UpdateSecret",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SecretServiceUpdateSecretBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "SecretService"
        ]
      }
    },
    "/v1/service-accounts": {
      "get": {
        "operationId": "ServiceAccountService_ListServiceAccounts",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListServiceAccountsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "includeInactive",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "ServiceAccountService"
        ]
      },
      "post": {
        "operationId": "ServiceAccountService_CreateServiceAccount",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ServiceAccountResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateServiceAccountRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ServiceAccountService"
        ]
      }
    },
    "/v1/service-accounts/tokens/{tokenId}": {
      "delete": {
        "operationId": "ServiceAccountService_RevokeToken",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "tokenId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ServiceAccountService"
        ]
      }
    },
    "/v1/service-accounts/{id}": {
      "get": {
        "operationId": "ServiceAccountService_GetServiceAccount",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ServiceAccountResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ServiceAccountService"
        ]
      },
      "delete": {
        "operationId": "ServiceAccountService_DeleteServiceAccount",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "ServiceAccountService"
        ]
      },
      "patch": {
        "operationId": "ServiceAccountService_UpdateServiceAccount",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ServiceAccountResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ServiceAccountServiceUpdateServiceAccountBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ServiceAccountService"
        ]
      }
    },
    "/v1/service-accounts/{serviceAccountId}/tokens": {
      "get": {
        "operationId": "ServiceAccountService_ListTokens",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListServiceAccountTokensResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "serviceAccountId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "includeInactive",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "ServiceAccountService"
        ]
      },
      "post": {
        "operationId": "ServiceAccountService_GenerateToken",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GenerateServiceAccountTokenResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "serviceAccountId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ServiceAccountServiceGenerateTokenBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "ServiceAccountService"
        ]
      }
    },
    "/v1/ssh-keys": {
      "get": {
        "operationId": "SSHKeyService_ListSSHKeys",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListSSHKeysResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "SSHKeyService"
        ]
      },
      "post": {
        "operationId": "SSHKeyService_CreateSSHKey",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateSSHKeyResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateSSHKeyRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "SSHKeyService"
        ]
      }
    },
    "/v1/ssh-keys/{id}": {
      "get": {
        "operationId": "SSHKeyService_GetSSHKey",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetSSHKeyResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "SSHKeyService"
        ]
      },
      "delete": {
        "operationId": "SSHKeyService_DeleteSSHKey",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "SSHKeyService"
        ]
      }
    },
    "/v1/subscriptions": {
      "get": {
        "operationId": "SubscriptionService_ListSubscriptions",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListSubscriptionsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "onlyActive",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "tags": [
          "SubscriptionService"
        ]
      }
    },
    "/v1/subscriptions/{subscriptionId}/addons": {
      "get": {
        "summary": "List addon subscriptions for a subscription",
        "operationId": "AddonService_ListAddonSubscriptions",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListAddonSubscriptionsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "addonStatus",
            "description": "Filter by status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "ADDON_STATUS_UNSPECIFIED",
                "ADDON_STATUS_ACTIVE",
                "ADDON_STATUS_CANCELED",
                "ADDON_STATUS_PAUSED",
                "ADDON_STATUS_PENDING_ACTIVATION"
              ],
              "default": "ADDON_STATUS_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "AddonService"
        ]
      },
      "post": {
        "summary": "Add an addon to a subscription",
        "operationId": "AddonService_AddAddonToSubscription",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1AddAddonToSubscriptionResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddonServiceAddAddonToSubscriptionBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "AddonService"
        ]
      }
    },
    "/v1/subscriptions/{subscriptionId}/coupon": {
      "get": {
        "operationId": "CouponService_GetSubscriptionCoupon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetSubscriptionCouponResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "CouponService"
        ]
      },
      "delete": {
        "operationId": "CouponService_RemoveCoupon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SubscriptionCoupon"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "CouponService"
        ]
      },
      "post": {
        "operationId": "CouponService_RedeemCoupon",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SubscriptionCoupon"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CouponServiceRedeemCouponBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "CouponService"
        ]
      }
    },
    "/v1/subscriptions:cancel": {
      "post": {
        "operationId": "SubscriptionService_Cancel",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CancelResponse"
                }
              }
            }
          }
        },
        "tags": [
          "SubscriptionService"
        ]
      }
    },
    "/v1/subscriptions:cancel-renewal": {
      "post": {
        "summary": "CancelRenewal: fixed-price plans stop renewing at current_period_end (VM stays; no\nrefund). Usage-based plans terminate immediately (same path as deleting the VM).",
        "operationId": "SubscriptionService_CancelRenewal",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CancelResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CancelRenewalRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "SubscriptionService"
        ]
      }
    },
    "/v1/subscriptions:retry-payment": {
      "post": {
        "operationId": "SubscriptionService_RetryPayment",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1RetryPaymentResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1RetryPaymentRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "SubscriptionService"
        ]
      }
    },
    "/v1/subscriptions:status": {
      "get": {
        "operationId": "SubscriptionService_GetSubscriptionStatus",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetSubscriptionStatusResponse"
                }
              }
            }
          }
        },
        "tags": [
          "SubscriptionService"
        ]
      }
    },
    "/v1/subscriptions:undo-cancel-renewal": {
      "post": {
        "summary": "UndoCancelRenewal clears cancel_at_period_end so the asset subscription renews again.",
        "operationId": "SubscriptionService_UndoCancelRenewal",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CancelResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1UndoCancelRenewalRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "SubscriptionService"
        ]
      }
    },
    "/v1/ticket-templates": {
      "get": {
        "operationId": "TicketService_ListTicketTemplates",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListTicketTemplatesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "TicketService"
        ]
      },
      "post": {
        "operationId": "TicketService_CreateTicketTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1TicketTemplate"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateTicketTemplateRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/ticket-templates/{id}": {
      "get": {
        "operationId": "TicketService_GetTicketTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1TicketTemplate"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "TicketService"
        ]
      },
      "delete": {
        "operationId": "TicketService_DeleteTicketTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "TicketService"
        ]
      },
      "patch": {
        "operationId": "TicketService_UpdateTicketTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1TicketTemplate"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TicketServiceUpdateTicketTemplateBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/tickets": {
      "get": {
        "operationId": "TicketService_ListTickets",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListTicketsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filterTicketStatus",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "TICKET_STATUS_UNSPECIFIED",
                "TICKET_STATUS_IN_PROGRESS",
                "TICKET_STATUS_ESCALATED",
                "TICKET_STATUS_PENDING",
                "TICKET_STATUS_AWAITING_REPLY",
                "TICKET_STATUS_RESOLVED",
                "TICKET_STATUS_WONT_FIX",
                "TICKET_STATUS_DUPLICATE",
                "TICKET_STATUS_NOT_REPRODUCIBLE"
              ],
              "default": "TICKET_STATUS_UNSPECIFIED"
            }
          },
          {
            "name": "filterCaseType",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "CASE_TYPE_UNSPECIFIED",
                "CASE_TYPE_BILLING",
                "CASE_TYPE_GENERAL",
                "CASE_TYPE_TROUBLESHOOTING",
                "CASE_TYPE_OUTAGE",
                "CASE_TYPE_ABUSE",
                "CASE_TYPE_CONFIGURATION_CHANGE"
              ],
              "default": "CASE_TYPE_UNSPECIFIED"
            }
          },
          {
            "name": "filterPriority",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "TICKET_PRIORITY_UNSPECIFIED",
                "TICKET_PRIORITY_LOW",
                "TICKET_PRIORITY_NORMAL",
                "TICKET_PRIORITY_HIGH",
                "TICKET_PRIORITY_URGENT",
                "TICKET_PRIORITY_CRITICAL"
              ],
              "default": "TICKET_PRIORITY_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "TicketService"
        ]
      },
      "post": {
        "operationId": "TicketService_CreateTicket",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateTicketResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateTicketRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/tickets/attachments/{attachmentId}": {
      "delete": {
        "operationId": "TicketService_DeleteTicketAttachment",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "attachmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/tickets/attachments/{attachmentId}:download": {
      "get": {
        "operationId": "TicketService_DownloadTicketAttachment",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1DownloadTicketAttachmentResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "attachmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/tickets/attachments:confirm-upload": {
      "post": {
        "operationId": "TicketService_ConfirmTicketAttachmentUpload",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1TicketAttachment"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1ConfirmTicketAttachmentUploadRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/tickets/attachments:upload-content": {
      "post": {
        "operationId": "TicketService_UploadTicketAttachmentContent",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1TicketAttachment"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1UploadTicketAttachmentContentRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/tickets/{id}": {
      "get": {
        "operationId": "TicketService_GetTicket",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetTicketResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "TicketService"
        ]
      },
      "delete": {
        "operationId": "TicketService_DeleteTicket",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/tickets/{ticketId}/attachments": {
      "get": {
        "operationId": "TicketService_ListTicketAttachments",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListTicketAttachmentsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "ticketId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/tickets/{ticketId}/attachments:upload": {
      "post": {
        "operationId": "TicketService_CreateTicketAttachmentUpload",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1CreateTicketAttachmentUploadResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "ticketId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TicketServiceCreateTicketAttachmentUploadBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/tickets/{ticketId}/internal-comments": {
      "get": {
        "operationId": "TicketService_ListInternalComments",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListInternalCommentsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "ticketId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/tickets/{ticketId}:add-reply": {
      "post": {
        "operationId": "TicketService_AddReplyToTicket",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "ticketId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TicketServiceAddReplyToTicketBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/tickets/{ticketId}:internal-comment": {
      "post": {
        "operationId": "TicketService_AddInternalComment",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1AddInternalCommentResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "ticketId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TicketServiceAddInternalCommentBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/tickets/{ticketId}:set-priority": {
      "post": {
        "operationId": "TicketService_SetTicketPriority",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "ticketId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TicketServiceSetTicketPriorityBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/tickets/{ticketId}:set-status": {
      "post": {
        "operationId": "TicketService_SetTicketStatus",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "ticketId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TicketServiceSetTicketStatusBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/tickets:search": {
      "post": {
        "operationId": "TicketService_SearchTickets",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SearchTicketsResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1SearchTicketsRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "TicketService"
        ]
      }
    },
    "/v1/usage/record": {
      "post": {
        "summary": "Record a single usage event (from Prometheus or other monitoring systems)",
        "operationId": "UsageReportService_RecordUsage",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1RecordUsageResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1RecordUsageRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UsageReportService"
        ]
      }
    },
    "/v1/usage/record:batch": {
      "post": {
        "summary": "Batch record multiple usage events (for bulk ingestion)",
        "operationId": "UsageReportService_BatchRecordUsage",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1BatchRecordUsageResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1BatchRecordUsageRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UsageReportService"
        ]
      }
    },
    "/v1/usage/records": {
      "get": {
        "summary": "List usage records with filters",
        "operationId": "UsageReportService_ListUsageRecords",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListUsageRecordsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "subscriptionId",
            "description": "Filters",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "metricId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "usageRecordStatus",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "USAGE_RECORD_STATUS_UNSPECIFIED",
                "USAGE_RECORD_STATUS_PENDING",
                "USAGE_RECORD_STATUS_PROCESSED",
                "USAGE_RECORD_STATUS_BILLED",
                "USAGE_RECORD_STATUS_FAILED"
              ],
              "default": "USAGE_RECORD_STATUS_UNSPECIFIED"
            }
          },
          {
            "name": "startTime",
            "description": "Time range",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "endTime",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "page",
            "description": "Pagination",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "UsageReportService"
        ]
      }
    },
    "/v1/usage/records/{id}": {
      "get": {
        "summary": "Get a specific usage record by ID",
        "operationId": "UsageReportService_GetUsageRecord",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetUsageRecordResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "UsageReportService"
        ]
      }
    },
    "/v1/usage/report": {
      "get": {
        "summary": "Get aggregated usage report for a billing period",
        "operationId": "UsageReportService_GetUsageReport",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetUsageReportResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "subscriptionId",
            "description": "Required filters",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "metricId",
            "description": "Optional filters",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "billingPeriodStart",
            "description": "Billing period (if not provided, uses current billing period)",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "billingPeriodEnd",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "includeBilled",
            "description": "Options\n\nInclude already billed records",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "tags": [
          "UsageReportService"
        ]
      }
    },
    "/v1/users": {
      "get": {
        "operationId": "UserService_ListUsers",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListUsersResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filterEmail",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterStatus",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "STATUS_UNSPECIFIED",
                "STATUS_ACTIVE",
                "STATUS_INACTIVE",
                "STATUS_BANNED",
                "STATUS_SOFT_DELETED"
              ],
              "default": "STATUS_UNSPECIFIED"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/users/{id}": {
      "get": {
        "operationId": "UserService_GetUser",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetUserResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "UserService"
        ]
      },
      "delete": {
        "operationId": "UserService_DeleteUser",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "UserService"
        ]
      },
      "patch": {
        "operationId": "UserService_UpdateUser",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdateUserResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserServiceUpdateUserBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "UserService"
        ]
      }
    },
    "/v1/version": {
      "get": {
        "operationId": "MetadataService_GetVersion",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1Metadata"
                }
              }
            }
          }
        },
        "tags": [
          "MetadataService"
        ]
      }
    },
    "/v1/virtual-machines": {
      "get": {
        "operationId": "VirtualMachineService_ListVirtualMachines",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListVirtualMachinesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filterOperationStatus",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "OPERATION_STATUS_UNSPECIFIED",
                "OPERATION_STATUS_CREATED",
                "OPERATION_STATUS_STARTED",
                "OPERATION_STATUS_STOPPED",
                "OPERATION_STATUS_DELETED",
                "OPERATION_STATUS_RESTARTED",
                "OPERATION_STATUS_REINSTALLING"
              ],
              "default": "OPERATION_STATUS_UNSPECIFIED"
            }
          }
        ],
        "tags": [
          "VirtualMachineService"
        ]
      },
      "post": {
        "operationId": "VirtualMachineService_CreateVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateVirtualMachineRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "VirtualMachineService"
        ]
      }
    },
    "/v1/virtual-machines/tags": {
      "get": {
        "summary": "ListVMTags returns all unique tags from virtual machines belonging to the organization",
        "operationId": "VirtualMachineService_ListVMTags",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListVMTagsResponse"
                }
              }
            }
          }
        },
        "tags": [
          "VirtualMachineService"
        ]
      }
    },
    "/v1/virtual-machines/{id}": {
      "get": {
        "operationId": "VirtualMachineService_GetVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VirtualMachine"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "VirtualMachineService"
        ]
      },
      "delete": {
        "operationId": "VirtualMachineService_DeleteVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "VirtualMachineService"
        ]
      },
      "patch": {
        "operationId": "VirtualMachineService_UpdateVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VirtualMachine"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VirtualMachineServiceUpdateVirtualMachineBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "VirtualMachineService"
        ]
      }
    },
    "/v1/virtual-machines/{id}/console": {
      "get": {
        "summary": "GetVNCConsole returns WebSocket URL for VNC console access.",
        "operationId": "VirtualMachineService_GetVNCConsole",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetVNCConsoleResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "VirtualMachineService"
        ]
      }
    },
    "/v1/virtual-machines/{id}:attach-firewall": {
      "post": {
        "operationId": "VirtualMachineService_AttachVMFirewall",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VirtualMachineServiceAttachVMFirewallBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "VirtualMachineService"
        ]
      }
    },
    "/v1/virtual-machines/{id}:detach-firewall": {
      "post": {
        "operationId": "VirtualMachineService_DetachVMFirewall",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VirtualMachineServiceDetachVMFirewallBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "VirtualMachineService"
        ]
      }
    },
    "/v1/virtual-machines/{id}:reinstall": {
      "post": {
        "operationId": "VirtualMachineService_ReinstallVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VirtualMachine"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VirtualMachineServiceReinstallVirtualMachineBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "VirtualMachineService"
        ]
      }
    },
    "/v1/virtual-machines/{id}:restart": {
      "post": {
        "operationId": "VirtualMachineService_RestartVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VirtualMachine"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VirtualMachineServiceRestartVirtualMachineBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "VirtualMachineService"
        ]
      }
    },
    "/v1/virtual-machines/{id}:start": {
      "post": {
        "operationId": "VirtualMachineService_StartVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VirtualMachine"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VirtualMachineServiceStartVirtualMachineBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "VirtualMachineService"
        ]
      }
    },
    "/v1/virtual-machines/{id}:stop": {
      "post": {
        "operationId": "VirtualMachineService_StopVirtualMachine",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1VirtualMachine"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VirtualMachineServiceStopVirtualMachineBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "VirtualMachineService"
        ]
      }
    },
    "/v1/virtual-machines/{vmId}/backups": {
      "get": {
        "operationId": "BackupService_ListBackups",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListBackupsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "vmId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "BACKUP_STATUS_UNSPECIFIED",
                "BACKUP_STATUS_ACTIVE",
                "BACKUP_STATUS_DELETED",
                "BACKUP_STATUS_EXPIRED",
                "BACKUP_STATUS_UNKNOWN"
              ],
              "default": "BACKUP_STATUS_UNSPECIFIED"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "BackupService"
        ]
      }
    },
    "/v1/virtual-machines/{vmId}/backups/{backupId}": {
      "get": {
        "operationId": "BackupService_GetBackup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetBackupResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "vmId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "backupId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "BackupService"
        ]
      },
      "delete": {
        "operationId": "BackupService_DeleteBackup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "vmId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "backupId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "BackupService"
        ]
      }
    },
    "/v1/virtual-machines/{vmId}/backups/{backupId}/restore": {
      "post": {
        "operationId": "BackupService_RestoreBackup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "vmId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "backupId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1BackupServiceRestoreBackupBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "BackupService"
        ]
      }
    },
    "/v1/virtual-machines/{vmId}/snapshots": {
      "get": {
        "operationId": "SnapshotService_ListSnapshots",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListSnapshotsResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "vmId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "SNAPSHOT_STATUS_UNSPECIFIED",
                "SNAPSHOT_STATUS_ACTIVE",
                "SNAPSHOT_STATUS_DELETED",
                "SNAPSHOT_STATUS_EXPIRED",
                "SNAPSHOT_STATUS_UNKNOWN"
              ],
              "default": "SNAPSHOT_STATUS_UNSPECIFIED"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "SnapshotService"
        ]
      },
      "post": {
        "operationId": "SnapshotService_CreateSnapshot",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "vmId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SnapshotServiceCreateSnapshotBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "SnapshotService"
        ]
      }
    },
    "/v1/virtual-machines/{vmId}/snapshots/{snapshotId}": {
      "get": {
        "operationId": "SnapshotService_GetSnapshot",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetSnapshotResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "vmId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "snapshotId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "SnapshotService"
        ]
      },
      "delete": {
        "operationId": "SnapshotService_DeleteSnapshot",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "vmId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "snapshotId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "SnapshotService"
        ]
      }
    },
    "/v1/virtual-machines/{vmId}/snapshots/{snapshotId}/restore": {
      "post": {
        "operationId": "SnapshotService_RestoreSnapshot",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "vmId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "snapshotId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SnapshotServiceRestoreSnapshotBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "SnapshotService"
        ]
      }
    },
    "/v1/virtual-machines/{vmId}:disable-additional-ip": {
      "post": {
        "summary": "DisableAdditionalIP releases one additional IPv4 and updates ADDITIONAL-IP addon quantity.",
        "operationId": "VirtualMachineService_DisableAdditionalIP",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "vmId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VirtualMachineServiceDisableAdditionalIPBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "VirtualMachineService"
        ]
      }
    },
    "/v1/virtual-machines/{vmId}:disable-backup": {
      "post": {
        "summary": "DisableBackup disables backup addon for a virtual machine",
        "operationId": "VirtualMachineService_DisableBackup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "vmId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VirtualMachineServiceDisableBackupBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "VirtualMachineService"
        ]
      }
    },
    "/v1/virtual-machines/{vmId}:enable-additional-ip": {
      "post": {
        "summary": "EnableAdditionalIP allocates an extra IPv4 from the VM primary prefix and subscribes to ADDITIONAL-IP billing.",
        "operationId": "VirtualMachineService_EnableAdditionalIP",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1EnableAdditionalIPResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "vmId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VirtualMachineServiceEnableAdditionalIPBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "VirtualMachineService"
        ]
      }
    },
    "/v1/virtual-machines/{vmId}:enable-backup": {
      "post": {
        "summary": "EnableBackup enables backup addon for a virtual machine",
        "operationId": "VirtualMachineService_EnableBackup",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "vmId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VirtualMachineServiceEnableBackupBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "VirtualMachineService"
        ]
      }
    },
    "/v1/vmtemplate": {
      "post": {
        "operationId": "VMTemplateService_CreateVMTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1CreateVMTemplateRequest"
              }
            }
          },
          "required": true
        },
        "tags": [
          "VMTemplateService"
        ]
      }
    },
    "/v1/vmtemplate/{id}": {
      "get": {
        "operationId": "VMTemplateService_GetVMTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetVMTemplateResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "VMTemplateService"
        ]
      },
      "delete": {
        "operationId": "VMTemplateService_DeleteVMTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1SuccessResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "VMTemplateService"
        ]
      },
      "patch": {
        "operationId": "VMTemplateService_UpdateVMTemplate",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1UpdateVMTemplateResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VMTemplateServiceUpdateVMTemplateBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "VMTemplateService"
        ]
      }
    },
    "/v1/vmtemplates": {
      "get": {
        "operationId": "VMTemplateService_ListVMTemplates",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1ListVMTemplatesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "nodeId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platformId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "distro",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "VMTemplateService"
        ]
      }
    }
  },
  "security": [
    {
      "BearerAuth": [],
      "OrgIDHeader": []
    }
  ],
  "servers": [
    {
      "url": "https://api.noderings.com"
    }
  ],
  "components": {
    "requestBodies": {
      "v1ChatRequest": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/v1ChatRequest"
            }
          }
        },
        "required": true
      },
      "ProviderConnectService_CreateConnectTaxSessionBody": {
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {}
            }
          }
        },
        "required": true
      }
    },
    "securitySchemes": {
      "BearerAuth": {
        "type": "apiKey",
        "description": "Bearer token",
        "name": "Authorization",
        "in": "header"
      },
      "OrgIDHeader": {
        "type": "apiKey",
        "description": "Tenant or organization identifier",
        "name": "X-Organization-ID",
        "in": "header"
      }
    },
    "schemas": {
      "AddonServiceAddAddonToSubscriptionBody": {
        "type": "object",
        "properties": {
          "addonId": {
            "type": "string"
          },
          "addonPriceId": {
            "type": "string"
          },
          "quantity": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "AddonServiceUndoCancelAddonBody": {
        "type": "object"
      },
      "AddonServiceUpdateAddonBody": {
        "type": "object",
        "properties": {
          "currency": {
            "type": "string",
            "title": "Currency for the addon price (optional, must be 3 characters if provided)"
          },
          "unitAmount": {
            "type": "string",
            "description": "Decimal string with 6 decimal places precision",
            "title": "Override unit_amount_minor for the addon price (optional)"
          },
          "percentageValue": {
            "type": "number",
            "format": "double",
            "title": "Override percentage value for percentage-based pricing formula (optional,\n0-100)"
          },
          "zeroBaseFallbackAmount": {
            "type": "string",
            "description": "Decimal string with 6 decimal places precision",
            "title": "Optional: Fixed amount to use when base plan price is zero (for free plans)\nOnly used for percentage-based pricing formulas when parent_plan.base_price\nis 0"
          }
        }
      },
      "AgentServiceGenerateInstallCommandBody": {
        "type": "object"
      },
      "AgentServiceGeneratePeeringConfigBody": {
        "type": "object"
      },
      "AgentServiceUpdateAgentBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "hypervisorDriver": {
            "$ref": "#/components/schemas/v1PlatformDriver"
          }
        }
      },
      "AgentServiceUploadInboundPeeringConfigBody": {
        "type": "object",
        "properties": {
          "kubeconfig": {
            "type": "string",
            "description": "Provider-generated peering-user kubeconfig YAML for neo as consumer."
          }
        }
      },
      "ClientProviderReviewServiceUpdateClientReviewBody": {
        "type": "object",
        "properties": {
          "starRating": {
            "type": "integer",
            "format": "int32"
          },
          "comment": {
            "type": "string"
          }
        }
      },
      "CloudInitTemplateServiceUpdateCloudInitTemplateBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "userData": {
            "type": "string"
          },
          "vendorData": {
            "type": "string"
          },
          "networkData": {
            "type": "string"
          },
          "storage": {
            "type": "string"
          }
        }
      },
      "CloudInitUserDataServiceUpdateCloudInitUserDataBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "userData": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        }
      },
      "CouponServiceCreateCouponCodeBody": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Leave empty to generate a random code."
          },
          "maxRedemptions": {
            "type": "integer",
            "format": "int32"
          },
          "validFrom": {
            "type": "string",
            "format": "date-time"
          },
          "validUntil": {
            "type": "string",
            "format": "date-time"
          },
          "noExpiry": {
            "type": "boolean"
          },
          "customerOrgIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "campaign": {
            "type": "string"
          },
          "channel": {
            "type": "string"
          }
        }
      },
      "CouponServiceDeactivateCouponBody": {
        "type": "object"
      },
      "CouponServiceGenerateCouponCodesBody": {
        "type": "object",
        "properties": {
          "count": {
            "type": "integer",
            "format": "int32"
          },
          "prefix": {
            "type": "string",
            "description": "Optional letters or digits put before each code as PREFIX-XXXXXXXXXX."
          },
          "maxRedemptions": {
            "type": "integer",
            "format": "int32",
            "description": "Uses per code. Defaults to 1 (single-use)."
          },
          "validUntil": {
            "type": "string",
            "format": "date-time"
          },
          "campaign": {
            "type": "string"
          },
          "channel": {
            "type": "string"
          }
        }
      },
      "CouponServiceRedeemCouponBody": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          }
        }
      },
      "CouponServiceRevokeCouponBody": {
        "type": "object",
        "properties": {
          "confirm": {
            "type": "boolean",
            "description": "Must be true; revoking ends the discount for every customer."
          }
        }
      },
      "CouponServiceUpdateCouponBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "addAmountsOff": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Adds amounts for currencies the coupon does not list yet. Existing amounts are read-only."
          },
          "validUntil": {
            "type": "string",
            "format": "date-time"
          },
          "noExpiry": {
            "type": "boolean"
          },
          "maxRedemptions": {
            "type": "integer",
            "format": "int32"
          },
          "acknowledgeHighRisk": {
            "type": "boolean"
          }
        }
      },
      "CouponServiceUpdateCouponCodeBody": {
        "type": "object",
        "properties": {
          "maxRedemptions": {
            "type": "integer",
            "format": "int32"
          },
          "validUntil": {
            "type": "string",
            "format": "date-time"
          },
          "noExpiry": {
            "type": "boolean"
          },
          "active": {
            "type": "boolean"
          },
          "campaign": {
            "type": "string"
          },
          "channel": {
            "type": "string"
          }
        }
      },
      "DnsRecordServiceCheckDnsGeoRecordBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "continent": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "region": {
            "type": "string"
          }
        }
      },
      "DnsRecordServiceUpsertDnsGeoRecordBody": {
        "type": "object",
        "properties": {
          "record": {
            "$ref": "#/components/schemas/v1DnsGeoRecord"
          }
        }
      },
      "DnsRecordServiceUpsertDnsRecordBody": {
        "type": "object",
        "properties": {
          "record": {
            "$ref": "#/components/schemas/v1DnsRecord"
          }
        }
      },
      "DnsZoneServiceCheckDnsZoneDelegationBody": {
        "type": "object"
      },
      "DnsZoneServiceImportDnsRecordsBody": {
        "type": "object",
        "properties": {
          "records": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DnsRecord"
            }
          }
        }
      },
      "DnsZoneServiceImportDnsZoneBody": {
        "type": "object",
        "properties": {
          "zoneText": {
            "type": "string"
          }
        }
      },
      "DnssecServiceCheckDnssecDsBody": {
        "type": "object"
      },
      "DnssecServiceDisableDnssecBody": {
        "type": "object",
        "properties": {
          "force": {
            "type": "boolean"
          }
        }
      },
      "DnssecServiceEnableDnssecBody": {
        "type": "object"
      },
      "EnforcementServiceBanOrganizationBody": {
        "type": "object",
        "properties": {
          "reason": {
            "$ref": "#/components/schemas/v1ComplianceReason"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "EnforcementServiceBanUserBody": {
        "type": "object",
        "properties": {
          "reason": {
            "$ref": "#/components/schemas/v1ComplianceReason"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "EnforcementServiceBlockOrganizationPurchasesBody": {
        "type": "object",
        "properties": {
          "providerOrganizationId": {
            "type": "string"
          },
          "reason": {
            "$ref": "#/components/schemas/v1ComplianceReason"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "EnforcementServiceDeletePlatformVirtualMachineBody": {
        "type": "object"
      },
      "EnforcementServiceSuspendPlatformVirtualMachineBody": {
        "type": "object",
        "properties": {
          "reason": {
            "$ref": "#/components/schemas/v1ComplianceReason"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "EnforcementServiceUnbanOrganizationBody": {
        "type": "object"
      },
      "EnforcementServiceUnbanUserBody": {
        "type": "object"
      },
      "EnforcementServiceUnblockOrganizationPurchasesBody": {
        "type": "object",
        "properties": {
          "providerOrganizationId": {
            "type": "string"
          }
        }
      },
      "EnforcementServiceUnblockPlatformVirtualMachineBody": {
        "type": "object"
      },
      "EnvironmentVariableServiceUpdateEnvironmentVariableBody": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string"
          }
        }
      },
      "FirewallServiceCreateFirewallRuleBody": {
        "type": "object",
        "properties": {
          "rule": {
            "$ref": "#/components/schemas/v1FirewallRuleInput"
          }
        }
      },
      "FirewallServiceMoveFirewallRuleBody": {
        "type": "object",
        "properties": {
          "targetRuleId": {
            "type": "string",
            "title": "ID of the target rule to move relative to"
          },
          "position": {
            "$ref": "#/components/schemas/v1FirewallRulePosition"
          }
        },
        "description": "MoveFirewallRuleRequest is used to reorder firewall rules via drag-and-drop.\nThe rule specified by `id` will be moved to a position relative to `target_rule_id`.\nRules can only be moved within the same direction (ingress/egress)."
      },
      "FirewallServiceUpdateFirewallAddressGroupBody": {
        "type": "object",
        "properties": {
          "group": {
            "$ref": "#/components/schemas/v1FirewallAddressGroupInput"
          }
        }
      },
      "FirewallServiceUpdateFirewallRuleBody": {
        "type": "object",
        "properties": {
          "rule": {
            "$ref": "#/components/schemas/v1FirewallRuleInput"
          }
        }
      },
      "FirewallServiceUpdateFirewallRuleSetBody": {
        "type": "object",
        "properties": {
          "ruleset": {
            "$ref": "#/components/schemas/v1FirewallRuleSetInput"
          }
        }
      },
      "GameServerServiceArchiveFilesBody": {
        "type": "object",
        "properties": {
          "root": {
            "type": "string"
          },
          "files": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "GameServerServiceChangeGameServerGameBody": {
        "type": "object",
        "properties": {
          "templateId": {
            "type": "string"
          },
          "environment": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "acceptEula": {
            "type": "boolean"
          }
        }
      },
      "GameServerServiceCopyFileBody": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string"
          }
        }
      },
      "GameServerServiceCreateAllocationBody": {
        "type": "object"
      },
      "GameServerServiceCreateBackupBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          }
        }
      },
      "GameServerServiceCreateDatabaseBody": {
        "type": "object",
        "properties": {
          "database": {
            "type": "string"
          },
          "remote": {
            "type": "string"
          }
        }
      },
      "GameServerServiceCreateFolderBody": {
        "type": "object",
        "properties": {
          "root": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "GameServerServiceCreateScheduleBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "minute": {
            "type": "string"
          },
          "hour": {
            "type": "string"
          },
          "dayOfMonth": {
            "type": "string"
          },
          "month": {
            "type": "string"
          },
          "dayOfWeek": {
            "type": "string"
          },
          "onlyWhenOnline": {
            "type": "boolean"
          },
          "isActive": {
            "type": "boolean",
            "description": "Omitted means the schedule is created enabled."
          }
        }
      },
      "GameServerServiceCreateScheduleTaskBody": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string"
          },
          "payload": {
            "type": "string"
          },
          "timeOffset": {
            "type": "integer",
            "format": "int32"
          },
          "continueOnFailure": {
            "type": "boolean"
          }
        }
      },
      "GameServerServiceDeleteFilesBody": {
        "type": "object",
        "properties": {
          "root": {
            "type": "string"
          },
          "files": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "GameServerServiceExecuteScheduleBody": {
        "type": "object"
      },
      "GameServerServiceLockBackupBody": {
        "type": "object",
        "properties": {
          "truncate": {
            "type": "boolean",
            "description": "Restore only. When true, the panel deletes every file before extracting the backup."
          }
        }
      },
      "GameServerServiceOpenConsoleBody": {
        "type": "object"
      },
      "GameServerServicePowerGameServerBody": {
        "type": "object",
        "properties": {
          "signal": {
            "type": "string"
          }
        }
      },
      "GameServerServiceReinstallGameServerBody": {
        "type": "object"
      },
      "GameServerServiceRenameFileBody": {
        "type": "object",
        "properties": {
          "root": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "dest": {
            "type": "string"
          }
        }
      },
      "GameServerServiceRenameGameServerBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          }
        }
      },
      "GameServerServiceRotateDatabasePasswordBody": {
        "type": "object"
      },
      "GameServerServiceSetPrimaryAllocationBody": {
        "type": "object"
      },
      "GameServerServiceUpdateAllocationBody": {
        "type": "object",
        "properties": {
          "notes": {
            "type": "string"
          }
        }
      },
      "GameServerServiceUpdateDockerImageBody": {
        "type": "object",
        "properties": {
          "dockerImage": {
            "type": "string"
          }
        }
      },
      "GameServerServiceUpdateScheduleBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "minute": {
            "type": "string"
          },
          "hour": {
            "type": "string"
          },
          "dayOfMonth": {
            "type": "string"
          },
          "month": {
            "type": "string"
          },
          "dayOfWeek": {
            "type": "string"
          },
          "onlyWhenOnline": {
            "type": "boolean"
          },
          "isActive": {
            "type": "boolean"
          }
        }
      },
      "GameServerServiceUpdateScheduleTaskBody": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string"
          },
          "payload": {
            "type": "string"
          },
          "timeOffset": {
            "type": "integer",
            "format": "int32"
          },
          "continueOnFailure": {
            "type": "boolean"
          },
          "sequenceId": {
            "type": "integer",
            "format": "int32",
            "description": "Omitted leaves the task where it is. Set it to move the task in the run order."
          }
        }
      },
      "GameServerServiceUpdateStartupVariableBody": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "GameServerServiceUploadFileBody": {
        "type": "object",
        "properties": {
          "directory": {
            "type": "string"
          },
          "filename": {
            "type": "string"
          },
          "content": {
            "type": "string",
            "format": "byte"
          }
        }
      },
      "GameServerServiceWriteFileBody": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string"
          },
          "content": {
            "type": "string",
            "format": "byte"
          }
        }
      },
      "GameServerTemplateServiceDuplicateGameServerTemplateBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          }
        }
      },
      "GameServerTemplateServiceUpdateGameServerTemplateBody": {
        "type": "object",
        "properties": {
          "nestId": {
            "type": "integer",
            "format": "int32"
          },
          "eggId": {
            "type": "integer",
            "format": "int32"
          },
          "startup": {
            "type": "string"
          },
          "dockerImage": {
            "type": "string"
          },
          "versionVariable": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "confirmed": {
            "type": "boolean"
          },
          "hidden": {
            "type": "boolean"
          },
          "orderingEnabled": {
            "type": "boolean"
          }
        }
      },
      "GroupServiceUpdateGroupBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "groupRoles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "IPAMServiceAddReservedIPBody": {
        "type": "object",
        "properties": {
          "ipAddress": {
            "type": "string",
            "title": "Must be within prefix CIDR"
          }
        },
        "title": "IP Reservation"
      },
      "IPAMServiceAddReservedPrefixBody": {
        "type": "object",
        "properties": {
          "cidr": {
            "type": "string",
            "title": "Must match prefix vm_assignment_prefix_length exactly"
          }
        }
      },
      "IPAMServiceAssignNetworkToNodeBody": {
        "type": "object",
        "properties": {
          "nodeIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "One or more node IDs to assign to this network"
          }
        },
        "title": "Node-Network assignment"
      },
      "IPAMServiceClearAllPrefixReservedIPsBody": {
        "type": "object"
      },
      "IPAMServiceReserveAllPrefixIPsBody": {
        "type": "object"
      },
      "IPAMServiceUpdateNetworkBody": {
        "type": "object",
        "properties": {
          "dnsServers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "macAddressPrefix": {
            "type": "string",
            "description": "First 3 octets for MAC allocation within this network. Empty = leave unchanged on update."
          }
        }
      },
      "IPAMServiceUpdatePrefixBody": {
        "type": "object",
        "properties": {
          "networkId": {
            "type": "string"
          },
          "gateway": {
            "type": "string"
          },
          "reservedIps": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "allocationStrategy": {
            "$ref": "#/components/schemas/v1AllocationStrategy"
          },
          "description": {
            "type": "string"
          }
        }
      },
      "InvoiceServicePayInvoiceBody": {
        "type": "object"
      },
      "LiveValidationServiceStartPlanLiveValidationBody": {
        "type": "object",
        "properties": {
          "nodeId": {
            "type": "string"
          },
          "includeBenchmarking": {
            "type": "boolean"
          }
        }
      },
      "MetricsCredentialServiceRevokeMetricsWriteCredentialBody": {
        "type": "object"
      },
      "MetricsCredentialServiceRotateMetricsWriteCredentialBody": {
        "type": "object"
      },
      "NodeServiceUpdateNodeBody": {
        "type": "object",
        "properties": {
          "regionId": {
            "type": "string"
          },
          "cpuOverallocatePercent": {
            "type": "integer",
            "format": "int32"
          },
          "memoryOverallocatePercent": {
            "type": "integer",
            "format": "int32"
          },
          "storageOverallocatePercent": {
            "type": "integer",
            "format": "int32"
          },
          "vmidSeed": {
            "type": "integer",
            "format": "int32",
            "description": "Proxmox VMID seed. Zero means unchanged. Pterodactyl, VirtFusion, and\nSolusVM node edits omit it; the range applies only when a seed is sent."
          },
          "maintenanceMode": {
            "type": "boolean"
          },
          "vmStorageDestination": {
            "type": "string"
          },
          "backupStorageDestination": {
            "type": "string"
          },
          "backupStorageCompression": {
            "$ref": "#/components/schemas/v1BackupStorageCompression"
          },
          "networkBridge": {
            "type": "string",
            "title": "Node provisioning settings (empty string / absent = leave unchanged)"
          },
          "networkName": {
            "type": "string"
          },
          "networkVlanId": {
            "type": "integer",
            "format": "int32",
            "description": "Omit to leave unchanged; 0 = untagged."
          },
          "networkModel": {
            "type": "string"
          },
          "computeType": {
            "$ref": "#/components/schemas/v1NodeComputeType"
          },
          "topologyPaste": {
            "type": "string",
            "description": "Topology re-paste for dedicated nodes. Rejected if it would orphan a\ncurrently allocated CPU. Empty = leave stored topology unchanged."
          },
          "metadata": {
            "type": "object"
          },
          "wingsNodeName": {
            "type": "string"
          },
          "pterodactylLocationId": {
            "type": "integer",
            "format": "int32"
          },
          "panelNodeId": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "PaymentMethodServiceSetDefaultPaymentMethodBody": {
        "type": "object"
      },
      "PlatformServiceAssignAgentBody": {
        "type": "object",
        "properties": {
          "agentId": {
            "type": "string"
          }
        }
      },
      "PlatformServiceUnassignAgentBody": {
        "type": "object",
        "properties": {
          "agentId": {
            "type": "string"
          }
        }
      },
      "PlatformServiceUpdatePlatformBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "endpointUrl": {
            "type": "string",
            "description": "Immutable after create. Empty or equal to the stored URL is ignored;\nany other value is rejected."
          },
          "assignCustomerIpv6": {
            "type": "boolean",
            "description": "VirtFusion/SolusVM only. Unset means leave unchanged. True is rejected for Proxmox."
          }
        }
      },
      "ProviderConnectServiceExpireConnectTaxRegistrationBody": {
        "type": "object"
      },
      "ProviderCustomerServiceBlockProviderCustomerPurchasesBody": {
        "type": "object",
        "properties": {
          "reason": {
            "$ref": "#/components/schemas/v1ComplianceReason"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "ProviderCustomerServiceRestartProviderCustomerVirtualMachineBody": {
        "type": "object",
        "description": "Shared request body for Start/Stop/Restart customer VM RPCs (same fields; operation is the RPC).\nThe server must verify the VM belongs to this provider and client org."
      },
      "ProviderCustomerServiceStartProviderCustomerVirtualMachineBody": {
        "type": "object",
        "description": "Shared request body for Start/Stop/Restart customer VM RPCs (same fields; operation is the RPC).\nThe server must verify the VM belongs to this provider and client org."
      },
      "ProviderCustomerServiceStopProviderCustomerVirtualMachineBody": {
        "type": "object",
        "description": "Shared request body for Start/Stop/Restart customer VM RPCs (same fields; operation is the RPC).\nThe server must verify the VM belongs to this provider and client org."
      },
      "ProviderCustomerServiceSuspendProviderCustomerVirtualMachineBody": {
        "type": "object",
        "properties": {
          "reason": {
            "$ref": "#/components/schemas/v1ComplianceReason"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "ProviderCustomerServiceUnblockProviderCustomerPurchasesBody": {
        "type": "object"
      },
      "ProviderCustomerServiceUnblockProviderCustomerVirtualMachineBody": {
        "type": "object"
      },
      "ProviderNetworkServiceUpdateVirtualMachineSmtpOutboundPolicyBody": {
        "type": "object",
        "properties": {
          "action": {
            "$ref": "#/components/schemas/v1SmtpOutboundVmAction"
          }
        }
      },
      "ProviderPlanServiceUpdatePlanBody": {
        "type": "object",
        "properties": {
          "currency": {
            "type": "string",
            "title": "Plan fields to update (name, description, and trial_days come from\ntemplate, not updatable)"
          },
          "planPrices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PlanPriceOverride"
            },
            "title": "Plan prices with overrides (unit_amount_minor, currency, free_units per\nmetric)"
          },
          "addonPriceOverrides": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1AddonPriceOverride"
            },
            "title": "Optional: Override prices for addons when updating plan"
          },
          "regionId": {
            "type": "string",
            "description": "Region for this plan offer (optional on update)."
          },
          "cpuLimit": {
            "type": "integer",
            "format": "int32",
            "description": "Plan CPU/network scheduling overrides written into metadata.specifications.\nOnly affects VMs created after the update (VMs snapshot plan values at create)."
          },
          "cpuUnits": {
            "type": "integer",
            "format": "int32"
          },
          "networkRateLimitMbs": {
            "type": "number",
            "format": "double"
          },
          "nodeIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "When non-empty, replaces the plan's assigned nodes (same rules as create).\nOmitted / empty leaves existing assignments unchanged."
          },
          "onCreditExhaustion": {
            "type": "string",
            "description": "Provider choice when client prepaid credits are exhausted.\nValues: \"suspend\" (default), \"continue_with_dunning\"."
          },
          "metadata": {
            "type": "object",
            "description": "Plan metadata. VirtFusion package_id lives under metadata.virtfusion.package_id."
          }
        }
      },
      "ProviderReviewServiceCreateProviderReviewReplyBody": {
        "type": "object",
        "properties": {
          "replyMessage": {
            "type": "string"
          }
        },
        "description": "Create first public provider reply to a client review."
      },
      "ProviderReviewServiceUpdateProviderReviewReplyBody": {
        "type": "object",
        "properties": {
          "replyMessage": {
            "type": "string"
          }
        },
        "description": "Update existing provider reply text."
      },
      "RoadmapServiceCreateRoadmapFeatureRequestCommentBody": {
        "type": "object",
        "properties": {
          "body": {
            "type": "string"
          }
        }
      },
      "RoadmapServiceUpdateRoadmapFeatureRequestCommentBody": {
        "type": "object",
        "properties": {
          "body": {
            "type": "string"
          }
        }
      },
      "RoadmapServiceVoteRoadmapFeatureRequestBody": {
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/v1RoadmapVoteType"
          }
        }
      },
      "RoleServiceUpdateRoleBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "permissions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "groupIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "SecretServiceUpdateSecretBody": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string"
          }
        }
      },
      "ServiceAccountServiceGenerateTokenBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "expiresInDays": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "ServiceAccountServiceUpdateServiceAccountBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "isActive": {
            "type": "boolean"
          },
          "allowedIps": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "SnapshotServiceCreateSnapshotBody": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string"
          }
        }
      },
      "SnapshotServiceRestoreSnapshotBody": {
        "type": "object",
        "properties": {
          "snapshotName": {
            "type": "string"
          },
          "stopVm": {
            "type": "boolean"
          }
        }
      },
      "TicketServiceAddInternalCommentBody": {
        "type": "object",
        "properties": {
          "comment": {
            "type": "string"
          }
        }
      },
      "TicketServiceAddReplyToTicketBody": {
        "type": "object",
        "properties": {
          "replyMessage": {
            "type": "string"
          }
        }
      },
      "TicketServiceCreateTicketAttachmentUploadBody": {
        "type": "object",
        "properties": {
          "fileName": {
            "type": "string"
          },
          "fileSize": {
            "type": "string",
            "format": "int64"
          },
          "mimeType": {
            "type": "string"
          }
        }
      },
      "TicketServiceSetTicketPriorityBody": {
        "type": "object",
        "properties": {
          "priority": {
            "$ref": "#/components/schemas/v1TicketPriority"
          }
        }
      },
      "TicketServiceSetTicketStatusBody": {
        "type": "object",
        "properties": {
          "ticketStatus": {
            "$ref": "#/components/schemas/v1TicketStatus"
          }
        }
      },
      "TicketServiceUpdateTicketTemplateBody": {
        "type": "object",
        "properties": {
          "ticketTemplate": {
            "$ref": "#/components/schemas/v1TicketTemplateInput"
          }
        }
      },
      "UserServiceUpdateUserBody": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "allowOrgInvites": {
            "type": "boolean"
          },
          "userRoles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "groupIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "VMTemplateServiceUpdateVMTemplateBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "distro": {
            "$ref": "#/components/schemas/v1Distro"
          },
          "templateId": {
            "type": "integer",
            "format": "int32"
          },
          "nodeId": {
            "type": "string"
          },
          "cloudInitTemplateId": {
            "type": "string"
          },
          "proxmoxCpuType": {
            "type": "string",
            "description": "Proxmox cpu= guest CPU model. Empty = leave unchanged on update."
          }
        }
      },
      "VirtualMachineServiceAttachVMFirewallBody": {
        "type": "object",
        "properties": {
          "rulesetId": {
            "type": "string"
          }
        }
      },
      "VirtualMachineServiceDetachVMFirewallBody": {
        "type": "object",
        "properties": {
          "rulesetId": {
            "type": "string"
          }
        }
      },
      "VirtualMachineServiceDisableAdditionalIPBody": {
        "type": "object",
        "properties": {
          "cancelImmediately": {
            "type": "boolean"
          },
          "ipAddress": {
            "type": "string",
            "description": "Specific additional IPv4 to release. When empty, the most recently added address is removed."
          }
        },
        "description": "DisableAdditionalIPRequest removes one additional IPv4 and updates billing quantity."
      },
      "VirtualMachineServiceDisableBackupBody": {
        "type": "object",
        "properties": {
          "addonId": {
            "type": "string"
          },
          "cancelImmediately": {
            "type": "boolean"
          }
        },
        "title": "DisableBackupRequest disables backup addon for a virtual machine"
      },
      "VirtualMachineServiceEnableAdditionalIPBody": {
        "type": "object",
        "description": "EnableAdditionalIPRequest adds one additional IPv4 (same prefix as VM primary) and bills via ADDITIONAL-IP addon."
      },
      "VirtualMachineServiceEnableBackupBody": {
        "type": "object",
        "properties": {
          "addonId": {
            "type": "string"
          }
        },
        "title": "EnableBackupRequest enables backup addon for a virtual machine"
      },
      "VirtualMachineServiceReinstallVirtualMachineBody": {
        "type": "object",
        "properties": {
          "distro": {
            "$ref": "#/components/schemas/v1Distro"
          },
          "userData": {
            "type": "string"
          },
          "sshKeyIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "password": {
            "type": "string"
          },
          "cloudInitUserDataId": {
            "type": "string"
          },
          "hostname": {
            "type": "string"
          },
          "instantAppId": {
            "type": "string",
            "description": "Platform Instant App. Same exclusivity rules as CreateVirtualMachineRequest."
          },
          "instantAppVariables": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Optional Instant App form overrides (same rules as CreateVirtualMachineRequest)."
          }
        }
      },
      "VirtualMachineServiceRestartVirtualMachineBody": {
        "type": "object",
        "description": "UpdateVMOperationStatusRequest is a unified request message for\nall VM operation status updates. The endpoint name (start, stop, restart) determines the operation."
      },
      "VirtualMachineServiceStartVirtualMachineBody": {
        "type": "object",
        "description": "UpdateVMOperationStatusRequest is a unified request message for\nall VM operation status updates. The endpoint name (start, stop, restart) determines the operation."
      },
      "VirtualMachineServiceStopVirtualMachineBody": {
        "type": "object",
        "description": "UpdateVMOperationStatusRequest is a unified request message for\nall VM operation status updates. The endpoint name (start, stop, restart) determines the operation."
      },
      "VirtualMachineServiceUpdateVirtualMachineBody": {
        "type": "object",
        "properties": {
          "addTags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "Tags to add to the virtual machine"
          },
          "removeTags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "Tags to remove from the virtual machine"
          }
        },
        "description": "UpdateVirtualMachineRequest is used to update virtual machine tags.\nOnly tags can be modified through this endpoint."
      },
      "WebhookServiceHandleWebhookBody": {
        "type": "object",
        "properties": {
          "payload": {
            "type": "string",
            "format": "byte",
            "title": "Raw webhook payload (will be handled as bytes in implementation)\nNote: This field is for proto definition only; actual webhook payload\nis read directly from HTTP request body in the gateway handler"
          }
        },
        "title": "Webhook messages"
      },
      "protobufNullValue": {
        "type": "string",
        "enum": [
          "NULL_VALUE"
        ],
        "default": "NULL_VALUE",
        "description": "`NullValue` is a singleton enumeration to represent the null value for the\n`Value` type union.\n\nThe JSON representation for `NullValue` is JSON `null`.\n\n - NULL_VALUE: Null value."
      },
      "protov1Status": {
        "type": "string",
        "enum": [
          "STATUS_UNSPECIFIED",
          "STATUS_ACTIVE",
          "STATUS_INACTIVE",
          "STATUS_BANNED",
          "STATUS_SOFT_DELETED"
        ],
        "default": "STATUS_UNSPECIFIED",
        "title": "Status of the object"
      },
      "v1AddAddonToSubscriptionResponse": {
        "type": "object",
        "properties": {
          "addonSubscription": {
            "$ref": "#/components/schemas/v1AddonSubscription"
          }
        }
      },
      "v1AddInternalCommentResponse": {
        "type": "object",
        "properties": {
          "comment": {
            "$ref": "#/components/schemas/v1TicketInternalComment"
          }
        }
      },
      "v1AddServiceAccountToGroupRequest": {
        "type": "object",
        "properties": {
          "groupId": {
            "type": "string"
          },
          "serviceAccountIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1AddUserToGroupRequest": {
        "type": "object",
        "properties": {
          "groupId": {
            "type": "string"
          },
          "userIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1AdditionalIPAddress": {
        "type": "object",
        "properties": {
          "ipAddress": {
            "type": "string",
            "readOnly": true
          },
          "gateway": {
            "type": "string",
            "readOnly": true
          },
          "prefixLength": {
            "type": "string",
            "readOnly": true
          }
        },
        "description": "AdditionalIPAddress is an extra IPv4 allocated from the VM's primary prefix."
      },
      "v1Addon": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "code": {
            "type": "string",
            "title": "Basic information"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "addonType": {
            "$ref": "#/components/schemas/v1AddonType"
          },
          "addonCategory": {
            "$ref": "#/components/schemas/v1AssetCategory"
          },
          "isTemplate": {
            "type": "boolean",
            "title": "Configuration"
          },
          "isPublic": {
            "type": "boolean"
          },
          "requiresApproval": {
            "type": "boolean"
          },
          "autoAttach": {
            "type": "boolean"
          },
          "compatiblePlanCodes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "Compatibility"
          },
          "compatibleAssetTypes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "tenantId": {
            "type": "string",
            "title": "Owner organization (for tenant-specific add-ons)"
          },
          "externalId": {
            "type": "string",
            "title": "External integration"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "addonPrices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1AddonPrice"
            },
            "title": "Prices for non-template addons (populated in ListAddons response)"
          }
        }
      },
      "v1AddonInput": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "usage": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "format": "double"
            },
            "title": "Usage for this addon (e.g., {\"GB\": 100}, {\"count\": 2})"
          }
        }
      },
      "v1AddonPrice": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "addonId": {
            "type": "string"
          },
          "kind": {
            "$ref": "#/components/schemas/v1AddonPriceKind"
          },
          "currency": {
            "type": "string"
          },
          "unitAmount": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "unitName": {
            "type": "string"
          },
          "billingPeriod": {
            "$ref": "#/components/schemas/v1BillingPeriod"
          },
          "billingInterval": {
            "type": "integer",
            "format": "int32"
          },
          "metricName": {
            "type": "string",
            "title": "Usage-based pricing"
          },
          "metricAggregation": {
            "$ref": "#/components/schemas/v1MetricAggregation"
          },
          "minQuantity": {
            "type": "integer",
            "format": "int32",
            "title": "Constraints"
          },
          "maxQuantity": {
            "type": "integer",
            "format": "int32"
          },
          "prorate": {
            "type": "boolean"
          },
          "minimumCharge": {
            "type": "string",
            "description": "Decimal string with 6 decimal places precision",
            "title": "Minimum and maximum charges (for usage-based pricing)"
          },
          "maximumCharge": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "pricingFormula": {
            "type": "object",
            "title": "Pricing formula for percentage-based or complex pricing\nExample: {\"type\": \"percentage\", \"value\": 30.0, \"base\":\n\"parent_plan.base_price\"}"
          },
          "pricingModel": {
            "$ref": "#/components/schemas/v1PricingModel"
          },
          "chargeTiming": {
            "$ref": "#/components/schemas/v1ChargeTiming"
          },
          "effectiveFrom": {
            "type": "string",
            "format": "date-time",
            "title": "Lifecycle"
          },
          "effectiveUntil": {
            "type": "string",
            "format": "date-time"
          },
          "externalId": {
            "type": "string",
            "title": "External integration"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        },
        "description": "DEPRECATED: AddonPrice is deprecated. Use PlanPrice with\nproduct_type=PRODUCT_TYPE_ADDON instead. This message is kept for backward\ncompatibility but should not be used for new code."
      },
      "v1AddonPriceKind": {
        "type": "string",
        "enum": [
          "ADDON_PRICE_KIND_UNSPECIFIED",
          "ADDON_PRICE_KIND_ONE_TIME",
          "ADDON_PRICE_KIND_SUBSCRIPTION",
          "ADDON_PRICE_KIND_USAGE_BASED"
        ],
        "default": "ADDON_PRICE_KIND_UNSPECIFIED"
      },
      "v1AddonPriceOverride": {
        "type": "object",
        "properties": {
          "addonCode": {
            "type": "string"
          },
          "unitAmount": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          }
        },
        "description": "AddonPriceOverride allows providers to set custom prices for addons when\ncreating plans. If an addon_code is specified here, the override price will\nbe used instead of copying from template. Only accepts unit_amount_minor\n(price). Currency comes from plan level."
      },
      "v1AddonStatus": {
        "type": "string",
        "enum": [
          "ADDON_STATUS_UNSPECIFIED",
          "ADDON_STATUS_ACTIVE",
          "ADDON_STATUS_CANCELED",
          "ADDON_STATUS_PAUSED",
          "ADDON_STATUS_PENDING_ACTIVATION"
        ],
        "default": "ADDON_STATUS_UNSPECIFIED"
      },
      "v1AddonSubscription": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "quantity": {
            "type": "integer",
            "format": "int32",
            "title": "Quantity"
          },
          "startDate": {
            "type": "string",
            "format": "date-time",
            "title": "Lifecycle dates"
          },
          "endDate": {
            "type": "string",
            "format": "date-time"
          },
          "addonStatus": {
            "$ref": "#/components/schemas/v1AddonStatus"
          },
          "cancelAtPeriodEnd": {
            "type": "boolean"
          },
          "canceledAt": {
            "type": "string",
            "format": "date-time"
          },
          "externalId": {
            "type": "string",
            "title": "External integration"
          },
          "subscriptionId": {
            "type": "string",
            "title": "Relations"
          },
          "addonId": {
            "type": "string"
          },
          "addonPriceId": {
            "type": "string"
          },
          "subscriptionName": {
            "type": "string",
            "title": "Relation details (populated in responses)"
          },
          "addonName": {
            "type": "string"
          },
          "addonCode": {
            "type": "string"
          },
          "unitAmount": {
            "type": "string",
            "description": "Catalog unit amount for the bound addon price (decimal string). Empty when unknown."
          },
          "currency": {
            "type": "string"
          },
          "pricingModel": {
            "$ref": "#/components/schemas/v1PricingModel"
          },
          "addonType": {
            "$ref": "#/components/schemas/v1AddonType"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1AddonType": {
        "type": "string",
        "enum": [
          "ADDON_TYPE_UNSPECIFIED",
          "ADDON_TYPE_BACKUP",
          "ADDON_TYPE_SNAPSHOT",
          "ADDON_TYPE_ADDITIONAL_IP"
        ],
        "default": "ADDON_TYPE_UNSPECIFIED"
      },
      "v1Agent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "gatewayRegion": {
            "$ref": "#/components/schemas/v1AgentGatewayRegion"
          },
          "agentPublicIp": {
            "type": "string"
          },
          "gwServerServicePort": {
            "type": "integer",
            "format": "int32"
          },
          "organizationId": {
            "type": "string",
            "title": "Relations"
          },
          "metadata": {
            "type": "object"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "provisioned": {
            "type": "boolean"
          },
          "inboundPeeringState": {
            "$ref": "#/components/schemas/v1InboundPeeringState"
          },
          "inboundPeeringError": {
            "type": "string"
          },
          "serviceStatus": {
            "$ref": "#/components/schemas/v1ServiceStatus"
          },
          "hypervisorDriver": {
            "$ref": "#/components/schemas/v1PlatformDriver"
          }
        }
      },
      "v1AgentGatewayRegion": {
        "type": "string",
        "enum": [
          "AGENT_GATEWAY_REGION_UNSPECIFIED",
          "AGENT_GATEWAY_REGION_AMS01"
        ],
        "default": "AGENT_GATEWAY_REGION_UNSPECIFIED"
      },
      "v1AggregationType": {
        "type": "string",
        "enum": [
          "AGGREGATION_TYPE_UNSPECIFIED",
          "AGGREGATION_TYPE_SUM",
          "AGGREGATION_TYPE_MAX",
          "AGGREGATION_TYPE_MIN",
          "AGGREGATION_TYPE_AVG",
          "AGGREGATION_TYPE_COUNT",
          "AGGREGATION_TYPE_LAST_DURING_PERIOD"
        ],
        "default": "AGGREGATION_TYPE_UNSPECIFIED"
      },
      "v1AllocationStrategy": {
        "type": "string",
        "enum": [
          "ALLOCATION_STRATEGY_UNSPECIFIED",
          "ALLOCATION_STRATEGY_SEQUENTIAL",
          "ALLOCATION_STRATEGY_RANDOM",
          "ALLOCATION_STRATEGY_FIRST_AVAILABLE",
          "ALLOCATION_STRATEGY_LAST_AVAILABLE"
        ],
        "default": "ALLOCATION_STRATEGY_UNSPECIFIED"
      },
      "v1ArchiveFilesResponse": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          }
        }
      },
      "v1AssetCategory": {
        "type": "string",
        "enum": [
          "ASSET_CATEGORY_UNSPECIFIED",
          "ASSET_CATEGORY_COMPUTE",
          "ASSET_CATEGORY_STORAGE",
          "ASSET_CATEGORY_NETWORK",
          "ASSET_CATEGORY_SECURITY",
          "ASSET_CATEGORY_MANAGEMENT",
          "ASSET_CATEGORY_MONITORING",
          "ASSET_CATEGORY_SUPPORT",
          "ASSET_CATEGORY_OTHER"
        ],
        "default": "ASSET_CATEGORY_UNSPECIFIED"
      },
      "v1AssetType": {
        "type": "string",
        "enum": [
          "ASSET_TYPE_UNSPECIFIED",
          "ASSET_TYPE_VM",
          "ASSET_TYPE_CONTAINER",
          "ASSET_TYPE_STORAGE",
          "ASSET_TYPE_GAMESERVER",
          "ASSET_TYPE_CDN",
          "ASSET_TYPE_IP_ADDRESS",
          "ASSET_TYPE_DNS",
          "ASSET_TYPE_GPU",
          "ASSET_TYPE_GENERIC"
        ],
        "default": "ASSET_TYPE_UNSPECIFIED"
      },
      "v1AssignPermissionToRoleRequest": {
        "type": "object",
        "properties": {
          "permissionIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "roleId": {
            "type": "string"
          }
        }
      },
      "v1AssignableNodeView": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "regionId": {
            "type": "string"
          },
          "computeType": {
            "$ref": "#/components/schemas/v1NodeComputeType"
          },
          "cpuModel": {
            "type": "string"
          },
          "catalogBrand": {
            "type": "string"
          },
          "catalogModel": {
            "type": "string"
          }
        }
      },
      "v1AttachPaymentMethodRequest": {
        "type": "object",
        "properties": {
          "subscriptionId": {
            "type": "string",
            "title": "Subscription reference (required for client subscriptions to provider\nplans) For provider platform subscriptions, subscription_id is required"
          },
          "paymentMethodId": {
            "type": "string",
            "description": "Optional: Payment method ID (if using existing)",
            "title": "Payment method details\nEither payment_method_id or payment_method_token must be provided"
          },
          "paymentMethodToken": {
            "type": "string",
            "title": "Optional: Payment method token from frontend (Stripe.js, PayPal SDK)"
          },
          "setAsDefault": {
            "type": "boolean",
            "description": "Whether to set as default payment method",
            "title": "Options"
          },
          "metadata": {
            "type": "object",
            "description": "Optional: custom metadata",
            "title": "Metadata"
          }
        },
        "title": "Payment method messages"
      },
      "v1AttachPaymentMethodResponse": {
        "type": "object",
        "properties": {
          "paymentMethod": {
            "$ref": "#/components/schemas/v1PaymentMethod"
          }
        }
      },
      "v1AuthorizeResponse": {
        "type": "object",
        "properties": {
          "authorizationUrl": {
            "type": "string"
          },
          "code": {
            "type": "string",
            "title": "Returned if user already authorized"
          },
          "state": {
            "type": "string"
          }
        }
      },
      "v1AvailablePlanCode": {
        "type": "object",
        "properties": {
          "planCode": {
            "type": "string",
            "title": "Plan code (e.g., \"SC-GC-1C-1G-20\")"
          },
          "billingType": {
            "$ref": "#/components/schemas/v1BillingType"
          },
          "computeType": {
            "$ref": "#/components/schemas/v1ComputeType"
          },
          "computeCategory": {
            "$ref": "#/components/schemas/v1ComputeCategory"
          }
        },
        "title": "Available plan code information (deduplicated)"
      },
      "v1Backup": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true
          },
          "name": {
            "type": "string",
            "readOnly": true
          },
          "backupId": {
            "type": "string",
            "readOnly": true
          },
          "virtualMachineId": {
            "type": "string",
            "readOnly": true
          },
          "addonId": {
            "type": "string",
            "readOnly": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "sizeBytes": {
            "type": "string",
            "format": "int64",
            "readOnly": true
          },
          "backupStatus": {
            "$ref": "#/components/schemas/v1BackupStatus"
          },
          "restoreStatus": {
            "$ref": "#/components/schemas/v1RestoreStatus"
          },
          "restoredAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "operationStatus": {
            "$ref": "#/components/schemas/v1BackupOperationStatus"
          },
          "metadata": {
            "type": "object"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        },
        "title": "Backup represents a backup of a virtual machine"
      },
      "v1BackupOperationStatus": {
        "type": "string",
        "enum": [
          "BACKUP_OPERATION_STATUS_UNSPECIFIED",
          "BACKUP_OPERATION_STATUS_PENDING",
          "BACKUP_OPERATION_STATUS_PROCESSING",
          "BACKUP_OPERATION_STATUS_COMPLETED",
          "BACKUP_OPERATION_STATUS_FAILED"
        ],
        "default": "BACKUP_OPERATION_STATUS_UNSPECIFIED",
        "title": "BackupOperationStatus represents the status of backup run (same structure as SnapshotOperationStatus)"
      },
      "v1BackupServiceRestoreBackupBody": {
        "type": "object",
        "properties": {
          "startAfterRestore": {
            "type": "boolean"
          }
        }
      },
      "v1BackupStatus": {
        "type": "string",
        "enum": [
          "BACKUP_STATUS_UNSPECIFIED",
          "BACKUP_STATUS_ACTIVE",
          "BACKUP_STATUS_DELETED",
          "BACKUP_STATUS_EXPIRED",
          "BACKUP_STATUS_UNKNOWN"
        ],
        "default": "BACKUP_STATUS_UNSPECIFIED",
        "title": "BackupStatus represents the status of a backup"
      },
      "v1BackupStorageCompression": {
        "type": "string",
        "enum": [
          "BACKUP_STORAGE_COMPRESSION_UNSPECIFIED",
          "BACKUP_STORAGE_COMPRESSION_NONE",
          "BACKUP_STORAGE_COMPRESSION_LZO",
          "BACKUP_STORAGE_COMPRESSION_GZIP",
          "BACKUP_STORAGE_COMPRESSION_ZSTD"
        ],
        "default": "BACKUP_STORAGE_COMPRESSION_UNSPECIFIED",
        "description": "Proxmox vzdump --compress (must not be UNSPECIFIED on create/update node)."
      },
      "v1BatchRecordUsageRequest": {
        "type": "object",
        "properties": {
          "records": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1RecordUsageRequest"
            }
          }
        }
      },
      "v1BatchRecordUsageResponse": {
        "type": "object",
        "properties": {
          "usageRecords": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1UsageRecord"
            }
          },
          "createdCount": {
            "type": "integer",
            "format": "int32"
          },
          "duplicateCount": {
            "type": "integer",
            "format": "int32"
          },
          "failedCount": {
            "type": "integer",
            "format": "int32"
          },
          "errorMessages": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1BillingPeriod": {
        "type": "string",
        "enum": [
          "BILLING_PERIOD_UNSPECIFIED",
          "BILLING_PERIOD_HOUR",
          "BILLING_PERIOD_DAY",
          "BILLING_PERIOD_WEEK",
          "BILLING_PERIOD_MONTH",
          "BILLING_PERIOD_QUARTER",
          "BILLING_PERIOD_YEAR"
        ],
        "default": "BILLING_PERIOD_UNSPECIFIED"
      },
      "v1BillingType": {
        "type": "string",
        "enum": [
          "BILLING_TYPE_UNSPECIFIED",
          "BILLING_TYPE_SUBSCRIPTION",
          "BILLING_TYPE_USAGE",
          "BILLING_TYPE_FREE",
          "BILLING_TYPE_PERCENTAGE"
        ],
        "default": "BILLING_TYPE_UNSPECIFIED",
        "title": "- BILLING_TYPE_PERCENTAGE: Percentage-based pricing (e.g., 30% of parent plan)"
      },
      "v1CPUType": {
        "type": "string",
        "enum": [
          "CPU_TYPE_UNSPECIFIED",
          "CPU_TYPE_INTEL",
          "CPU_TYPE_AMD",
          "CPU_TYPE_ARM"
        ],
        "default": "CPU_TYPE_UNSPECIFIED"
      },
      "v1CalculatePlanPricingRequest": {
        "type": "object",
        "properties": {
          "planConfig": {
            "$ref": "#/components/schemas/v1PlanPricingConfig"
          },
          "instances": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ResourceInstanceInput"
            },
            "title": "Resource instances to calculate pricing for"
          },
          "calcConfig": {
            "$ref": "#/components/schemas/v1PricingCalculationConfig"
          }
        }
      },
      "v1CalculatePlanPricingResponse": {
        "type": "object",
        "properties": {
          "lineItems": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PricingLineItem"
            },
            "title": "Line items per instance"
          },
          "pooledAllowances": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "format": "double"
            },
            "title": "Pooled allowances & usage"
          },
          "pooledUsage": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "format": "double"
            }
          },
          "subtotal": {
            "type": "string",
            "description": "Decimal string with 6 decimal places precision",
            "title": "Costs breakdown"
          },
          "overageCost": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "discounted": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "tax": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "total": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "currency": {
            "type": "string"
          },
          "discountPercent": {
            "type": "number",
            "format": "double",
            "title": "Applied discounts"
          },
          "couponValue": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "debug": {
            "type": "object",
            "title": "Debug information showing all inputs received by the price calculator\nThis is useful for troubleshooting pricing calculations"
          }
        }
      },
      "v1CancelRenewalRequest": {
        "type": "object",
        "properties": {
          "subscriptionId": {
            "type": "string"
          }
        }
      },
      "v1CancelResponse": {
        "type": "object",
        "properties": {
          "subscription": {
            "$ref": "#/components/schemas/v1Subscription"
          }
        }
      },
      "v1CaseType": {
        "type": "string",
        "enum": [
          "CASE_TYPE_UNSPECIFIED",
          "CASE_TYPE_BILLING",
          "CASE_TYPE_GENERAL",
          "CASE_TYPE_TROUBLESHOOTING",
          "CASE_TYPE_OUTAGE",
          "CASE_TYPE_ABUSE",
          "CASE_TYPE_CONFIGURATION_CHANGE"
        ],
        "default": "CASE_TYPE_UNSPECIFIED"
      },
      "v1ChangePasswordRequest": {
        "type": "object",
        "properties": {
          "oldPassword": {
            "type": "string"
          },
          "newPassword": {
            "type": "string"
          }
        }
      },
      "v1ChargeTiming": {
        "type": "string",
        "enum": [
          "CHARGE_TIMING_UNSPECIFIED",
          "CHARGE_TIMING_IN_ADVANCE",
          "CHARGE_TIMING_IN_ARREARS"
        ],
        "default": "CHARGE_TIMING_UNSPECIFIED"
      },
      "v1ChatMessage": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string",
            "title": "Role: \"user\", \"assistant\", \"system\", \"function\""
          },
          "content": {
            "type": "string",
            "title": "Message content"
          },
          "functionCalls": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1FunctionCall"
            },
            "title": "Function calls made in this message (for assistant messages)"
          },
          "functionCallId": {
            "type": "string",
            "title": "Function call ID (for function messages)"
          }
        }
      },
      "v1ChatRequest": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "title": "User's message"
          },
          "conversationId": {
            "type": "string",
            "title": "Conversation ID for maintaining context (optional, generated if not provided)"
          }
        },
        "title": "Firewall rule definitions (address-book only)\nChatService messages"
      },
      "v1ChatResponse": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "title": "Complete response message"
          },
          "conversationId": {
            "type": "string",
            "title": "Conversation ID"
          },
          "title": {
            "type": "string",
            "title": "Conversation title (returns \"Untitled\" if not set)"
          },
          "functionCalls": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1FunctionCall"
            },
            "title": "Function calls executed during the conversation"
          },
          "functionResults": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1FunctionResult"
            },
            "title": "Function results from executed calls"
          },
          "sessionToken": {
            "type": "string",
            "title": "Signed session token for anonymous chat (returned on every anonymous response for cookie refresh)"
          }
        }
      },
      "v1CheckDnsGeoRecordResponse": {
        "type": "object",
        "properties": {
          "rdata": {
            "type": "string"
          },
          "matchedBy": {
            "type": "string"
          },
          "matchedCode": {
            "type": "string"
          }
        }
      },
      "v1City": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "v1CityCountry": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "cityName": {
            "type": "string"
          },
          "countryName": {
            "type": "string"
          }
        }
      },
      "v1ClientDashboardSpendBucket": {
        "type": "object",
        "properties": {
          "bucketStart": {
            "type": "string",
            "description": "\"YYYY-MM-DD\" for daily buckets; RFC3339 hour start (UTC) for hourly buckets."
          },
          "fixedAmount": {
            "type": "string",
            "description": "Fixed-price plan charges (billed in advance)."
          },
          "usageAmount": {
            "type": "string",
            "description": "Metered plan usage (compute hours etc.), paid or estimated."
          },
          "bandwidthAmount": {
            "type": "string",
            "description": "Bandwidth overage beyond the plan's included allowance (egress/ingress)."
          },
          "addonAmount": {
            "type": "string",
            "description": "Add-on charges (additional IP, backups, snapshots, ...), fixed or metered."
          },
          "hasEstimated": {
            "type": "boolean",
            "description": "True when any amount in this bucket is an accrual estimate (not yet invoiced)."
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ClientDashboardSpendItem"
            }
          }
        },
        "description": "Categorized spend for one UTC calendar day or one UTC hour.\nPaid invoice lines land in the bucket of their paid_at time; un-invoiced metered\nusage lands in the bucket of its usage timestamp as an estimate."
      },
      "v1ClientDashboardSpendItem": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "description": "Display label: plan code, add-on name, or bandwidth metric label."
          },
          "detail": {
            "type": "string",
            "description": "Secondary detail: \"hostname · provider\", metered quantity (\"12.50 GB\"), etc."
          },
          "amount": {
            "type": "string"
          },
          "billingType": {
            "type": "string",
            "description": "\"fixed\" | \"usage\": how this product is billed."
          },
          "category": {
            "type": "string",
            "description": "\"fixed\" | \"usage\" | \"bandwidth\" | \"addon\": chart stacking category."
          },
          "estimated": {
            "type": "boolean",
            "description": "True for accrued metered usage priced from plan/addon prices but not yet invoiced."
          }
        },
        "description": "One product-level line inside a spend bucket (used for chart tooltips / detail)."
      },
      "v1ClientDashboardSpendingWindow": {
        "type": "object",
        "properties": {
          "windowDays": {
            "type": "integer",
            "format": "int32"
          },
          "currency": {
            "type": "string"
          },
          "totalPlanSpend": {
            "type": "string"
          },
          "totalAddonSpend": {
            "type": "string"
          },
          "totalSpend": {
            "type": "string"
          }
        },
        "description": "Rolling spend for the authenticated client org (paid invoices where this org is tenant). UTC calendar windows."
      },
      "v1ClientDashboardUsageRollup": {
        "type": "object",
        "properties": {
          "subscriptionId": {
            "type": "string"
          },
          "planName": {
            "type": "string"
          },
          "metricName": {
            "type": "string"
          },
          "metricUnit": {
            "type": "string"
          },
          "quantityTotal": {
            "type": "string"
          },
          "periodEnd": {
            "type": "string"
          },
          "estimatedAmount": {
            "type": "string",
            "description": "Estimated charge for quantity_total priced with the subscription's plan/addon price\n(free units and block overage applied). Empty when no price could be resolved."
          }
        },
        "description": "Aggregated metered usage for the billing period overlapping \"now\" (compute, bandwidth overage, add-ons)."
      },
      "v1ClientDashboardVirtualMachinesSummary": {
        "type": "object",
        "properties": {
          "totalCount": {
            "type": "integer",
            "format": "int32",
            "description": "Active + inactive VMs for this client org (not soft-deleted / not expired)."
          }
        }
      },
      "v1ClientProviderReview": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "virtualMachineId": {
            "type": "string"
          },
          "starRating": {
            "type": "integer",
            "format": "int32"
          },
          "comment": {
            "type": "string"
          },
          "providerReply": {
            "type": "string"
          },
          "createTime": {
            "type": "string",
            "format": "date-time"
          },
          "updateTime": {
            "type": "string",
            "format": "date-time"
          },
          "providerRepliedAt": {
            "type": "string",
            "format": "date-time"
          },
          "providerOrganizationId": {
            "type": "string"
          }
        },
        "title": "Client-side provider reviews (client org rates provider after a VM purchase; one per VM)"
      },
      "v1ClientProviderReviewAssetItem": {
        "type": "object",
        "properties": {
          "virtualMachineId": {
            "type": "string"
          },
          "hostname": {
            "type": "string"
          },
          "virtualMachineDeleted": {
            "type": "boolean"
          },
          "providerOrganizationId": {
            "type": "string"
          },
          "providerOrganizationName": {
            "type": "string"
          },
          "hasSubmitted": {
            "type": "boolean"
          },
          "review": {
            "$ref": "#/components/schemas/v1ClientProviderReview"
          },
          "canSubmitReview": {
            "type": "boolean"
          },
          "reviewBlockedReason": {
            "type": "string",
            "description": "Set when can_submit_review is false and has_submitted is false (e.g. usage-based 24h window)."
          },
          "reviewAvailableAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "v1CloudInitTemplate": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "name": {
            "type": "string"
          },
          "userData": {
            "type": "string"
          },
          "vendorData": {
            "type": "string"
          },
          "networkData": {
            "type": "string"
          },
          "storage": {
            "type": "string",
            "title": "Default: \"local\""
          },
          "organizationId": {
            "type": "string",
            "title": "Relations"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "isTemplate": {
            "type": "boolean",
            "title": "If true, this is a template cloudinit that users can copy from but cannot use directly"
          }
        }
      },
      "v1CloudInitUserData": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true
          },
          "name": {
            "type": "string"
          },
          "userData": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "validationWarnings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1CloudInitValidationWarning"
            },
            "readOnly": true
          },
          "organizationId": {
            "type": "string",
            "readOnly": true
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        },
        "description": "CloudInitUserData is a client-scoped saved cloud-init user_data Jinja profile."
      },
      "v1CloudInitValidationWarning": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "line": {
            "type": "integer",
            "format": "int32"
          },
          "key": {
            "type": "string"
          }
        },
        "description": "CloudInitValidationWarning is a non-blocking issue found when saving a user_data profile."
      },
      "v1CompleteConnectOAuthRequest": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "state": {
            "type": "string"
          }
        }
      },
      "v1CompleteConnectOAuthResponse": {
        "type": "object",
        "properties": {
          "account": {
            "$ref": "#/components/schemas/v1ConnectAccount"
          },
          "onboardingUrl": {
            "type": "string"
          },
          "requiresOnboarding": {
            "type": "boolean"
          }
        }
      },
      "v1CompleteSSOLinkRequest": {
        "type": "object",
        "properties": {
          "ticket": {
            "type": "string"
          },
          "password": {
            "type": "string"
          }
        }
      },
      "v1ComplianceActor": {
        "type": "string",
        "enum": [
          "COMPLIANCE_ACTOR_UNSPECIFIED",
          "COMPLIANCE_ACTOR_PROVIDER",
          "COMPLIANCE_ACTOR_PLATFORM"
        ],
        "default": "COMPLIANCE_ACTOR_UNSPECIFIED",
        "description": "Who placed a compliance hold or purchase block."
      },
      "v1ComplianceReason": {
        "type": "string",
        "enum": [
          "COMPLIANCE_REASON_UNSPECIFIED",
          "COMPLIANCE_REASON_FRAUD",
          "COMPLIANCE_REASON_ABUSE",
          "COMPLIANCE_REASON_COPYRIGHT",
          "COMPLIANCE_REASON_OTHER"
        ],
        "default": "COMPLIANCE_REASON_UNSPECIFIED",
        "description": "Why a VM or purchase was seized/blocked."
      },
      "v1ComponentVersion": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "Component name: k3s | k3d | calico | liqo | liqoctl | helm"
          },
          "version": {
            "type": "string",
            "description": "Exact version / tag to install (e.g. \"v1.31.5+k3s1\", \"v3.30.2\")."
          },
          "minVersion": {
            "type": "string",
            "description": "Optional minimum acceptable local version for skip-install checks."
          },
          "downloadUrl": {
            "type": "string",
            "description": "Optional download URL override; CLI derives GitHub URLs when empty."
          },
          "checksumSha256": {
            "type": "string",
            "description": "Optional SHA-256 hex digest of the download artifact."
          }
        },
        "description": "ComponentVersion describes a pinned installable platform component."
      },
      "v1ComputeCategory": {
        "type": "string",
        "enum": [
          "COMPUTE_CATEGORY_UNSPECIFIED",
          "COMPUTE_CATEGORY_SHARED_COMPUTE",
          "COMPUTE_CATEGORY_DEDICATED_COMPUTE"
        ],
        "default": "COMPUTE_CATEGORY_UNSPECIFIED",
        "description": "- COMPUTE_CATEGORY_SHARED_COMPUTE: Shared compute (shared resources, cost-effective)\n - COMPUTE_CATEGORY_DEDICATED_COMPUTE: Dedicated compute (dedicated resources, higher performance)",
        "title": "Compute category enum for plan classification"
      },
      "v1ComputeType": {
        "type": "string",
        "enum": [
          "COMPUTE_TYPE_UNSPECIFIED",
          "COMPUTE_TYPE_GENERAL_COMPUTE",
          "COMPUTE_TYPE_HIGH_FREQUENCY",
          "COMPUTE_TYPE_HIGH_PERFORMANCE",
          "COMPUTE_TYPE_GENERAL_PURPOSE",
          "COMPUTE_TYPE_CPU_OPTIMIZED",
          "COMPUTE_TYPE_MEMORY_OPTIMIZED",
          "COMPUTE_TYPE_STORAGE_OPTIMIZED",
          "COMPUTE_TYPE_VERY_HIGH_FREQUENCY",
          "COMPUTE_TYPE_GAME_SERVER"
        ],
        "default": "COMPUTE_TYPE_UNSPECIFIED",
        "description": "- COMPUTE_TYPE_GENERAL_COMPUTE: GC - General Compute (balanced performance)\n - COMPUTE_TYPE_HIGH_FREQUENCY: HF - High Frequency (CPU-optimized, high clock speeds)\n - COMPUTE_TYPE_HIGH_PERFORMANCE: HP - High Performance (next-gen CPUs, NVMe storage)\n - COMPUTE_TYPE_GENERAL_PURPOSE: GP - General Purpose (balanced dedicated resources)\n - COMPUTE_TYPE_CPU_OPTIMIZED: CPU - CPU Optimized (high CPU-to-memory ratio)\n - COMPUTE_TYPE_MEMORY_OPTIMIZED: MEM - Memory Optimized (high memory-to-CPU ratio)\n - COMPUTE_TYPE_STORAGE_OPTIMIZED: STO - Storage Optimized (high storage capacity)\n - COMPUTE_TYPE_VERY_HIGH_FREQUENCY: VHF - Very High Frequency (highest clock dedicated CPUs)\n - COMPUTE_TYPE_GAME_SERVER: GS - Game Server (per-CPU SKU dedicated plans, e.g. DC-GS-9950X-*)",
        "title": "Compute type enum for plan classification\nBased on plan code category values: GC, HF, VHF, HP, GP, CPU, MEM, STO, GS"
      },
      "v1ConfirmTicketAttachmentUploadRequest": {
        "type": "object",
        "properties": {
          "uploadToken": {
            "type": "string"
          }
        }
      },
      "v1ConnectAccount": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Connected account ID"
          },
          "email": {
            "type": "string",
            "title": "Provider email"
          },
          "country": {
            "type": "string",
            "title": "ISO country code"
          },
          "type": {
            "type": "string",
            "title": "Account type"
          },
          "status": {
            "type": "string",
            "description": "Account status: \"active\", \"pending\", \"restricted\", etc."
          },
          "onboardingUrl": {
            "type": "string",
            "title": "URL for provider to complete onboarding (if pending)"
          },
          "chargesEnabled": {
            "type": "boolean",
            "title": "Whether account can receive charges"
          },
          "payoutsEnabled": {
            "type": "boolean",
            "title": "Whether account can receive payouts"
          },
          "metadata": {
            "type": "object",
            "title": "Account metadata"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Account creation timestamp"
          },
          "taxSettingsStatus": {
            "type": "string",
            "description": "Stripe Tax Settings status for the connected account (active|pending|unknown)."
          },
          "taxSettingsMissingFields": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Missing fields when tax settings are pending (e.g. head_office)."
          }
        }
      },
      "v1ConnectTaxAddress": {
        "type": "object",
        "properties": {
          "line1": {
            "type": "string"
          },
          "line2": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "postalCode": {
            "type": "string"
          },
          "country": {
            "type": "string",
            "title": "ISO-3166-1 alpha-2"
          }
        },
        "description": "Structured address for Connect tax head office."
      },
      "v1ConnectTaxRegistration": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "title": "active | expired | scheduled"
          },
          "registrationType": {
            "type": "string"
          },
          "activeFrom": {
            "type": "string",
            "format": "int64",
            "title": "unix seconds"
          },
          "expiresAt": {
            "type": "string",
            "format": "int64",
            "title": "unix seconds, 0 if none"
          }
        }
      },
      "v1ConnectTaxSettingsDetails": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "title": "active | pending | unknown"
          },
          "missingFields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "headOffice": {
            "$ref": "#/components/schemas/v1ConnectTaxAddress"
          },
          "defaultTaxCode": {
            "type": "string"
          },
          "defaultTaxBehavior": {
            "type": "string",
            "title": "exclusive | inclusive | inferred_by_currency"
          }
        }
      },
      "v1ConversationInfo": {
        "type": "object",
        "properties": {
          "conversationId": {
            "type": "string",
            "title": "Conversation ID"
          },
          "title": {
            "type": "string",
            "title": "Conversation title"
          }
        }
      },
      "v1ConvertCurrencyRequest": {
        "type": "object",
        "properties": {
          "usdAmount": {
            "type": "string",
            "title": "Amount in USD to convert"
          },
          "targetCurrency": {
            "type": "string",
            "title": "Target currency code (e.g., \"EUR\", \"GBP\", \"JPY\")"
          }
        }
      },
      "v1ConvertCurrencyResponse": {
        "type": "object",
        "properties": {
          "convertedAmount": {
            "type": "string",
            "title": "Converted amount in target currency"
          },
          "exchangeRate": {
            "type": "string",
            "title": "Exchange rate used for conversion (from USD to target currency)"
          },
          "sourceCurrency": {
            "type": "string",
            "title": "Source currency (always USD)"
          },
          "targetCurrency": {
            "type": "string",
            "title": "Target currency"
          }
        }
      },
      "v1Country": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "cities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1City"
            }
          }
        },
        "title": "Country, City, Datacenter hierarchy messages"
      },
      "v1Coupon": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "discountType": {
            "$ref": "#/components/schemas/v1CouponDiscountType"
          },
          "percentOff": {
            "type": "string",
            "description": "Decimal string in (0, 100] for percentage coupons."
          },
          "amountsOff": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "ISO currency to decimal amount for fixed coupons. Never converted."
          },
          "maxDiscountAmounts": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "ISO currency to per-invoice cap for percentage coupons."
          },
          "appliesTo": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Invoice line kinds: base, addon, usage."
          },
          "usageMetricCodes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "assetCategories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Plan asset_category values that qualify, such as compute. Empty means any."
          },
          "assetTypes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Plan asset_type values that qualify, such as vm or gameserver. Empty means any."
          },
          "planIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "duration": {
            "$ref": "#/components/schemas/v1CouponDuration"
          },
          "durationInPeriods": {
            "type": "integer",
            "format": "int32"
          },
          "durationDays": {
            "type": "integer",
            "format": "int32"
          },
          "validFrom": {
            "type": "string",
            "format": "date-time"
          },
          "validUntil": {
            "type": "string",
            "format": "date-time"
          },
          "maxRedemptions": {
            "type": "integer",
            "format": "int32",
            "description": "0 means unlimited."
          },
          "timesRedeemed": {
            "type": "integer",
            "format": "int32"
          },
          "oncePerCustomer": {
            "type": "boolean"
          },
          "firstTimeCustomerOnly": {
            "type": "boolean"
          },
          "highRisk": {
            "type": "boolean"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "fundedBy": {
            "$ref": "#/components/schemas/v1CouponFunding"
          },
          "creditValidDays": {
            "type": "integer",
            "format": "int32",
            "description": "Days a redeemed credit lot stays valid. Only set for credit coupons."
          }
        },
        "description": "A discount. Codes customers type live in CouponCode. Provider coupons apply\nto that provider's plans. Platform coupons apply across providers."
      },
      "v1CouponApplicationStatus": {
        "type": "string",
        "enum": [
          "COUPON_APPLICATION_STATUS_UNSPECIFIED",
          "COUPON_APPLICATION_STATUS_ACTIVE",
          "COUPON_APPLICATION_STATUS_EXHAUSTED",
          "COUPON_APPLICATION_STATUS_REMOVED",
          "COUPON_APPLICATION_STATUS_REVOKED",
          "COUPON_APPLICATION_STATUS_REVERSED"
        ],
        "default": "COUPON_APPLICATION_STATUS_UNSPECIFIED"
      },
      "v1CouponCode": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "couponId": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "maxRedemptions": {
            "type": "integer",
            "format": "int32",
            "description": "0 means unlimited."
          },
          "timesRedeemed": {
            "type": "integer",
            "format": "int32"
          },
          "validFrom": {
            "type": "string",
            "format": "date-time"
          },
          "validUntil": {
            "type": "string",
            "format": "date-time"
          },
          "customerOrgIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "campaign": {
            "type": "string"
          },
          "channel": {
            "type": "string"
          },
          "batchId": {
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1CouponCodeBatch": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "couponId": {
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/v1CouponCodeBatchStatus"
          },
          "requestedCount": {
            "type": "integer",
            "format": "int32"
          },
          "generatedCount": {
            "type": "integer",
            "format": "int32"
          },
          "prefix": {
            "type": "string"
          },
          "maxRedemptions": {
            "type": "integer",
            "format": "int32"
          },
          "validUntil": {
            "type": "string",
            "format": "date-time"
          },
          "campaign": {
            "type": "string"
          },
          "channel": {
            "type": "string"
          },
          "failureReason": {
            "type": "string"
          },
          "completedAt": {
            "type": "string",
            "format": "date-time"
          },
          "exportCount": {
            "type": "integer",
            "format": "int32"
          },
          "lastExportedAt": {
            "type": "string",
            "format": "date-time"
          },
          "lastExportedByUserId": {
            "type": "string"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1CouponCodeBatchStatus": {
        "type": "string",
        "enum": [
          "COUPON_CODE_BATCH_STATUS_UNSPECIFIED",
          "COUPON_CODE_BATCH_STATUS_QUEUED",
          "COUPON_CODE_BATCH_STATUS_RUNNING",
          "COUPON_CODE_BATCH_STATUS_COMPLETED",
          "COUPON_CODE_BATCH_STATUS_FAILED"
        ],
        "default": "COUPON_CODE_BATCH_STATUS_UNSPECIFIED"
      },
      "v1CouponDiscountType": {
        "type": "string",
        "enum": [
          "COUPON_DISCOUNT_TYPE_UNSPECIFIED",
          "COUPON_DISCOUNT_TYPE_PERCENTAGE",
          "COUPON_DISCOUNT_TYPE_FIXED",
          "COUPON_DISCOUNT_TYPE_CREDIT"
        ],
        "default": "COUPON_DISCOUNT_TYPE_UNSPECIFIED",
        "description": " - COUPON_DISCOUNT_TYPE_CREDIT: A code that grants promotional credit instead of discounting a subscription."
      },
      "v1CouponDuration": {
        "type": "string",
        "enum": [
          "COUPON_DURATION_UNSPECIFIED",
          "COUPON_DURATION_ONCE",
          "COUPON_DURATION_REPEATING",
          "COUPON_DURATION_FOREVER"
        ],
        "default": "COUPON_DURATION_UNSPECIFIED",
        "description": " - COUPON_DURATION_ONCE: Discounts the next invoice only.\n - COUPON_DURATION_REPEATING: Discounts duration_in_periods invoices, or every invoice for duration_days."
      },
      "v1CouponFunding": {
        "type": "string",
        "enum": [
          "COUPON_FUNDING_UNSPECIFIED",
          "COUPON_FUNDING_PROVIDER",
          "COUPON_FUNDING_PLATFORM"
        ],
        "default": "COUPON_FUNDING_UNSPECIFIED",
        "description": " - COUPON_FUNDING_PLATFORM: The platform funds the discount. The code applies across providers, and\neach provider still receives the amount they were owed."
      },
      "v1CouponInput": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          }
        },
        "description": "Optional code on a resource create request."
      },
      "v1CouponRedemption": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "applicationId": {
            "type": "string"
          },
          "couponId": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "clientOrganizationId": {
            "type": "string"
          },
          "clientOrganizationName": {
            "type": "string"
          },
          "subscriptionId": {
            "type": "string"
          },
          "invoiceId": {
            "type": "string"
          },
          "discountAmount": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "appliedAt": {
            "type": "string",
            "format": "date-time"
          },
          "assetType": {
            "type": "string"
          }
        }
      },
      "v1CouponReportGroupBy": {
        "type": "string",
        "enum": [
          "COUPON_REPORT_GROUP_BY_UNSPECIFIED",
          "COUPON_REPORT_GROUP_BY_CODE",
          "COUPON_REPORT_GROUP_BY_CAMPAIGN",
          "COUPON_REPORT_GROUP_BY_CHANNEL",
          "COUPON_REPORT_GROUP_BY_ASSET_TYPE"
        ],
        "default": "COUPON_REPORT_GROUP_BY_UNSPECIFIED"
      },
      "v1CouponReportRow": {
        "type": "object",
        "properties": {
          "groupKey": {
            "type": "string",
            "description": "Code, campaign, channel, or asset type; empty when not grouped."
          },
          "currency": {
            "type": "string"
          },
          "redemptions": {
            "type": "integer",
            "format": "int32"
          },
          "uniqueCustomers": {
            "type": "integer",
            "format": "int32"
          },
          "discountTotal": {
            "type": "string"
          },
          "revenueDuringDiscount": {
            "type": "string"
          },
          "revenueAfterDiscount": {
            "type": "string"
          },
          "discountsEnded": {
            "type": "integer",
            "format": "int32",
            "description": "Applications whose discount has ended (exhausted, removed, or revoked)."
          },
          "converted": {
            "type": "integer",
            "format": "int32",
            "description": "Ended applications whose subscription then paid a full-price invoice."
          },
          "conversionRate": {
            "type": "number",
            "format": "double"
          },
          "retention30dEligible": {
            "type": "integer",
            "format": "int32",
            "description": "Ended at least 30 days ago, and of those still subscribed 30 days later."
          },
          "retained30d": {
            "type": "integer",
            "format": "int32"
          },
          "retention30dRate": {
            "type": "number",
            "format": "double"
          },
          "retention90dEligible": {
            "type": "integer",
            "format": "int32"
          },
          "retained90d": {
            "type": "integer",
            "format": "int32"
          },
          "retention90dRate": {
            "type": "number",
            "format": "double"
          },
          "churned": {
            "type": "integer",
            "format": "int32",
            "description": "Redeemed subscriptions that canceled, and the average days from\nredemption to cancellation."
          },
          "avgDaysToChurn": {
            "type": "number",
            "format": "double"
          }
        },
        "description": "Attribution and ROI figures for one group of coupon applications in one\ncurrency. Amounts are decimal strings; revenue is net of the discount and\ncounts paid invoices only."
      },
      "v1CreateAddonRequest": {
        "type": "object",
        "properties": {
          "addonId": {
            "type": "string",
            "title": "Template addon ID to clone from (required)"
          },
          "currency": {
            "type": "string",
            "title": "Currency for the addon price (required)"
          },
          "unitAmount": {
            "type": "string",
            "description": "Decimal string with 6 decimal places precision",
            "title": "Override unit_amount_minor for all addon prices\nRequired for non-percentage-based addons, optional (can be \"0\" or omitted)\nfor percentage-based addons For percentage-based addons, this field is\nignored and should be \"0\""
          },
          "minimumCharge": {
            "type": "string",
            "description": "Decimal string with 6 decimal places precision",
            "title": "Optional: Override minimum_charge_minor for usage-based pricing"
          },
          "maximumCharge": {
            "type": "string",
            "description": "Decimal string with 6 decimal places precision",
            "title": "Optional: Override maximum_charge_minor for usage-based pricing"
          },
          "percentageValue": {
            "type": "number",
            "format": "double",
            "title": "Optional: Override percentage value for percentage-based pricing formulas\nOnly used when template addon has pricing_formula with type \"percentage\"\nExample: If template has 30% and you provide 25.0, the new addon will use\n25%"
          },
          "zeroBaseFallbackAmount": {
            "type": "string",
            "description": "Decimal string with 6 decimal places precision",
            "title": "Optional: Fixed amount to use when base plan price is zero (for free plans)\nOnly used for percentage-based pricing formulas when parent_plan.base_price\nis 0 Example: If base plan is free ($0), use this fixed amount instead of\npercentage calculation"
          }
        }
      },
      "v1CreateAgentRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "agentPublicIp": {
            "type": "string"
          },
          "gatewayRegion": {
            "$ref": "#/components/schemas/v1AgentGatewayRegion"
          },
          "hypervisorDriver": {
            "$ref": "#/components/schemas/v1PlatformDriver"
          }
        }
      },
      "v1CreateClientReviewRequest": {
        "type": "object",
        "properties": {
          "virtualMachineId": {
            "type": "string"
          },
          "starRating": {
            "type": "integer",
            "format": "int32"
          },
          "comment": {
            "type": "string"
          }
        }
      },
      "v1CreateClientReviewResponse": {
        "type": "object",
        "properties": {
          "review": {
            "$ref": "#/components/schemas/v1ClientProviderReview"
          }
        }
      },
      "v1CreateCloudInitTemplateRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "userData": {
            "type": "string"
          },
          "vendorData": {
            "type": "string"
          },
          "networkData": {
            "type": "string"
          },
          "storage": {
            "type": "string"
          }
        }
      },
      "v1CreateCloudInitUserDataRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "userData": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        }
      },
      "v1CreateConnectAccountRequest": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string"
          },
          "country": {
            "type": "string",
            "title": "ISO country code (e.g., \"US\")"
          },
          "type": {
            "type": "string",
            "title": "Account type: \"standard\", \"express\", \"custom\" (Stripe) or \"merchant\" (PayPal). Always \"standard\" for dispute resolution"
          },
          "metadata": {
            "type": "object",
            "title": "Optional: custom metadata"
          }
        },
        "title": "Connect Account messages"
      },
      "v1CreateConnectAccountResponse": {
        "type": "object",
        "properties": {
          "account": {
            "$ref": "#/components/schemas/v1ConnectAccount"
          },
          "onboardingUrl": {
            "type": "string",
            "title": "URL for provider to complete setup (if required)"
          },
          "requiresOnboarding": {
            "type": "boolean",
            "title": "Whether provider needs to complete onboarding"
          }
        }
      },
      "v1CreateConnectTaxRegistrationRequest": {
        "type": "object",
        "properties": {
          "country": {
            "type": "string"
          },
          "state": {
            "type": "string",
            "title": "required for US"
          },
          "registrationType": {
            "type": "string",
            "title": "optional; defaults per country"
          }
        }
      },
      "v1CreateConnectTaxRegistrationResponse": {
        "type": "object",
        "properties": {
          "registration": {
            "$ref": "#/components/schemas/v1ConnectTaxRegistration"
          }
        }
      },
      "v1CreateConnectTaxSessionResponse": {
        "type": "object",
        "properties": {
          "clientSecret": {
            "type": "string",
            "description": "Stripe AccountSession client_secret for Connect.js embedded tax components.\nDeprecated: prefer Get/UpdateConnectTaxSettings and tax registration RPCs."
          },
          "taxSettingsStatus": {
            "type": "string",
            "title": "Snapshot of tax/settings status: active | pending | unknown"
          },
          "taxSettingsMissingFields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1CreateCouponRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "discountType": {
            "$ref": "#/components/schemas/v1CouponDiscountType"
          },
          "percentOff": {
            "type": "string"
          },
          "amountsOff": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "maxDiscountAmounts": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "appliesTo": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "usageMetricCodes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "assetCategories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "assetTypes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "planIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "duration": {
            "$ref": "#/components/schemas/v1CouponDuration"
          },
          "durationInPeriods": {
            "type": "integer",
            "format": "int32"
          },
          "durationDays": {
            "type": "integer",
            "format": "int32"
          },
          "validFrom": {
            "type": "string",
            "format": "date-time"
          },
          "validUntil": {
            "type": "string",
            "format": "date-time",
            "description": "Defaults to the configured validity window unless no_expiry is set."
          },
          "noExpiry": {
            "type": "boolean"
          },
          "maxRedemptions": {
            "type": "integer",
            "format": "int32"
          },
          "oncePerCustomer": {
            "type": "boolean",
            "description": "Defaults to true."
          },
          "firstTimeCustomerOnly": {
            "type": "boolean"
          },
          "acknowledgeHighRisk": {
            "type": "boolean",
            "description": "Required when the terms are effectively free or unlimited."
          },
          "code": {
            "type": "string",
            "description": "Optional first shared code created with the coupon."
          },
          "creditValidDays": {
            "type": "integer",
            "format": "int32",
            "description": "Lot lifetime after a credit code is redeemed. Defaults to 90."
          }
        }
      },
      "v1CreateCouponResponse": {
        "type": "object",
        "properties": {
          "coupon": {
            "$ref": "#/components/schemas/v1Coupon"
          },
          "code": {
            "$ref": "#/components/schemas/v1CouponCode"
          }
        }
      },
      "v1CreateDnsZoneRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "records": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DnsRecord"
            },
            "description": "Records the customer kept from the live-scan review. Empty means create a blank zone."
          }
        }
      },
      "v1CreateDnsZoneResponse": {
        "type": "object",
        "properties": {
          "zone": {
            "$ref": "#/components/schemas/v1DnsZone"
          }
        }
      },
      "v1CreateDomainRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "verificationType": {
            "$ref": "#/components/schemas/v1VerificationType"
          }
        }
      },
      "v1CreateEnvironmentVariableRequest": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "v1CreateFirewallAddressGroupRequest": {
        "type": "object",
        "properties": {
          "group": {
            "$ref": "#/components/schemas/v1FirewallAddressGroupInput"
          }
        }
      },
      "v1CreateFirewallRuleSetRequest": {
        "type": "object",
        "properties": {
          "ruleset": {
            "$ref": "#/components/schemas/v1FirewallRuleSetInput"
          }
        }
      },
      "v1CreateGameServerRequest": {
        "type": "object",
        "properties": {
          "planId": {
            "type": "string"
          },
          "templateId": {
            "type": "string"
          },
          "regionId": {
            "type": "string"
          },
          "providerOrganizationId": {
            "type": "string"
          },
          "versionValue": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "idempotencyKey": {
            "type": "string"
          },
          "environment": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "environment overrides egg defaults. Only user-editable variables are accepted."
          },
          "acceptEula": {
            "type": "boolean",
            "description": "accept_eula is the customer's agreement. Required when the egg has the EULA mark."
          }
        }
      },
      "v1CreateGroupRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "groupRoles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1CreateInviteRequest": {
        "type": "object",
        "properties": {
          "inviteeEmails": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "groupId": {
            "type": "string"
          },
          "roleId": {
            "type": "string"
          }
        }
      },
      "v1CreateManualPayoutRequest": {
        "type": "object",
        "properties": {
          "country": {
            "type": "string",
            "title": "ISO 3166-1 alpha-2 country code (e.g., \"US\", \"GB\", \"DE\")"
          },
          "iban": {
            "type": "string",
            "title": "International Bank Account Number (for SEPA countries)"
          },
          "bic": {
            "type": "string",
            "title": "Bank Identifier Code / SWIFT code (for SEPA countries)"
          },
          "accountNumber": {
            "type": "string",
            "title": "Bank account number (for non-SEPA countries)"
          },
          "routingNumber": {
            "type": "string",
            "title": "Routing number (for US accounts) or sort code (for UK accounts)"
          },
          "accountHolderName": {
            "type": "string",
            "title": "Name of the account holder"
          },
          "bankName": {
            "type": "string",
            "title": "Name of the bank"
          },
          "notes": {
            "type": "string",
            "title": "User-provided notes about the payout account"
          }
        },
        "title": "Manual Payout messages"
      },
      "v1CreateManualPayoutResponse": {
        "type": "object",
        "properties": {
          "payout": {
            "$ref": "#/components/schemas/v1ManualPayout"
          }
        }
      },
      "v1CreateMetricsWriteCredentialRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "agentId": {
            "type": "string",
            "description": "Optional: omit or leave empty when the credential is not tied to an agent."
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time",
            "description": "Optional expiry; omit for non-expiring machine tokens."
          }
        }
      },
      "v1CreateMetricsWriteCredentialResponse": {
        "type": "object",
        "properties": {
          "credential": {
            "$ref": "#/components/schemas/v1MetricsWriteCredential"
          },
          "token": {
            "type": "string",
            "description": "Plaintext token returned only on create/rotate. Store securely; it is not retrievable again."
          }
        }
      },
      "v1CreateNetworkRequest": {
        "type": "object",
        "properties": {
          "dnsServers": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "e.g., [\"8.8.8.8\", \"8.8.4.4\"] (can be any IPs)"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "macAddressPrefix": {
            "type": "string",
            "description": "First 3 octets for MAC allocation within this network (e.g. BC:24:11). Default: BC:24:11."
          }
        },
        "title": "Network management"
      },
      "v1CreateNodeRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "platformId": {
            "type": "string"
          },
          "regionId": {
            "type": "string"
          },
          "cpuOverallocatePercent": {
            "type": "integer",
            "format": "int32"
          },
          "memoryOverallocatePercent": {
            "type": "integer",
            "format": "int32"
          },
          "storageOverallocatePercent": {
            "type": "integer",
            "format": "int32"
          },
          "vmidSeed": {
            "type": "integer",
            "format": "int32"
          },
          "maintenanceMode": {
            "type": "boolean"
          },
          "vmStorageDestination": {
            "type": "string"
          },
          "backupStorageDestination": {
            "type": "string"
          },
          "backupStorageCompression": {
            "$ref": "#/components/schemas/v1BackupStorageCompression"
          },
          "networkBridge": {
            "type": "string",
            "description": "Node provisioning settings (server-side defaults applied when omitted)\nProxmox Linux bridge for VM primary NIC. Default: vmbr0."
          },
          "networkName": {
            "type": "string",
            "description": "Proxmox net device key for primary NIC (net0, net1, ...). Default: net0."
          },
          "networkVlanId": {
            "type": "integer",
            "format": "int32",
            "description": "802.1Q VLAN tag on primary NIC (Proxmox tag=); 0 = untagged."
          },
          "networkModel": {
            "type": "string",
            "description": "Proxmox NIC model for primary NIC. Default: virtio."
          },
          "computeType": {
            "$ref": "#/components/schemas/v1NodeComputeType"
          },
          "topologyPaste": {
            "type": "string",
            "description": "Raw topology paste (output of the documented lscpu/sysfs command block).\nRequired when compute_type is dedicated; ignored otherwise."
          },
          "metadata": {
            "type": "object",
            "description": "Optional node metadata (VirtFusion hypervisor_id / group_id live under metadata.virtfusion)."
          },
          "wingsNodeName": {
            "type": "string"
          },
          "pterodactylLocationId": {
            "type": "integer",
            "format": "int32"
          },
          "panelNodeId": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1CreateNotificationSettingResponse": {
        "type": "object",
        "properties": {
          "notificationSetting": {
            "$ref": "#/components/schemas/v1NotificationSetting"
          }
        }
      },
      "v1CreateNotificationTemplateResponse": {
        "type": "object",
        "properties": {
          "notificationTemplate": {
            "$ref": "#/components/schemas/v1NotificationTemplate"
          }
        }
      },
      "v1CreateOAuth2ClientRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "redirectUris": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "clientType": {
            "type": "string"
          },
          "requiresPkce": {
            "type": "boolean"
          }
        }
      },
      "v1CreateOAuth2ClientResponse": {
        "type": "object",
        "properties": {
          "clientId": {
            "type": "string"
          },
          "clientSecret": {
            "type": "string",
            "title": "Only for confidential clients"
          },
          "name": {
            "type": "string"
          },
          "redirectUris": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1CreateOrganizationRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/v1OrganizationType"
          },
          "providerLogoUrl": {
            "type": "string"
          },
          "asn": {
            "type": "string",
            "format": "int64"
          },
          "ddosProvider": {
            "type": "string",
            "description": "DDoS partner slug (e.g. none, in-house, gcore, akamai, voxility). Provider orgs only."
          },
          "hypervisorDriver": {
            "$ref": "#/components/schemas/v1PlatformDriver"
          },
          "providerWebsiteUrl": {
            "type": "string",
            "description": "Required for provider organizations (http/https; scheme optional in input: server normalizes)."
          }
        }
      },
      "v1CreatePlanRequest": {
        "type": "object",
        "properties": {
          "planId": {
            "type": "string",
            "title": "Template plan ID to clone from (required)"
          },
          "currency": {
            "type": "string",
            "title": "Plan fields to override from template (name, description, and trial_days\ncome from template)"
          },
          "planPrices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PlanPriceOverride"
            },
            "title": "Plan prices with overrides (unit_amount_minor, currency, free_units per\nmetric)"
          },
          "regionId": {
            "type": "string",
            "description": "Region where this plan is offered (exactly one per plan)."
          },
          "cpuLimit": {
            "type": "integer",
            "format": "int32",
            "description": "Plan CPU/network scheduling overrides written into metadata.specifications.\nProxmox cpulimit= (max CPU time); 0 = unlimited. Omitted = template value / 0."
          },
          "cpuUnits": {
            "type": "integer",
            "format": "int32",
            "description": "Proxmox cpuunits= fair-share weight. Omitted = template value / 1024."
          },
          "networkRateLimitMbs": {
            "type": "number",
            "format": "double",
            "description": "Primary NIC rate limit in MB/s (Proxmox rate=); 0 = unlimited."
          },
          "nodeIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Nodes this plan may sell on (must be catalog-eligible for the template).\nRequired: at least one node_id (validated in Go)."
          },
          "onCreditExhaustion": {
            "type": "string",
            "description": "Provider choice when client prepaid credits are exhausted.\nValues: \"suspend\" (default), \"continue_with_dunning\"."
          },
          "metadata": {
            "type": "object",
            "description": "Plan metadata. VirtFusion package_id lives under metadata.virtfusion.package_id."
          }
        }
      },
      "v1CreatePlatformRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "endpointUrl": {
            "type": "string"
          },
          "driver": {
            "$ref": "#/components/schemas/v1PlatformDriver"
          },
          "agentId": {
            "type": "string"
          },
          "assignCustomerIpv6": {
            "type": "boolean",
            "description": "VirtFusion/SolusVM only. Rejected when the org driver is Proxmox."
          },
          "pterodactyl": {
            "type": "boolean",
            "description": "When true, this platform is Pterodactyl. A hypervisor driver is not required."
          },
          "panelUrl": {
            "type": "string",
            "description": "Panel base URL. Required when pterodactyl is true. A bare IP is stored as http://ip."
          }
        }
      },
      "v1CreatePrefixRequest": {
        "type": "object",
        "properties": {
          "networkId": {
            "type": "string",
            "title": "Optional: network this prefix belongs to (for DNS servers)"
          },
          "cidr": {
            "type": "string",
            "title": "e.g., \"10.0.0.0/24\""
          },
          "gateway": {
            "type": "string",
            "title": "e.g., \"10.0.0.1\" (must be within CIDR)"
          },
          "reservedIps": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "e.g., [\"10.0.0.100\", \"10.0.0.200\"] (must be within CIDR)"
          },
          "allocationStrategy": {
            "$ref": "#/components/schemas/v1AllocationStrategy"
          },
          "description": {
            "type": "string"
          },
          "vmAssignmentPrefixLength": {
            "type": "integer",
            "format": "int32",
            "title": "Required when cidr is IPv6"
          }
        },
        "title": "Prefix management"
      },
      "v1CreateProviderReviewReplyResponse": {
        "type": "object",
        "properties": {
          "review": {
            "$ref": "#/components/schemas/v1ProviderReviewListItem"
          }
        }
      },
      "v1CreateRegionRequest": {
        "type": "object",
        "properties": {
          "cityCountryId": {
            "type": "string"
          },
          "datacenterId": {
            "type": "string"
          }
        }
      },
      "v1CreateRoadmapFeatureRequestCommentResponse": {
        "type": "object",
        "properties": {
          "comment": {
            "$ref": "#/components/schemas/v1RoadmapFeatureRequestComment"
          }
        }
      },
      "v1CreateRoleRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "permissions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "groupIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1CreateSSHKeyRequest": {
        "type": "object",
        "properties": {
          "publicKey": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "v1CreateSSHKeyResponse": {
        "type": "object",
        "properties": {
          "sshKey": {
            "$ref": "#/components/schemas/v1SSHKey"
          }
        }
      },
      "v1CreateSecretRequest": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "v1CreateSecretResponse": {
        "type": "object",
        "properties": {
          "secret": {
            "$ref": "#/components/schemas/v1Secret"
          }
        }
      },
      "v1CreateServiceAccountRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "allowedIps": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "title": "Service Account messages"
      },
      "v1CreateTicketAttachmentUploadResponse": {
        "type": "object",
        "properties": {
          "uploadToken": {
            "type": "string"
          },
          "attachment": {
            "$ref": "#/components/schemas/v1TicketAttachment"
          }
        }
      },
      "v1CreateTicketRequest": {
        "type": "object",
        "properties": {
          "ticket": {
            "$ref": "#/components/schemas/v1Ticket"
          },
          "templateId": {
            "type": "string"
          },
          "templateVariables": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "v1CreateTicketResponse": {
        "type": "object",
        "properties": {
          "ticket": {
            "$ref": "#/components/schemas/v1Ticket"
          }
        }
      },
      "v1CreateTicketTemplateRequest": {
        "type": "object",
        "properties": {
          "ticketTemplate": {
            "$ref": "#/components/schemas/v1TicketTemplateInput"
          }
        }
      },
      "v1CreateVMTemplateRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "distro": {
            "$ref": "#/components/schemas/v1Distro"
          },
          "templateId": {
            "type": "integer",
            "format": "int32"
          },
          "nodeId": {
            "type": "string"
          },
          "cloudInitTemplateId": {
            "type": "string"
          },
          "proxmoxCpuType": {
            "type": "string",
            "description": "Proxmox cpu= guest CPU model for VMs using this template. Default: host."
          }
        }
      },
      "v1CreateVirtualMachineRequest": {
        "type": "object",
        "properties": {
          "hostname": {
            "type": "string"
          },
          "planId": {
            "type": "string"
          },
          "regionId": {
            "type": "string",
            "title": "Required region ID where the VM should be created"
          },
          "distro": {
            "$ref": "#/components/schemas/v1Distro"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "Tags for categorizing the virtual machine (e.g., \"database\", \"webserver\")"
          },
          "sshKeyIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "SSH key IDs to use for VM access (one or more). Either user_data, ssh_key_ids, or password must be provided, but only one."
          },
          "password": {
            "type": "string",
            "description": "Password for VM access. Either user_data, ssh_key_ids, or password must be provided, but only one."
          },
          "userData": {
            "type": "string",
            "description": "User data for CloudInit. Either user_data, ssh_key_ids, password, or cloud_init_user_data_id must be provided, but only one."
          },
          "cloudInitUserDataId": {
            "type": "string",
            "description": "Saved client cloud-init user_data profile ID. Replaces provider user_data at VM create."
          },
          "instantAppId": {
            "type": "string",
            "description": "Platform Instant App ID. Replaces provider user_data. Mutually exclusive with\nuser_data and cloud_init_user_data_id. Requires password or ssh_key_ids."
          },
          "idempotencyKey": {
            "type": "string",
            "description": "Client-generated UUID for idempotent create retries. Required for all creates."
          },
          "coupon": {
            "$ref": "#/components/schemas/v1CouponInput"
          },
          "instantAppVariables": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Optional Instant App form overrides (schema from InstantApp.metadata.variables).\nUnknown keys are rejected. Omitted keys use catalog defaults."
          }
        }
      },
      "v1CreditLedgerEntryProto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "entryType": {
            "type": "string"
          },
          "amount": {
            "type": "string",
            "title": "Decimal string"
          },
          "balanceAfter": {
            "type": "string",
            "title": "Decimal string"
          },
          "reservedAfter": {
            "type": "string",
            "title": "Decimal string"
          },
          "currency": {
            "type": "string"
          },
          "creditSource": {
            "type": "string"
          },
          "idempotencyKey": {
            "type": "string"
          },
          "reasonCode": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "v1CreditLedgerEntryType": {
        "type": "string",
        "enum": [
          "CREDIT_LEDGER_ENTRY_TYPE_UNSPECIFIED",
          "CREDIT_LEDGER_ENTRY_TYPE_PURCHASE",
          "CREDIT_LEDGER_ENTRY_TYPE_PROMOTIONAL",
          "CREDIT_LEDGER_ENTRY_TYPE_PROVISION_RESERVE",
          "CREDIT_LEDGER_ENTRY_TYPE_PROVISION_RELEASE",
          "CREDIT_LEDGER_ENTRY_TYPE_USAGE_HOLD",
          "CREDIT_LEDGER_ENTRY_TYPE_HOLD_RELEASE",
          "CREDIT_LEDGER_ENTRY_TYPE_INVOICE_SETTLEMENT",
          "CREDIT_LEDGER_ENTRY_TYPE_CHARGEBACK_REVERSAL",
          "CREDIT_LEDGER_ENTRY_TYPE_EXPIRY",
          "CREDIT_LEDGER_ENTRY_TYPE_FORFEITURE",
          "CREDIT_LEDGER_ENTRY_TYPE_MANUAL_ADJUSTMENT"
        ],
        "default": "CREDIT_LEDGER_ENTRY_TYPE_UNSPECIFIED",
        "description": "CreditLedgerEntryType mirrors the ent enum for proto filtering."
      },
      "v1DashboardAssetSalesDayBucket": {
        "type": "object",
        "properties": {
          "day": {
            "type": "string"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "description": "Total assets sold that day (today equals VM count; available for future multi-product rollups)."
          },
          "virtualMachineCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1DashboardBillingCommercialHealth": {
        "type": "object",
        "properties": {
          "distinctPayingTenantCount": {
            "type": "integer",
            "format": "int32"
          },
          "paidInvoiceCount": {
            "type": "integer",
            "format": "int32"
          },
          "outstandingOpenAmount": {
            "type": "string"
          },
          "outstandingPastDueAmount": {
            "type": "string"
          },
          "outstandingOpenInvoiceCount": {
            "type": "integer",
            "format": "int32"
          },
          "outstandingPastDueInvoiceCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1DashboardBillingCustomerRevenue": {
        "type": "object",
        "properties": {
          "organizationId": {
            "type": "string"
          },
          "organizationName": {
            "type": "string"
          },
          "totalAmount": {
            "type": "string"
          },
          "contactEmail": {
            "type": "string",
            "description": "Primary owner contact email for the client org (billing dashboard display)."
          }
        }
      },
      "v1DashboardBillingProductSlice": {
        "type": "object",
        "properties": {
          "productKey": {
            "type": "string"
          },
          "productLabel": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          }
        },
        "description": "Billing dashboard tab: revenue from paid invoices attributed to this provider's catalog."
      },
      "v1DashboardBillingSalesDayBucket": {
        "type": "object",
        "properties": {
          "day": {
            "type": "string"
          },
          "planSlices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardBillingProductSlice"
            }
          },
          "addonSlices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardBillingProductSlice"
            }
          },
          "priorPeriodDay": {
            "type": "string",
            "description": "Prior window (same length, ending the day before current window): parallel day label and total sales."
          },
          "priorPeriodTotalAmount": {
            "type": "string"
          },
          "planSlicesByPlanCode": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardBillingProductSlice"
            },
            "description": "Same plan revenue as plan_slices, grouped by catalog plan code (SKU) instead of tier/category family."
          }
        }
      },
      "v1DashboardCustomerAcquisitionDayBucket": {
        "type": "object",
        "properties": {
          "day": {
            "type": "string"
          },
          "newCustomers": {
            "type": "integer",
            "format": "int32"
          }
        },
        "description": "Per UTC calendar day: distinct client orgs whose first-ever VM with this provider was created that day (UTC)."
      },
      "v1DashboardIpamAssignmentIpFamily": {
        "type": "string",
        "enum": [
          "DASHBOARD_IPAM_ASSIGNMENT_IP_FAMILY_UNSPECIFIED",
          "DASHBOARD_IPAM_ASSIGNMENT_IP_FAMILY_IPV4",
          "DASHBOARD_IPAM_ASSIGNMENT_IP_FAMILY_IPV6"
        ],
        "default": "DASHBOARD_IPAM_ASSIGNMENT_IP_FAMILY_UNSPECIFIED"
      },
      "v1DashboardIpamAssignmentRow": {
        "type": "object",
        "properties": {
          "networkId": {
            "type": "string"
          },
          "nodeId": {
            "type": "string"
          },
          "ipAddress": {
            "type": "string"
          },
          "virtualMachineId": {
            "type": "string"
          },
          "virtualMachineHostname": {
            "type": "string"
          },
          "clientOrganizationId": {
            "type": "string"
          },
          "nodeName": {
            "type": "string"
          },
          "platformId": {
            "type": "string"
          }
        }
      },
      "v1DashboardIpamNetworkPrefixSummary": {
        "type": "object",
        "properties": {
          "prefixId": {
            "type": "string"
          },
          "cidr": {
            "type": "string"
          },
          "isIpv6": {
            "type": "boolean"
          },
          "usableTotal": {
            "type": "string",
            "format": "int64"
          },
          "capacityIsOpenEnded": {
            "type": "boolean"
          },
          "activeAllocations": {
            "type": "string",
            "format": "int64"
          },
          "reservedCount": {
            "type": "string",
            "format": "int64"
          },
          "availableEstimate": {
            "type": "string",
            "format": "int64"
          },
          "utilizationPercent": {
            "type": "number",
            "format": "double"
          },
          "reservedIps": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "gatewayIp": {
            "type": "string"
          },
          "allocatedSampleIps": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "vmAssignmentPrefixLength": {
            "type": "integer",
            "format": "int32"
          },
          "capacityUnitLabel": {
            "type": "string"
          },
          "reservedPrefixes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "description": "usable_total: assignable pool (structural hosts minus reserved list and in-prefix gateway when\nnot duplicated in reserved). utilization_percent = active_allocations / usable_total.\nreserved_count is len(reserved_ips) for display only."
      },
      "v1DashboardIpamNetworkRollup": {
        "type": "object",
        "properties": {
          "networkId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "dnsServers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "nodeCount": {
            "type": "integer",
            "format": "int32"
          },
          "prefixCount": {
            "type": "integer",
            "format": "int32"
          },
          "activeAllocationsTotal": {
            "type": "string",
            "format": "int64"
          },
          "nodes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardIpamNodeRollup"
            }
          },
          "prefixSummaries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardIpamNetworkPrefixSummary"
            }
          },
          "dashboardVirtualMachineCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1DashboardIpamNodeRollup": {
        "type": "object",
        "properties": {
          "nodeId": {
            "type": "string"
          },
          "nodeName": {
            "type": "string"
          },
          "platformId": {
            "type": "string"
          },
          "platformName": {
            "type": "string"
          }
        }
      },
      "v1DashboardSummaryAddonBreakdown": {
        "type": "object",
        "properties": {
          "addonId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "activeSubscriptionCount": {
            "type": "integer",
            "format": "int32"
          },
          "code": {
            "type": "string"
          },
          "billingType": {
            "$ref": "#/components/schemas/v1BillingType"
          }
        }
      },
      "v1DashboardSummaryPlanBreakdown": {
        "type": "object",
        "properties": {
          "planId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "activeSubscriptionCount": {
            "type": "integer",
            "format": "int32"
          },
          "code": {
            "type": "string"
          },
          "billingType": {
            "$ref": "#/components/schemas/v1BillingType"
          }
        }
      },
      "v1DashboardSummaryRegionBreakdown": {
        "type": "object",
        "properties": {
          "regionId": {
            "type": "string"
          },
          "regionLabel": {
            "type": "string"
          },
          "activeVmCount": {
            "type": "integer",
            "format": "int32"
          },
          "activeCustomerCount": {
            "type": "integer",
            "format": "int32"
          },
          "nodeCount": {
            "type": "integer",
            "format": "int32"
          },
          "ipAddressesFreeTotal": {
            "type": "string",
            "format": "int64"
          },
          "ipAddressesTakenTotal": {
            "type": "string",
            "format": "int64"
          },
          "ipAddressesIpv4FreeTotal": {
            "type": "string",
            "format": "int64"
          },
          "ipAddressesIpv4TakenTotal": {
            "type": "string",
            "format": "int64"
          },
          "ipAddressesIpv6FreeTotal": {
            "type": "string",
            "format": "int64"
          },
          "ipAddressesIpv6TakenTotal": {
            "type": "string",
            "format": "int64"
          }
        }
      },
      "v1DashboardSummaryTickets": {
        "type": "object",
        "properties": {
          "openLast7d": {
            "type": "integer",
            "format": "int32"
          },
          "escalatedLast7d": {
            "type": "integer",
            "format": "int32"
          },
          "slaFirstResponseBreaches": {
            "type": "integer",
            "format": "int32"
          },
          "slaResolutionBreaches": {
            "type": "integer",
            "format": "int32",
            "description": "Deprecated: ticket SLA is first-response only. Always 0; kept for wire compatibility."
          },
          "totalInWindow": {
            "type": "integer",
            "format": "int32"
          },
          "openNeedingProviderFirstResponseLast7d": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1DashboardTicketStatisticsByCaseType": {
        "type": "object",
        "properties": {
          "caseType": {
            "$ref": "#/components/schemas/v1CaseType"
          },
          "count": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1DashboardTicketStatisticsByPriority": {
        "type": "object",
        "properties": {
          "priority": {
            "$ref": "#/components/schemas/v1TicketPriority"
          },
          "count": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1DashboardTicketStatisticsByStatus": {
        "type": "object",
        "properties": {
          "ticketStatus": {
            "$ref": "#/components/schemas/v1TicketStatus"
          },
          "count": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1DashboardTicketStatisticsDayBucket": {
        "type": "object",
        "properties": {
          "day": {
            "type": "string"
          },
          "count": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1DashboardVirtualMachineRow": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "hostname": {
            "type": "string"
          },
          "cpu": {
            "type": "integer",
            "format": "int32"
          },
          "memoryMb": {
            "type": "integer",
            "format": "int32"
          },
          "storageMb": {
            "type": "integer",
            "format": "int32"
          },
          "distro": {
            "$ref": "#/components/schemas/v1Distro"
          },
          "clientOrganizationId": {
            "type": "string"
          },
          "clientContactEmail": {
            "type": "string"
          },
          "ipv4Address": {
            "type": "string"
          },
          "ipv6Address": {
            "type": "string"
          },
          "macAddress": {
            "type": "string",
            "description": "Allocated MAC address (provider-only visibility; never exposed on client VM APIs)."
          },
          "complianceHeld": {
            "type": "boolean"
          },
          "complianceReason": {
            "$ref": "#/components/schemas/v1ComplianceReason"
          },
          "complianceMessage": {
            "type": "string"
          },
          "complianceActor": {
            "$ref": "#/components/schemas/v1ComplianceActor"
          }
        }
      },
      "v1Datacenter": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "v1DatacenterInfo": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "v1DeleteProviderReviewReplyResponse": {
        "type": "object",
        "properties": {
          "review": {
            "$ref": "#/components/schemas/v1ProviderReviewListItem"
          }
        }
      },
      "v1DeleteRoadmapFeatureRequestCommentResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      },
      "v1DisableMfaRequest": {
        "type": "object",
        "properties": {
          "password": {
            "type": "string",
            "description": "Required when the user has a local password."
          },
          "code": {
            "type": "string",
            "description": "Current TOTP or an unused recovery code."
          }
        }
      },
      "v1Distro": {
        "type": "string",
        "enum": [
          "DISTRO_UNSPECIFIED",
          "DISTRO_UBUNTU_22_04",
          "DISTRO_UBUNTU_24_04",
          "DISTRO_UBUNTU_26_04",
          "DISTRO_FEDORA_43",
          "DISTRO_FEDORA_44",
          "DISTRO_DEBIAN_12",
          "DISTRO_DEBIAN_13",
          "DISTRO_CENTOS_9",
          "DISTRO_CENTOS_10",
          "DISTRO_ROCKY_9",
          "DISTRO_ROCKY_10",
          "DISTRO_ALMALINUX_9",
          "DISTRO_ALMALINUX_10"
        ],
        "default": "DISTRO_UNSPECIFIED",
        "description": "- DISTRO_UBUNTU_22_04: Ubuntu distributions\n - DISTRO_FEDORA_43: Fedora distributions\n - DISTRO_DEBIAN_12: Debian distributions\n - DISTRO_CENTOS_9: CentOS distributions\n - DISTRO_ROCKY_9: Rocky Linux distributions\n - DISTRO_ALMALINUX_9: AlmaLinux distributions",
        "title": "Distribution enum for VM templates"
      },
      "v1DistroCatalogEntry": {
        "type": "object",
        "properties": {
          "distro": {
            "$ref": "#/components/schemas/v1Distro"
          },
          "family": {
            "type": "string",
            "description": "Family groups versions in the OS picker (ubuntu, debian, fedora, centos, alma, rocky)."
          },
          "name": {
            "type": "string",
            "description": "Name is the customer-facing family name, such as \"Ubuntu\" or \"CentOS Stream\"."
          },
          "version": {
            "type": "string",
            "description": "Version is the version label shown next to the family, such as \"24.04 LTS\"."
          },
          "label": {
            "type": "string",
            "description": "Label is the full display name, such as \"Ubuntu 24.04 LTS\"."
          },
          "isDefault": {
            "type": "boolean",
            "description": "IsDefault marks the version selected when the customer picks this family."
          }
        },
        "description": "DistroCatalogEntry is one guest operating system the marketplace can install."
      },
      "v1DnsGeoLocation": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "parent": {
            "type": "string"
          },
          "continent": {
            "type": "string"
          },
          "latitude": {
            "type": "number",
            "format": "double"
          },
          "longitude": {
            "type": "number",
            "format": "double"
          },
          "members": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1DnsGeoRecord": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "ttl": {
            "type": "integer",
            "format": "int64"
          },
          "defaultRdata": {
            "type": "string"
          },
          "continents": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "countries": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "regions": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "v1DnsRecord": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "title": "A, AAAA, CNAME, ALIAS, MX, TXT, SRV, CAA, NS, HTTPS, SVCB, SSHFP, DNAME,\nPTR, RP, NAPTR, TLSA, SMIMEA, OPENPGPKEY, CERT, DS (non-apex), HINFO, LOC"
          },
          "ttl": {
            "type": "integer",
            "format": "int64"
          },
          "rdata": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "system": {
            "type": "boolean",
            "readOnly": true
          }
        }
      },
      "v1DnsZone": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true
          },
          "name": {
            "type": "string"
          },
          "state": {
            "$ref": "#/components/schemas/v1DnsZoneState"
          },
          "assignedNameservers": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "readOnly": true
          },
          "unicastNameservers": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "readOnly": true
          },
          "delegationOk": {
            "type": "boolean",
            "readOnly": true
          },
          "dnssecMode": {
            "$ref": "#/components/schemas/v1DnssecMode"
          },
          "geoEnabled": {
            "type": "boolean",
            "readOnly": true
          },
          "organizationId": {
            "type": "string",
            "readOnly": true
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        },
        "description": "DnsZone is a hosted authoritative zone. Vanilla records live in PowerDNS, not Ent."
      },
      "v1DnsZoneState": {
        "type": "string",
        "enum": [
          "DNS_ZONE_STATE_UNSPECIFIED",
          "DNS_ZONE_STATE_PENDING_NS",
          "DNS_ZONE_STATE_ACTIVE",
          "DNS_ZONE_STATE_DISABLED",
          "DNS_ZONE_STATE_DELETING"
        ],
        "default": "DNS_ZONE_STATE_UNSPECIFIED"
      },
      "v1DnssecInfo": {
        "type": "object",
        "properties": {
          "mode": {
            "$ref": "#/components/schemas/v1DnssecMode"
          },
          "algorithm": {
            "type": "string",
            "readOnly": true
          },
          "keyTag": {
            "type": "integer",
            "format": "int64",
            "readOnly": true
          },
          "digestType": {
            "type": "integer",
            "format": "int64",
            "readOnly": true
          },
          "ds": {
            "type": "string",
            "readOnly": true
          },
          "dnskey": {
            "type": "string",
            "readOnly": true
          },
          "dsAtParent": {
            "type": "boolean",
            "readOnly": true
          },
          "nsecMode": {
            "type": "string",
            "readOnly": true
          }
        }
      },
      "v1DnssecMode": {
        "type": "string",
        "enum": [
          "DNSSEC_MODE_UNSPECIFIED",
          "DNSSEC_MODE_UNSIGNED",
          "DNSSEC_MODE_SIGNED_DS_PENDING",
          "DNSSEC_MODE_SIGNED_ACTIVE"
        ],
        "default": "DNSSEC_MODE_UNSPECIFIED"
      },
      "v1DockerImageChoice": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "image": {
            "type": "string"
          }
        }
      },
      "v1Domain": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "name": {
            "type": "string"
          },
          "isVerified": {
            "type": "boolean"
          },
          "verificationType": {
            "$ref": "#/components/schemas/v1VerificationType"
          },
          "organizationId": {
            "type": "string",
            "title": "Relations"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1DownloadFileResponse": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string",
            "format": "byte"
          }
        }
      },
      "v1DownloadTicketAttachmentResponse": {
        "type": "object",
        "properties": {
          "attachmentId": {
            "type": "string"
          },
          "fileName": {
            "type": "string"
          },
          "mimeType": {
            "type": "string"
          },
          "fileSize": {
            "type": "string",
            "format": "int64"
          },
          "fileContent": {
            "type": "string",
            "format": "byte"
          }
        }
      },
      "v1EffectivePermissions": {
        "type": "object",
        "properties": {
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Permission"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1EggVariable": {
        "type": "object",
        "properties": {
          "envVariable": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "defaultValue": {
            "type": "string"
          },
          "rules": {
            "type": "string"
          },
          "userViewable": {
            "type": "boolean"
          },
          "userEditable": {
            "type": "boolean"
          },
          "isRequired": {
            "type": "boolean",
            "description": "is_required is true when the panel rules contain required."
          },
          "helpText": {
            "type": "string",
            "description": "help_text explains where the customer finds the value."
          },
          "helpUrl": {
            "type": "string",
            "description": "help_url is a page that shows the value, when one is known."
          }
        },
        "description": "EggVariable is one panel variable the customer can see while ordering a game."
      },
      "v1EnableAdditionalIPResponse": {
        "type": "object",
        "properties": {
          "allocation": {
            "$ref": "#/components/schemas/v1AdditionalIPAddress"
          },
          "totalAdditionalIps": {
            "type": "integer",
            "format": "int32"
          },
          "monthlyUnitPrice": {
            "type": "string",
            "description": "Monthly list price per additional IP (fixed billing). Empty for usage-based VMs."
          },
          "proratedChargeAmount": {
            "type": "string",
            "description": "Prorated amount charged now for the remaining VM billing period (fixed billing)."
          },
          "currency": {
            "type": "string"
          },
          "billingMessage": {
            "type": "string",
            "description": "Human-readable billing summary for the UI."
          }
        },
        "description": "EnableAdditionalIPResponse returns the newly allocated address."
      },
      "v1EndUser": {
        "type": "string",
        "enum": [
          "END_USER_UNSPECIFIED",
          "END_USER_CLIENT",
          "END_USER_PROVIDER",
          "END_USER_ALL",
          "END_USER_USER"
        ],
        "default": "END_USER_UNSPECIFIED"
      },
      "v1EnrollMfaTotpRequest": {
        "type": "object"
      },
      "v1EnrollMfaTotpResponse": {
        "type": "object",
        "properties": {
          "otpauthUrl": {
            "type": "string"
          },
          "secret": {
            "type": "string",
            "description": "Base32 TOTP secret for manual entry / backup. Shown once during enrollment."
          }
        }
      },
      "v1EnvironmentVariable": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "key": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "user": {
            "type": "string",
            "title": "Relations"
          },
          "organization": {
            "type": "string"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1ExchangeSSOCodeRequest": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          }
        }
      },
      "v1ExpireConnectTaxRegistrationResponse": {
        "type": "object",
        "properties": {
          "registration": {
            "$ref": "#/components/schemas/v1ConnectTaxRegistration"
          }
        }
      },
      "v1ExportCouponCodesResponse": {
        "type": "object",
        "properties": {
          "filename": {
            "type": "string"
          },
          "csv": {
            "type": "string",
            "description": "CSV with a header row: code,status,times_redeemed,max_redemptions,valid_until,campaign,channel."
          },
          "count": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ExportDnsZoneResponse": {
        "type": "object",
        "properties": {
          "zoneText": {
            "type": "string"
          }
        }
      },
      "v1FirewallAction": {
        "type": "string",
        "enum": [
          "FIREWALL_ACTION_UNSPECIFIED",
          "FIREWALL_ACTION_ACCEPT",
          "FIREWALL_ACTION_DROP"
        ],
        "default": "FIREWALL_ACTION_UNSPECIFIED"
      },
      "v1FirewallAddressGroup": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true
          },
          "name": {
            "type": "string"
          },
          "prefixes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1FirewallIPPrefix"
            },
            "description": "CIDR prefixes. Can contain mixed IPv4 and IPv6 addresses.\nSupports \"all IPs\" via 0.0.0.0/0 or ::/0."
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1FirewallAddressGroupInput": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "prefixes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1FirewallIPPrefix"
            },
            "description": "CIDR prefixes. Can contain mixed IPv4 and IPv6 addresses.\nSupports \"all IPs\" via 0.0.0.0/0 or ::/0."
          }
        },
        "description": "FirewallAddressGroupInput is the client-provided payload for create/update.\nClients must not provide id/timestamps (those are server-controlled)."
      },
      "v1FirewallDirection": {
        "type": "string",
        "enum": [
          "FIREWALL_DIRECTION_UNSPECIFIED",
          "FIREWALL_DIRECTION_INGRESS",
          "FIREWALL_DIRECTION_EGRESS"
        ],
        "default": "FIREWALL_DIRECTION_UNSPECIFIED"
      },
      "v1FirewallIPPrefix": {
        "type": "object",
        "properties": {
          "ip": {
            "type": "string",
            "description": "IPv4 or IPv6 address. May be \"0.0.0.0\" (v4 default route) or \"::\" (v6 default route)."
          },
          "prefix": {
            "type": "integer",
            "format": "int64",
            "description": "Prefix length. IPv4: 0-32. IPv6: 0-128. Enforced by backend based on derived family."
          }
        },
        "description": "FirewallIPPrefix represents a single CIDR prefix as separate fields.\nThe backend will normalize/store it as a CIDR string (e.g., \"10.0.0.0/24\", \"0.0.0.0/0\", \"::/0\")."
      },
      "v1FirewallProtocol": {
        "type": "string",
        "enum": [
          "FIREWALL_PROTOCOL_UNSPECIFIED",
          "FIREWALL_PROTOCOL_TCP",
          "FIREWALL_PROTOCOL_UDP",
          "FIREWALL_PROTOCOL_SCTP",
          "FIREWALL_PROTOCOL_IPV6",
          "FIREWALL_PROTOCOL_ICMP",
          "FIREWALL_PROTOCOL_ICMPV6",
          "FIREWALL_PROTOCOL_ESP",
          "FIREWALL_PROTOCOL_AH",
          "FIREWALL_PROTOCOL_IPSEC",
          "FIREWALL_PROTOCOL_GRE",
          "FIREWALL_PROTOCOL_IPIP",
          "FIREWALL_PROTOCOL_VXLAN",
          "FIREWALL_PROTOCOL_L2TP",
          "FIREWALL_PROTOCOL_GENEVE",
          "FIREWALL_PROTOCOL_ANY",
          "FIREWALL_PROTOCOL_IGMP",
          "FIREWALL_PROTOCOL_GGP",
          "FIREWALL_PROTOCOL_IPENCAP",
          "FIREWALL_PROTOCOL_ST",
          "FIREWALL_PROTOCOL_EGP",
          "FIREWALL_PROTOCOL_IGP",
          "FIREWALL_PROTOCOL_PUP",
          "FIREWALL_PROTOCOL_HMP",
          "FIREWALL_PROTOCOL_XNS_IDP",
          "FIREWALL_PROTOCOL_RDP",
          "FIREWALL_PROTOCOL_ISO_TP4",
          "FIREWALL_PROTOCOL_DCCP",
          "FIREWALL_PROTOCOL_XTP",
          "FIREWALL_PROTOCOL_DDP",
          "FIREWALL_PROTOCOL_IDPR_CMTP",
          "FIREWALL_PROTOCOL_IPV6_ROUTE",
          "FIREWALL_PROTOCOL_IPV6_FRAG",
          "FIREWALL_PROTOCOL_IDRP",
          "FIREWALL_PROTOCOL_RSVP",
          "FIREWALL_PROTOCOL_SKIP",
          "FIREWALL_PROTOCOL_IPV6_ICMP",
          "FIREWALL_PROTOCOL_IPV6_NONXT",
          "FIREWALL_PROTOCOL_IPV6_OPTS",
          "FIREWALL_PROTOCOL_VMTP",
          "FIREWALL_PROTOCOL_EIGRP",
          "FIREWALL_PROTOCOL_OSPF",
          "FIREWALL_PROTOCOL_AX_25",
          "FIREWALL_PROTOCOL_ETHERIP",
          "FIREWALL_PROTOCOL_ENCAP",
          "FIREWALL_PROTOCOL_PIM",
          "FIREWALL_PROTOCOL_IPCOMP",
          "FIREWALL_PROTOCOL_VRRP",
          "FIREWALL_PROTOCOL_ISIS",
          "FIREWALL_PROTOCOL_FC",
          "FIREWALL_PROTOCOL_MOBILITY_HEADER",
          "FIREWALL_PROTOCOL_UDPLITE",
          "FIREWALL_PROTOCOL_MPLS_IN_IP",
          "FIREWALL_PROTOCOL_HIP",
          "FIREWALL_PROTOCOL_SHIM6",
          "FIREWALL_PROTOCOL_WESP",
          "FIREWALL_PROTOCOL_ROHC"
        ],
        "default": "FIREWALL_PROTOCOL_UNSPECIFIED",
        "title": "- FIREWALL_PROTOCOL_ICMPV6: legacy alias; prefer IPV6_ICMP for new rules\n - FIREWALL_PROTOCOL_IPSEC: legacy logical grouping; not a Proxmox /etc/protocols name\n - FIREWALL_PROTOCOL_VXLAN: legacy; not in Proxmox protocol selector\n - FIREWALL_PROTOCOL_GENEVE: legacy; not in Proxmox protocol selector\n - FIREWALL_PROTOCOL_ANY: Match all protocols (Proxmox proto left unset)\n - FIREWALL_PROTOCOL_IGMP: Remaining values mirror Proxmox VE IPProtocolSelector (www/manager6/form/IPProtocolSelector.js)\n - FIREWALL_PROTOCOL_XNS_IDP: xns-idp\n - FIREWALL_PROTOCOL_ISO_TP4: iso-tp4\n - FIREWALL_PROTOCOL_IDPR_CMTP: idpr-cmtp\n - FIREWALL_PROTOCOL_IPV6_ROUTE: ipv6-route\n - FIREWALL_PROTOCOL_IPV6_FRAG: ipv6-frag\n - FIREWALL_PROTOCOL_IPV6_ICMP: ipv6-icmp (Proxmox name for ICMPv6)\n - FIREWALL_PROTOCOL_IPV6_NONXT: ipv6-nonxt\n - FIREWALL_PROTOCOL_IPV6_OPTS: ipv6-opts\n - FIREWALL_PROTOCOL_AX_25: ax.25\n - FIREWALL_PROTOCOL_MOBILITY_HEADER: mobility-header\n - FIREWALL_PROTOCOL_MPLS_IN_IP: mpls-in-ip"
      },
      "v1FirewallRuleAddressGroups": {
        "type": "object",
        "properties": {
          "addressGroupIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "description": "FirewallRuleAddressGroups contains address group UUIDs. Can be one or more."
      },
      "v1FirewallRuleDestination": {
        "type": "object",
        "properties": {
          "ips": {
            "$ref": "#/components/schemas/v1FirewallRuleIPs"
          },
          "addressGroupIds": {
            "$ref": "#/components/schemas/v1FirewallRuleAddressGroups"
          },
          "vmTags": {
            "$ref": "#/components/schemas/v1FirewallRuleVMTags"
          }
        },
        "description": "FirewallRuleDestination defines the destination specification for a firewall rule.\nAll fields are optional, but at least one must be set. Multiple fields can be combined."
      },
      "v1FirewallRuleIPs": {
        "type": "object",
        "properties": {
          "ips": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "description": "FirewallRuleIPs contains IP addresses in CIDR format. Can be one or more."
      },
      "v1FirewallRuleInput": {
        "type": "object",
        "properties": {
          "action": {
            "$ref": "#/components/schemas/v1FirewallAction"
          },
          "protocol": {
            "$ref": "#/components/schemas/v1FirewallProtocol"
          },
          "direction": {
            "$ref": "#/components/schemas/v1FirewallDirection"
          },
          "source": {
            "$ref": "#/components/schemas/v1FirewallRuleSource"
          },
          "destination": {
            "$ref": "#/components/schemas/v1FirewallRuleDestination"
          },
          "sourcePorts": {
            "type": "string",
            "title": "Optional: single port or range (e.g., \"80\" or \"8000-9000\")"
          },
          "destinationPorts": {
            "type": "string",
            "title": "Optional: single port or range (e.g., \"443\" or \"5000-5010\")"
          }
        },
        "description": "FirewallRuleInput is the client-provided rule payload for create/update.\nClients must not provide id/ruleset_id/timestamps (those are server-controlled)."
      },
      "v1FirewallRulePosition": {
        "type": "string",
        "enum": [
          "FIREWALL_RULE_POSITION_UNSPECIFIED",
          "FIREWALL_RULE_POSITION_BEFORE",
          "FIREWALL_RULE_POSITION_AFTER"
        ],
        "default": "FIREWALL_RULE_POSITION_UNSPECIFIED",
        "title": "- FIREWALL_RULE_POSITION_BEFORE: Move before the target rule (higher priority)\n - FIREWALL_RULE_POSITION_AFTER: Move after the target rule (lower priority)"
      },
      "v1FirewallRuleResource": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true
          },
          "rulesetId": {
            "type": "string",
            "readOnly": true
          },
          "rule": {
            "$ref": "#/components/schemas/v1FirewallRuleInput"
          },
          "position": {
            "type": "integer",
            "format": "int64",
            "description": "Position of the rule (0, 1, 2, 3...). Sequential position indicating order. Auto-assigned by the system.",
            "readOnly": true
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        },
        "description": "FirewallRuleResource is a first-class rule resource that belongs to a FirewallRuleSet."
      },
      "v1FirewallRuleSet": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true
          },
          "name": {
            "type": "string"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "ruleCount": {
            "type": "integer",
            "format": "int32",
            "description": "Number of rules in this ruleset (ingress and egress combined).",
            "readOnly": true
          },
          "attachedVmCount": {
            "type": "integer",
            "format": "int32",
            "description": "Number of virtual machines currently attached to this ruleset.",
            "readOnly": true
          },
          "attachedVmHostnames": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Hostnames of virtual machines attached to this ruleset (sorted).",
            "readOnly": true
          }
        }
      },
      "v1FirewallRuleSetAttachmentFilter": {
        "type": "string",
        "enum": [
          "FIREWALL_RULESET_ATTACHMENT_FILTER_UNSPECIFIED",
          "FIREWALL_RULESET_ATTACHMENT_FILTER_ATTACHED",
          "FIREWALL_RULESET_ATTACHMENT_FILTER_UNATTACHED"
        ],
        "default": "FIREWALL_RULESET_ATTACHMENT_FILTER_UNSPECIFIED",
        "description": "FirewallRuleSetAttachmentFilter filters rulesets by whether any VM is attached.\n\n - FIREWALL_RULESET_ATTACHMENT_FILTER_UNSPECIFIED: All rulesets\n - FIREWALL_RULESET_ATTACHMENT_FILTER_ATTACHED: Rulesets with at least one VM attached\n - FIREWALL_RULESET_ATTACHMENT_FILTER_UNATTACHED: Rulesets with no VMs attached"
      },
      "v1FirewallRuleSetInput": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          }
        }
      },
      "v1FirewallRuleSource": {
        "type": "object",
        "properties": {
          "ips": {
            "$ref": "#/components/schemas/v1FirewallRuleIPs"
          },
          "addressGroupIds": {
            "$ref": "#/components/schemas/v1FirewallRuleAddressGroups"
          },
          "vmTags": {
            "$ref": "#/components/schemas/v1FirewallRuleVMTags"
          }
        },
        "description": "FirewallRuleSource defines the source specification for a firewall rule.\nAll fields are optional, but at least one must be set. Multiple fields can be combined."
      },
      "v1FirewallRuleVMTags": {
        "type": "object",
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "description": "FirewallRuleVMTags contains VM tags. Can be one or more."
      },
      "v1ForgotPasswordRequest": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string"
          },
          "turnstileToken": {
            "type": "string",
            "description": "Cloudflare Turnstile token from the client widget (optional unless auth.turnstile is enabled)."
          }
        }
      },
      "v1FunctionCall": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Unique ID for this function call"
          },
          "name": {
            "type": "string",
            "title": "Function name (e.g., \"list_providers\", \"list_available_regions\")"
          },
          "arguments": {
            "type": "string",
            "title": "Function arguments as JSON string"
          }
        }
      },
      "v1FunctionResult": {
        "type": "object",
        "properties": {
          "functionCallId": {
            "type": "string",
            "title": "ID of the function call this result corresponds to"
          },
          "content": {
            "type": "string",
            "title": "Result content as JSON string"
          },
          "isError": {
            "type": "boolean",
            "title": "Whether this is an error result"
          }
        }
      },
      "v1GameServer": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "planId": {
            "type": "string"
          },
          "templateId": {
            "type": "string"
          },
          "regionId": {
            "type": "string"
          },
          "nodeId": {
            "type": "string"
          },
          "organizationId": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "variant": {
            "type": "string"
          },
          "versionValue": {
            "type": "string"
          },
          "allocationIp": {
            "type": "string"
          },
          "allocationPort": {
            "type": "integer",
            "format": "int32"
          },
          "allocationAlias": {
            "type": "string"
          },
          "phase": {
            "$ref": "#/components/schemas/v1GameServerPhase"
          },
          "lastError": {
            "type": "string"
          },
          "panelIdentifier": {
            "type": "string"
          },
          "powerState": {
            "type": "string"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "providerName": {
            "type": "string"
          },
          "regionCity": {
            "type": "string"
          },
          "regionCountry": {
            "type": "string"
          },
          "planCode": {
            "type": "string"
          },
          "gameName": {
            "type": "string"
          },
          "planBillingType": {
            "type": "string",
            "description": "BILLING_TYPE_SUBSCRIPTION is fixed price. The delete dialog uses this for the no-refund warning."
          },
          "databaseLimit": {
            "type": "integer",
            "format": "int32",
            "description": "database_limit is how many databases this plan allows. From 1 to 99."
          },
          "backupLimit": {
            "type": "integer",
            "format": "int32",
            "description": "backup_limit is how many backups this plan allows. From 1 to 99."
          },
          "allocationLimit": {
            "type": "integer",
            "format": "int32",
            "description": "allocation_limit is how many extra ports this plan allows besides the one created with the server. From 1 to 99."
          }
        }
      },
      "v1GameServerAllocation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int32"
          },
          "ip": {
            "type": "string"
          },
          "port": {
            "type": "integer",
            "format": "int32"
          },
          "alias": {
            "type": "string"
          },
          "notes": {
            "type": "string"
          },
          "isDefault": {
            "type": "boolean"
          }
        }
      },
      "v1GameServerBackup": {
        "type": "object",
        "properties": {
          "uuid": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "isSuccessful": {
            "type": "boolean"
          },
          "isLocked": {
            "type": "boolean"
          },
          "bytes": {
            "type": "string",
            "format": "int64"
          },
          "completedAt": {
            "type": "string"
          }
        }
      },
      "v1GameServerDatabase": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "username": {
            "type": "string"
          },
          "host": {
            "type": "string"
          },
          "port": {
            "type": "integer",
            "format": "int32"
          },
          "connectionsFrom": {
            "type": "string"
          },
          "password": {
            "type": "string"
          },
          "jdbc": {
            "type": "string"
          }
        }
      },
      "v1GameServerFile": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "isFile": {
            "type": "boolean"
          },
          "size": {
            "type": "string",
            "format": "int64"
          },
          "mime": {
            "type": "string"
          }
        }
      },
      "v1GameServerMatchStatus": {
        "type": "string",
        "enum": [
          "GAME_SERVER_MATCH_STATUS_UNSPECIFIED",
          "GAME_SERVER_MATCH_STATUS_MATCHED",
          "GAME_SERVER_MATCH_STATUS_UNMAPPED",
          "GAME_SERVER_MATCH_STATUS_AMBIGUOUS"
        ],
        "default": "GAME_SERVER_MATCH_STATUS_UNSPECIFIED"
      },
      "v1GameServerPhase": {
        "type": "string",
        "enum": [
          "GAME_SERVER_PHASE_UNSPECIFIED",
          "GAME_SERVER_PHASE_PENDING",
          "GAME_SERVER_PHASE_READY",
          "GAME_SERVER_PHASE_ERROR",
          "GAME_SERVER_PHASE_FAILED"
        ],
        "default": "GAME_SERVER_PHASE_UNSPECIFIED"
      },
      "v1GameServerResources": {
        "type": "object",
        "properties": {
          "state": {
            "type": "string"
          },
          "cpuAbsolute": {
            "type": "number",
            "format": "double"
          },
          "memoryBytes": {
            "type": "string",
            "format": "int64"
          },
          "diskBytes": {
            "type": "string",
            "format": "int64"
          },
          "networkRxBytes": {
            "type": "string",
            "format": "int64"
          },
          "networkTxBytes": {
            "type": "string",
            "format": "int64"
          },
          "uptimeMillis": {
            "type": "string",
            "format": "int64"
          }
        }
      },
      "v1GameServerSchedule": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "minute": {
            "type": "string"
          },
          "hour": {
            "type": "string"
          },
          "dayOfMonth": {
            "type": "string"
          },
          "month": {
            "type": "string"
          },
          "dayOfWeek": {
            "type": "string"
          },
          "isActive": {
            "type": "boolean"
          },
          "onlyWhenOnline": {
            "type": "boolean"
          },
          "tasks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1GameServerScheduleTask"
            }
          },
          "lastRunAt": {
            "type": "string"
          },
          "nextRunAt": {
            "type": "string"
          },
          "isProcessing": {
            "type": "boolean"
          }
        }
      },
      "v1GameServerScheduleTask": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "sequenceId": {
            "type": "integer",
            "format": "int32"
          },
          "action": {
            "type": "string"
          },
          "payload": {
            "type": "string"
          },
          "timeOffset": {
            "type": "integer",
            "format": "int32"
          },
          "continueOnFailure": {
            "type": "boolean"
          }
        }
      },
      "v1GameServerServiceRestoreBackupBody": {
        "type": "object",
        "properties": {
          "truncate": {
            "type": "boolean",
            "description": "Restore only. When true, the panel deletes every file before extracting the backup."
          }
        }
      },
      "v1GameServerTemplate": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "platformId": {
            "type": "string"
          },
          "catalogKey": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "nestId": {
            "type": "integer",
            "format": "int32"
          },
          "eggId": {
            "type": "integer",
            "format": "int32"
          },
          "suggestedNestId": {
            "type": "integer",
            "format": "int32"
          },
          "suggestedEggId": {
            "type": "integer",
            "format": "int32"
          },
          "startup": {
            "type": "string"
          },
          "dockerImage": {
            "type": "string"
          },
          "versionVariable": {
            "type": "string"
          },
          "confirmed": {
            "type": "boolean"
          },
          "hidden": {
            "type": "boolean"
          },
          "matchStatus": {
            "$ref": "#/components/schemas/v1GameServerMatchStatus"
          },
          "orderingEnabled": {
            "type": "boolean",
            "description": "Optional so a false value is still sent. Missing means the egg is offered."
          },
          "nestOrderingEnabled": {
            "type": "boolean",
            "description": "Optional so a false value is still sent. Missing means the nest is offered."
          }
        }
      },
      "v1GenerateCouponCodesResponse": {
        "type": "object",
        "properties": {
          "batchId": {
            "type": "string"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "description": "Requested count. Large batches are generated in the background; poll\nGetCouponCodeBatch until batch.status is COMPLETED or FAILED."
          },
          "batch": {
            "$ref": "#/components/schemas/v1CouponCodeBatch"
          }
        }
      },
      "v1GenerateInstallCommandResponse": {
        "type": "object",
        "properties": {
          "command": {
            "type": "string",
            "title": "Full curl/bash command that can be executed"
          },
          "token": {
            "type": "string",
            "title": "One-time token used in the command for authentication"
          }
        }
      },
      "v1GeneratePeeringConfigResponse": {
        "type": "object",
        "properties": {
          "config": {
            "type": "string"
          }
        }
      },
      "v1GenerateServiceAccountTokenResponse": {
        "type": "object",
        "properties": {
          "token": {
            "type": "string"
          },
          "tokenId": {
            "type": "string"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "warning": {
            "type": "string"
          }
        }
      },
      "v1GetActiveSessionsResponse": {
        "type": "object",
        "properties": {
          "sessions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1SessionInfo"
            }
          }
        }
      },
      "v1GetAddonResponse": {
        "type": "object",
        "properties": {
          "addon": {
            "$ref": "#/components/schemas/v1Addon"
          },
          "addonPrices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1AddonPrice"
            }
          }
        }
      },
      "v1GetAgentResponse": {
        "type": "object",
        "properties": {
          "agent": {
            "$ref": "#/components/schemas/v1Agent"
          }
        }
      },
      "v1GetAllExchangeRatesResponse": {
        "type": "object",
        "properties": {
          "rates": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "title": "Map of currency codes to exchange rates (from USD)\nKey: currency code (e.g., \"EUR\", \"GBP\")\nValue: exchange rate as decimal string"
          },
          "lastUpdated": {
            "type": "string",
            "format": "int64",
            "title": "Timestamp when rates were last updated"
          }
        }
      },
      "v1GetBackupResponse": {
        "type": "object",
        "properties": {
          "backup": {
            "$ref": "#/components/schemas/v1Backup"
          }
        }
      },
      "v1GetClientDashboardBillingResponse": {
        "type": "object",
        "properties": {
          "currency": {
            "type": "string"
          },
          "spendDays": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ClientDashboardSpendBucket"
            },
            "description": "Daily categorized spend, oldest first (fixed window ending today, UTC)."
          },
          "spendHours": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ClientDashboardSpendBucket"
            },
            "description": "Hourly categorized spend for the last 24 hours, oldest first."
          },
          "usageRollups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ClientDashboardUsageRollup"
            }
          }
        }
      },
      "v1GetClientDashboardSummaryResponse": {
        "type": "object",
        "properties": {
          "virtualMachines": {
            "$ref": "#/components/schemas/v1ClientDashboardVirtualMachinesSummary"
          },
          "spendingWindows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ClientDashboardSpendingWindow"
            }
          }
        },
        "description": "Client dashboard (buyer org): single read for Summary tab widgets."
      },
      "v1GetClientReviewForVirtualMachineResponse": {
        "type": "object",
        "properties": {
          "hasSubmitted": {
            "type": "boolean"
          },
          "review": {
            "$ref": "#/components/schemas/v1ClientProviderReview"
          },
          "canSubmitReview": {
            "type": "boolean"
          },
          "reviewBlockedReason": {
            "type": "string",
            "description": "Set when can_submit_review is false and has_submitted is false (e.g. usage-based 24h window)."
          },
          "reviewAvailableAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "v1GetCloudInitTemplateResponse": {
        "type": "object",
        "properties": {
          "cloudInitTemplate": {
            "$ref": "#/components/schemas/v1CloudInitTemplate"
          }
        }
      },
      "v1GetConnectAccountResponse": {
        "type": "object",
        "properties": {
          "account": {
            "$ref": "#/components/schemas/v1ConnectAccount"
          },
          "onboardingUrl": {
            "type": "string",
            "title": "URL for provider to complete setup (if required)"
          },
          "requiresOnboarding": {
            "type": "boolean",
            "title": "Whether provider needs to complete onboarding"
          }
        }
      },
      "v1GetConnectTaxSettingsResponse": {
        "type": "object",
        "properties": {
          "settings": {
            "$ref": "#/components/schemas/v1ConnectTaxSettingsDetails"
          }
        }
      },
      "v1GetConversationHistoryResponse": {
        "type": "object",
        "properties": {
          "conversationId": {
            "type": "string",
            "title": "Conversation ID"
          },
          "title": {
            "type": "string",
            "title": "Conversation title"
          },
          "messages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ChatMessage"
            },
            "title": "List of messages in the conversation"
          }
        }
      },
      "v1GetCouponReportResponse": {
        "type": "object",
        "properties": {
          "couponId": {
            "type": "string"
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1CouponReportRow"
            },
            "description": "One row per group and currency. Currencies are never converted or summed."
          },
          "generatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "granted": {
            "type": "string",
            "description": "Set for credit coupons. Decimal USD strings."
          },
          "consumed": {
            "type": "string"
          },
          "expired": {
            "type": "string"
          },
          "outstanding": {
            "type": "string"
          }
        }
      },
      "v1GetCreditBalanceResponse": {
        "type": "object",
        "properties": {
          "balance": {
            "type": "string",
            "title": "Decimal string: settled wallet balance in USD"
          },
          "reserved": {
            "type": "string",
            "title": "Decimal string: sum of open holds"
          },
          "available": {
            "type": "string",
            "title": "Decimal string: balance - reserved"
          },
          "frozen": {
            "type": "boolean"
          },
          "frozenReason": {
            "type": "string",
            "title": "Empty when not frozen"
          },
          "currency": {
            "type": "string",
            "title": "Always \"USD\" in v1"
          },
          "promotionalAvailable": {
            "type": "string",
            "description": "Unreserved promotional credit that can be applied to the next invoice."
          },
          "promotionalExpiringSoon": {
            "type": "string",
            "description": "Promotional credit that expires within 7 days."
          }
        }
      },
      "v1GetDashboardAssetSalesTimeseriesResponse": {
        "type": "object",
        "properties": {
          "assetsSoldPerDay": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardAssetSalesDayBucket"
            }
          }
        }
      },
      "v1GetDashboardBillingSalesResponse": {
        "type": "object",
        "properties": {
          "currency": {
            "type": "string"
          },
          "days": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardBillingSalesDayBucket"
            }
          },
          "totalFixedBillingSalesAmount": {
            "type": "string",
            "description": "Fixed = subscription + free plan lines + all add-ons; usage = usage-rated plan lines only."
          },
          "totalUsageBillingSalesAmount": {
            "type": "string"
          },
          "revenueByCustomer": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardBillingCustomerRevenue"
            }
          },
          "commercialHealth": {
            "$ref": "#/components/schemas/v1DashboardBillingCommercialHealth"
          },
          "revenueByCustomerTotalCount": {
            "type": "integer",
            "format": "int32",
            "description": "Rows matching email filter (for pagination)."
          },
          "revenueByCustomerWindowTotal": {
            "type": "integer",
            "format": "int32",
            "description": "Distinct customer orgs with revenue in the window (before email filter)."
          }
        }
      },
      "v1GetDashboardCustomerAcquisitionTimeseriesResponse": {
        "type": "object",
        "properties": {
          "buckets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardCustomerAcquisitionDayBucket"
            }
          }
        }
      },
      "v1GetDashboardSummaryResponse": {
        "type": "object",
        "properties": {
          "tickets": {
            "$ref": "#/components/schemas/v1DashboardSummaryTickets"
          },
          "byRegion": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardSummaryRegionBreakdown"
            }
          },
          "activeVmTotal": {
            "type": "integer",
            "format": "int32"
          },
          "activeCustomerTotal": {
            "type": "integer",
            "format": "int32"
          },
          "nodeTotal": {
            "type": "integer",
            "format": "int32"
          },
          "planBreakdown": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardSummaryPlanBreakdown"
            }
          },
          "addonBreakdown": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardSummaryAddonBreakdown"
            }
          }
        }
      },
      "v1GetDnsZoneResponse": {
        "type": "object",
        "properties": {
          "zone": {
            "$ref": "#/components/schemas/v1DnsZone"
          }
        }
      },
      "v1GetDomainResponse": {
        "type": "object",
        "properties": {
          "domain": {
            "$ref": "#/components/schemas/v1Domain"
          }
        }
      },
      "v1GetEnvironmentVariableResponse": {
        "type": "object",
        "properties": {
          "environmentVariable": {
            "$ref": "#/components/schemas/v1EnvironmentVariable"
          }
        }
      },
      "v1GetExchangeRateResponse": {
        "type": "object",
        "properties": {
          "exchangeRate": {
            "type": "string",
            "title": "Exchange rate from USD to the requested currency"
          },
          "currencyCode": {
            "type": "string",
            "title": "Currency code"
          },
          "lastUpdated": {
            "type": "string",
            "format": "int64",
            "title": "Timestamp when the rate was last updated"
          }
        }
      },
      "v1GetGroupResponse": {
        "type": "object",
        "properties": {
          "group": {
            "$ref": "#/components/schemas/v1Group"
          }
        }
      },
      "v1GetInvoiceResponse": {
        "type": "object",
        "properties": {
          "invoice": {
            "$ref": "#/components/schemas/v1Invoice"
          },
          "invoiceLines": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1InvoiceLine"
            }
          }
        }
      },
      "v1GetManualPayoutResponse": {
        "type": "object",
        "properties": {
          "payout": {
            "$ref": "#/components/schemas/v1ManualPayout"
          }
        }
      },
      "v1GetMarketplacePlanResponse": {
        "type": "object",
        "properties": {
          "planId": {
            "type": "string"
          },
          "planCode": {
            "type": "string"
          },
          "regionId": {
            "type": "string"
          },
          "regionCity": {
            "type": "string"
          },
          "regionCountry": {
            "type": "string"
          },
          "organizationId": {
            "type": "string"
          },
          "organizationName": {
            "type": "string"
          },
          "providerLogoUrl": {
            "type": "string"
          },
          "billingType": {
            "$ref": "#/components/schemas/v1BillingType"
          },
          "vcpus": {
            "type": "integer",
            "format": "int32"
          },
          "ramGb": {
            "type": "integer",
            "format": "int32"
          },
          "diskGb": {
            "type": "integer",
            "format": "int32"
          },
          "planPrices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PlanPrice"
            }
          },
          "planRegions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PlanRegion"
            }
          },
          "rating": {
            "type": "number",
            "format": "float"
          },
          "totalReviews": {
            "type": "integer",
            "format": "int32"
          }
        },
        "description": "Resolved marketplace offer for VM create prefill (authenticated clients)."
      },
      "v1GetMetricResponse": {
        "type": "object",
        "properties": {
          "metric": {
            "$ref": "#/components/schemas/v1Metric"
          }
        }
      },
      "v1GetMfaStatusResponse": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "factorLabel": {
            "type": "string"
          },
          "backupCodesRemaining": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1GetMyStorefrontResponse": {
        "type": "object",
        "properties": {
          "storefront": {
            "$ref": "#/components/schemas/v1MyStorefront"
          }
        }
      },
      "v1GetNetworkResponse": {
        "type": "object",
        "properties": {
          "network": {
            "$ref": "#/components/schemas/v1Network"
          }
        }
      },
      "v1GetNodeCPUMapResponse": {
        "type": "object",
        "properties": {
          "computeType": {
            "$ref": "#/components/schemas/v1NodeComputeType"
          },
          "modelName": {
            "type": "string"
          },
          "sockets": {
            "type": "integer",
            "format": "int32"
          },
          "threadsPerCore": {
            "type": "integer",
            "format": "int32"
          },
          "physicalCores": {
            "type": "integer",
            "format": "int32"
          },
          "logicalCpus": {
            "type": "integer",
            "format": "int32"
          },
          "smtEnabled": {
            "type": "boolean"
          },
          "numaNodes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1NodeCPUMapNUMA"
            }
          },
          "cpus": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1NodeCPUMapCPU"
            }
          },
          "topologyCollectedAt": {
            "type": "string",
            "description": "RFC3339 time the stored topology was collected/pasted."
          }
        }
      },
      "v1GetNodeNetworkResponse": {
        "type": "object",
        "properties": {
          "network": {
            "$ref": "#/components/schemas/v1Network"
          }
        }
      },
      "v1GetNodePlacementPolicyResponse": {
        "type": "object",
        "properties": {
          "policy": {
            "$ref": "#/components/schemas/v1NodePlacementPolicy"
          }
        }
      },
      "v1GetNodeResponse": {
        "type": "object",
        "properties": {
          "node": {
            "$ref": "#/components/schemas/v1Node"
          }
        }
      },
      "v1GetNotificationSettingResponse": {
        "type": "object",
        "properties": {
          "notificationSetting": {
            "$ref": "#/components/schemas/v1NotificationSetting"
          }
        }
      },
      "v1GetNotificationTemplateResponse": {
        "type": "object",
        "properties": {
          "notificationTemplate": {
            "$ref": "#/components/schemas/v1NotificationTemplate"
          }
        }
      },
      "v1GetOrganizationResponse": {
        "type": "object",
        "properties": {
          "organization": {
            "$ref": "#/components/schemas/v1Organization"
          }
        }
      },
      "v1GetPaymentResponse": {
        "type": "object",
        "properties": {
          "payment": {
            "$ref": "#/components/schemas/v1Payment"
          },
          "refunds": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Refund"
            },
            "title": "Refunds for this payment"
          }
        }
      },
      "v1GetPayoutConfigurationResponse": {
        "type": "object",
        "properties": {
          "configuration": {
            "$ref": "#/components/schemas/v1PayoutConfiguration"
          }
        }
      },
      "v1GetPayoutInvoiceResponse": {
        "type": "object",
        "properties": {
          "payoutInvoice": {
            "$ref": "#/components/schemas/v1PayoutInvoice"
          },
          "invoices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Invoice"
            },
            "title": "Client invoices that contributed to this payout"
          }
        }
      },
      "v1GetPlanLiveValidationResponse": {
        "type": "object",
        "properties": {
          "validation": {
            "$ref": "#/components/schemas/v1PlanLiveValidationView"
          }
        }
      },
      "v1GetPlatformResponse": {
        "type": "object",
        "properties": {
          "platform": {
            "$ref": "#/components/schemas/v1Platform"
          }
        }
      },
      "v1GetPrefixResponse": {
        "type": "object",
        "properties": {
          "prefix": {
            "$ref": "#/components/schemas/v1Prefix"
          }
        }
      },
      "v1GetPrefixUtilizationResponse": {
        "type": "object",
        "properties": {
          "totalIps": {
            "type": "integer",
            "format": "int32",
            "description": "Assignable pool: structurally assignable hosts minus explicit reserved list and one\nin-prefix gateway slot when the gateway is not already listed as reserved. Out-of-prefix\ngateways are ignored."
          },
          "allocatedCount": {
            "type": "integer",
            "format": "int32",
            "title": "Active VM IP allocations"
          },
          "reservedCount": {
            "type": "integer",
            "format": "int32",
            "title": "Len(reserved list) only; informational, not added to utilization"
          },
          "availableCount": {
            "type": "integer",
            "format": "int32",
            "title": "total_ips minus allocated_count"
          },
          "utilizationPercent": {
            "type": "number",
            "format": "double",
            "title": "allocated_count / total_ips when total_ips > 0"
          },
          "vmAssignmentPrefixLength": {
            "type": "integer",
            "format": "int32",
            "title": "IPv6 assignment length when applicable"
          },
          "capacityUnitLabel": {
            "type": "string",
            "title": "e.g. \"addresses\", \"/64 blocks\""
          },
          "capacityIsOpenEnded": {
            "type": "boolean",
            "title": "true when pool size does not fit int64"
          }
        }
      },
      "v1GetProviderCustomerBillingResponse": {
        "type": "object",
        "properties": {
          "currency": {
            "type": "string"
          },
          "paidAmount": {
            "type": "string",
            "description": "Succeeded Stripe Connect charges for this customer, or paid invoice totals without Connect."
          },
          "unpaidDueAmount": {
            "type": "string",
            "description": "Sum of amount_due for open and past_due invoices."
          },
          "cancelledAmount": {
            "type": "string",
            "description": "Sum of invoice totals with status void."
          },
          "refundedAmount": {
            "type": "string",
            "description": "Stripe refunded amounts on this customer's charges, or succeeded invoice refunds without Connect."
          },
          "collectionsAmount": {
            "type": "string",
            "description": "Sum of invoice totals with status uncollectible."
          },
          "grossRevenueAmount": {
            "type": "string",
            "description": "Same as paid_amount (gross; not net of refunds)."
          }
        },
        "description": "Billing KPIs for one client organization of the authenticated provider.\nWhen the provider has a Stripe Connect account, paid/refunded/gross are\nsucceeded direct charges for this customer. Unpaid, cancelled, and\ncollections remain invoice balances. Amounts are decimal strings with 2 places."
      },
      "v1GetProviderCustomerResponse": {
        "type": "object",
        "properties": {
          "customer": {
            "$ref": "#/components/schemas/v1ProviderCustomerRow"
          }
        }
      },
      "v1GetProviderCustomerStatsResponse": {
        "type": "object",
        "properties": {
          "activeCustomers": {
            "type": "integer",
            "format": "int32"
          },
          "inactiveCustomers": {
            "type": "integer",
            "format": "int32"
          },
          "totalActiveVms": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1GetProviderOnboardingChecklistResponse": {
        "type": "object",
        "properties": {
          "onboarded": {
            "type": "boolean",
            "description": "True when the org has completed every step at least once (persisted latch)."
          },
          "steps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ProviderOnboardingStep"
            },
            "description": "Ordered checklist; empty when onboarded is true."
          },
          "nextStep": {
            "$ref": "#/components/schemas/v1ProviderOnboardingStepCode"
          },
          "progressMessage": {
            "type": "string",
            "description": "Short copy for the wizard banner (\"You created a region. Next: create a platform.\")."
          },
          "completedCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1GetProviderResponse": {
        "type": "object",
        "properties": {
          "provider": {
            "$ref": "#/components/schemas/v1ProviderDetails"
          }
        }
      },
      "v1GetProviderRevenueResponse": {
        "type": "object",
        "properties": {
          "totalRevenue": {
            "type": "string",
            "title": "Total revenue (gross: payout amount + platform fees) - decimal string"
          },
          "totalPlatformFees": {
            "type": "string",
            "title": "Total platform fees deducted - decimal string"
          },
          "totalNetPayouts": {
            "type": "string",
            "title": "Total net payouts (payout amounts) - decimal string"
          },
          "currency": {
            "type": "string",
            "title": "Currency code (ISO 4217)"
          },
          "completedPayoutCount": {
            "type": "integer",
            "format": "int32",
            "title": "Number of completed payouts"
          },
          "pendingPayoutCount": {
            "type": "integer",
            "format": "int32",
            "title": "Number of pending/processing payouts"
          },
          "failedPayoutCount": {
            "type": "integer",
            "format": "int32",
            "title": "Number of failed payouts"
          },
          "startDate": {
            "type": "string",
            "format": "date-time",
            "title": "Start date used for calculation"
          },
          "endDate": {
            "type": "string",
            "format": "date-time",
            "title": "End date used for calculation"
          },
          "waterfall": {
            "$ref": "#/components/schemas/v1ProviderRevenueWaterfall"
          },
          "transactions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ProviderStripeTransaction"
            }
          },
          "succeededTransactionCount": {
            "type": "integer",
            "format": "int32"
          },
          "failedTransactionCount": {
            "type": "integer",
            "format": "int32"
          },
          "dataSource": {
            "type": "string",
            "title": "stripe_connect or payout_invoices"
          },
          "stripeWarning": {
            "type": "string",
            "title": "Non-fatal Stripe listing error"
          },
          "hasMoreTransactions": {
            "type": "boolean"
          },
          "settlementCurrency": {
            "type": "string"
          }
        }
      },
      "v1GetProviderTicketNotificationPolicyResponse": {
        "type": "object",
        "properties": {
          "policy": {
            "$ref": "#/components/schemas/v1ProviderTicketNotificationPolicy"
          }
        }
      },
      "v1GetPublicStorefrontResponse": {
        "type": "object",
        "properties": {
          "storefront": {
            "$ref": "#/components/schemas/v1PublicStorefront"
          }
        }
      },
      "v1GetRefundResponse": {
        "type": "object",
        "properties": {
          "refund": {
            "$ref": "#/components/schemas/v1Refund"
          },
          "payment": {
            "$ref": "#/components/schemas/v1Payment"
          },
          "invoice": {
            "$ref": "#/components/schemas/v1Invoice"
          }
        }
      },
      "v1GetRoadmapFeatureRequestResponse": {
        "type": "object",
        "properties": {
          "request": {
            "$ref": "#/components/schemas/v1RoadmapFeatureRequest"
          }
        }
      },
      "v1GetRoadmapStatsResponse": {
        "type": "object",
        "properties": {
          "totalRequests": {
            "type": "integer",
            "format": "int32"
          },
          "totalVotes": {
            "type": "integer",
            "format": "int32"
          },
          "byProduct": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1RoadmapProductStats"
            }
          }
        }
      },
      "v1GetSSHKeyResponse": {
        "type": "object",
        "properties": {
          "sshKey": {
            "$ref": "#/components/schemas/v1SSHKey"
          }
        }
      },
      "v1GetSecretResponse": {
        "type": "object",
        "properties": {
          "secret": {
            "$ref": "#/components/schemas/v1Secret"
          }
        }
      },
      "v1GetSmtpOutboundProviderPolicyResponse": {
        "type": "object",
        "properties": {
          "policy": {
            "$ref": "#/components/schemas/v1SmtpOutboundProviderPolicy"
          }
        }
      },
      "v1GetSnapshotResponse": {
        "type": "object",
        "properties": {
          "snapshot": {
            "$ref": "#/components/schemas/v1Snapshot"
          }
        }
      },
      "v1GetStartupResponse": {
        "type": "object",
        "properties": {
          "startupCommand": {
            "type": "string"
          },
          "rawStartupCommand": {
            "type": "string"
          },
          "variables": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1StartupVariable"
            }
          },
          "dockerImage": {
            "type": "string"
          },
          "dockerImages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DockerImageChoice"
            }
          }
        }
      },
      "v1GetSubscriptionCouponResponse": {
        "type": "object",
        "properties": {
          "coupon": {
            "$ref": "#/components/schemas/v1SubscriptionCoupon"
          }
        }
      },
      "v1GetSubscriptionStatusResponse": {
        "type": "object",
        "properties": {
          "rules": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Rules"
            }
          }
        }
      },
      "v1GetTicketResponse": {
        "type": "object",
        "properties": {
          "ticket": {
            "$ref": "#/components/schemas/v1Ticket"
          },
          "thread": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1TicketMessage"
            },
            "title": "All messages in chronological order (original + replies)"
          },
          "userDetails": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/v1UserDetails"
            },
            "title": "Map of user ID to user details (first_name, last_name)"
          },
          "organizationDetails": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/v1OrganizationDetails"
            },
            "title": "Map of organization ID to organization name"
          }
        }
      },
      "v1GetUsageRecordResponse": {
        "type": "object",
        "properties": {
          "usageRecord": {
            "$ref": "#/components/schemas/v1UsageRecord"
          }
        }
      },
      "v1GetUsageReportResponse": {
        "type": "object",
        "properties": {
          "aggregates": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1UsageAggregate"
            }
          },
          "billingPeriodStart": {
            "type": "string",
            "format": "date-time"
          },
          "billingPeriodEnd": {
            "type": "string",
            "format": "date-time"
          },
          "totalRecords": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1GetUserResponse": {
        "type": "object",
        "properties": {
          "user": {
            "$ref": "#/components/schemas/v1User"
          }
        }
      },
      "v1GetVMTemplateResponse": {
        "type": "object",
        "properties": {
          "vmTemplate": {
            "$ref": "#/components/schemas/v1VMTemplate"
          }
        }
      },
      "v1GetVNCConsoleResponse": {
        "type": "object",
        "properties": {
          "websocketUrl": {
            "type": "string",
            "title": "WebSocket URL for console connection (e.g., \"ws://backend/api/v1/virtual-machines/{vm_id}/console/ws\")"
          },
          "sessionId": {
            "type": "string",
            "title": "Session ID for the console connection"
          },
          "token": {
            "type": "string",
            "title": "Signed session token; frontend sends this on WS connect"
          },
          "password": {
            "type": "string",
            "title": "RFB password for noVNC credentials"
          }
        }
      },
      "v1Group": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "groupRoles": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "Relations"
          },
          "userEmails": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1HandleWebhookResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "title": "Success indicator"
          },
          "eventId": {
            "type": "string",
            "title": "Webhook event ID (for idempotency tracking)"
          },
          "message": {
            "type": "string",
            "title": "Optional message"
          }
        }
      },
      "v1HealthCheckResponse": {
        "type": "object",
        "properties": {
          "status": {
            "$ref": "#/components/schemas/v1ServingStatus"
          }
        }
      },
      "v1HeldPayout": {
        "type": "object",
        "properties": {
          "invoiceId": {
            "type": "string"
          },
          "invoiceNumber": {
            "type": "string"
          },
          "providerRevenue": {
            "type": "string",
            "description": "This provider's revenue on the invoice, as a decimal string."
          },
          "currency": {
            "type": "string"
          },
          "reason": {
            "$ref": "#/components/schemas/v1PayoutHoldReason"
          },
          "heldUntil": {
            "type": "string",
            "format": "date-time",
            "description": "Unset for dispute holds."
          },
          "paidAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "description": "A paid client invoice whose provider payout is waiting on a hold."
      },
      "v1HighRiskCoupon": {
        "type": "object",
        "properties": {
          "coupon": {
            "$ref": "#/components/schemas/v1Coupon"
          },
          "providerOrganizationId": {
            "type": "string"
          },
          "providerOrganizationName": {
            "type": "string"
          },
          "redemptionsLast7Days": {
            "type": "integer",
            "format": "int32",
            "description": "Applications in the last 7 days, excluding reversed ones."
          },
          "lastRedeemedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "description": "A high-risk coupon as seen by platform admins."
      },
      "v1HookScript": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "hook": {
            "$ref": "#/components/schemas/v1LifecycleHook"
          },
          "script": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "organizationId": {
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "subject": {
            "$ref": "#/components/schemas/v1HookSubject"
          }
        },
        "description": "HookScript is a provider-owned Python script run after a VM lifecycle event."
      },
      "v1HookSubject": {
        "type": "string",
        "enum": [
          "HOOK_SUBJECT_UNSPECIFIED",
          "HOOK_SUBJECT_VM",
          "HOOK_SUBJECT_GAMESERVER"
        ],
        "default": "HOOK_SUBJECT_UNSPECIFIED",
        "description": "LifecycleHook is the VM operation that triggers a provider hook script."
      },
      "v1IPAllocation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "ipAddress": {
            "type": "string",
            "title": "IP address allocated (e.g., 10.0.0.5, 2001:db8::1)"
          },
          "status": {
            "$ref": "#/components/schemas/v1IPAllocationStatus"
          },
          "prefixId": {
            "type": "string",
            "description": "Prefix this IP allocation is from",
            "title": "Relations"
          },
          "virtualMachineId": {
            "type": "string",
            "title": "Virtual machine this IP is allocated to"
          },
          "organizationId": {
            "type": "string",
            "title": "Organization that owns this allocation"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "allocatedCidr": {
            "type": "string",
            "title": "Allocated CIDR (host or delegated block)"
          },
          "allocationKind": {
            "type": "string",
            "title": "ipv4_host, ipv6_host, ipv6_prefix"
          }
        }
      },
      "v1IPAllocationStatus": {
        "type": "string",
        "enum": [
          "IP_ALLOCATION_STATUS_UNSPECIFIED",
          "IP_ALLOCATION_STATUS_ACTIVE",
          "IP_ALLOCATION_STATUS_RELEASED"
        ],
        "default": "IP_ALLOCATION_STATUS_UNSPECIFIED"
      },
      "v1ImportGameServerTemplateRequest": {
        "type": "object",
        "properties": {
          "platformId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "nestId": {
            "type": "integer",
            "format": "int32"
          },
          "eggId": {
            "type": "integer",
            "format": "int32"
          },
          "icon": {
            "type": "string"
          },
          "startup": {
            "type": "string"
          },
          "dockerImage": {
            "type": "string"
          }
        }
      },
      "v1InboundPeeringState": {
        "type": "string",
        "enum": [
          "INBOUND_PEERING_STATE_UNSPECIFIED",
          "INBOUND_PEERING_STATE_PENDING",
          "INBOUND_PEERING_STATE_PEERING",
          "INBOUND_PEERING_STATE_READY",
          "INBOUND_PEERING_STATE_FAILED"
        ],
        "default": "INBOUND_PEERING_STATE_UNSPECIFIED"
      },
      "v1InstantApp": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true
          },
          "slug": {
            "type": "string",
            "readOnly": true
          },
          "name": {
            "type": "string",
            "readOnly": true
          },
          "description": {
            "type": "string",
            "readOnly": true
          },
          "version": {
            "type": "string",
            "readOnly": true
          },
          "family": {
            "type": "string",
            "readOnly": true
          },
          "distro": {
            "$ref": "#/components/schemas/v1Distro"
          },
          "iconUrl": {
            "type": "string",
            "readOnly": true
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "readOnly": true
          },
          "minVcpus": {
            "type": "integer",
            "format": "int32",
            "description": "Recommended minimums (plan specifications units); not enforced at create.",
            "readOnly": true
          },
          "minRamGb": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          },
          "minDiskGb": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          },
          "documentationUrl": {
            "type": "string",
            "readOnly": true
          },
          "metadata": {
            "type": "object",
            "description": "Includes ports, credentials_path, estimated_ready_minutes, and optional variables[]\n(Instant App form schema: name/label/type/required/default/…).",
            "readOnly": true
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "userData": {
            "type": "string",
            "description": "Jinja cloud-init user_data template. Present on Get; omitted on List.",
            "readOnly": true
          }
        },
        "description": "InstantApp is a platform-owned curated app install (Jinja user_data bound to a Distro).\nuser_data is returned on Get for catalog preview; List omits it to keep responses small.\nCreate/reinstall always load user_data server-side from storage."
      },
      "v1Invite": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "inviteeEmail": {
            "type": "string"
          },
          "inviteStatus": {
            "$ref": "#/components/schemas/v1InviteStatus"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "joinedTime": {
            "type": "string",
            "format": "date-time"
          },
          "inviter": {
            "type": "string",
            "title": "Relations"
          },
          "organization": {
            "type": "string"
          },
          "group": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "inviterEmail": {
            "type": "string",
            "title": "Display fields"
          },
          "organizationName": {
            "type": "string"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1InviteStatus": {
        "type": "string",
        "enum": [
          "INVITE_STATUS_UNSPECIFIED",
          "INVITE_STATUS_SENT",
          "INVITE_STATUS_ACCEPTED",
          "INVITE_STATUS_DECLINED",
          "INVITE_STATUS_EXPIRED"
        ],
        "default": "INVITE_STATUS_UNSPECIFIED"
      },
      "v1Invoice": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "invoiceNumber": {
            "type": "string"
          },
          "subscriptionId": {
            "type": "string",
            "title": "Deprecated: Use subscription_ids instead. Kept"
          },
          "subscriptionIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "for backward compatibility.\n\nSubscriptions aggregated into this invoice (many-to-many)"
          },
          "periodStart": {
            "type": "string",
            "format": "date-time"
          },
          "periodEnd": {
            "type": "string",
            "format": "date-time"
          },
          "dueDate": {
            "type": "string",
            "format": "date-time"
          },
          "paidAt": {
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "$ref": "#/components/schemas/v1InvoiceStatus"
          },
          "currency": {
            "type": "string"
          },
          "subtotal": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "taxAmount": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "total": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "amountDue": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "transactionId": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "metadata": {
            "type": "object",
            "title": "Optional: custom metadata (platform fee info for providers, etc.)"
          },
          "issuer": {
            "$ref": "#/components/schemas/v1InvoiceParty"
          },
          "customer": {
            "$ref": "#/components/schemas/v1InvoiceParty"
          }
        }
      },
      "v1InvoiceLine": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "invoiceId": {
            "type": "string"
          },
          "subscriptionId": {
            "type": "string",
            "title": "Subscription this invoice line is for"
          },
          "description": {
            "type": "string",
            "title": "(direct link for better tracking)"
          },
          "quantity": {
            "type": "string",
            "title": "Decimal as string"
          },
          "unitAmount": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "amount": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          }
        }
      },
      "v1InvoiceParty": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "Display/trading name"
          },
          "legalName": {
            "type": "string",
            "title": "Registered legal entity name, when different from name"
          },
          "taxId": {
            "type": "string"
          },
          "vatId": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "phone": {
            "type": "string"
          },
          "addressLine1": {
            "type": "string"
          },
          "addressLine2": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "region": {
            "type": "string"
          },
          "postalCode": {
            "type": "string"
          },
          "country": {
            "type": "string",
            "title": "ISO 3166-1 alpha-2"
          },
          "address": {
            "type": "string",
            "title": "Single-line address fallback"
          },
          "website": {
            "type": "string"
          },
          "isPlatform": {
            "type": "boolean",
            "title": "True when the party is the platform itself"
          }
        },
        "description": "InvoiceParty is a billing party (seller/issuer or buyer/customer) shown on an\ninvoice. Provider/customer identity is snapshotted at invoice generation; the\nplatform issuer is resolved from server config."
      },
      "v1InvoiceStatus": {
        "type": "string",
        "enum": [
          "INVOICE_STATUS_UNSPECIFIED",
          "INVOICE_STATUS_DRAFT",
          "INVOICE_STATUS_OPEN",
          "INVOICE_STATUS_PAID",
          "INVOICE_STATUS_PAST_DUE",
          "INVOICE_STATUS_VOID",
          "INVOICE_STATUS_UNCOLLECTIBLE"
        ],
        "default": "INVOICE_STATUS_UNSPECIFIED",
        "title": "Invoice messages"
      },
      "v1LastRestore": {
        "type": "object",
        "properties": {
          "snapshotName": {
            "type": "string",
            "readOnly": true
          },
          "restoredAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "restoredBy": {
            "type": "string",
            "readOnly": true
          }
        },
        "title": "LastRestore represents the last restore operation for a snapshot"
      },
      "v1LifecycleHook": {
        "type": "string",
        "enum": [
          "LIFECYCLE_HOOK_UNSPECIFIED",
          "LIFECYCLE_HOOK_CREATED",
          "LIFECYCLE_HOOK_STARTED",
          "LIFECYCLE_HOOK_STOPPED",
          "LIFECYCLE_HOOK_DELETED",
          "LIFECYCLE_HOOK_RESTARTED",
          "LIFECYCLE_HOOK_REINSTALLED"
        ],
        "default": "LIFECYCLE_HOOK_UNSPECIFIED"
      },
      "v1LinkedIdentity": {
        "type": "object",
        "properties": {
          "provider": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "createTime": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "v1ListAddonSubscriptionsResponse": {
        "type": "object",
        "properties": {
          "addonSubscriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1AddonSubscription"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListAddonsResponse": {
        "type": "object",
        "properties": {
          "addons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Addon"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListAgentsResponse": {
        "type": "object",
        "properties": {
          "agents": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1GetAgentResponse"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListAllocationsResponse": {
        "type": "object",
        "properties": {
          "allocations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1IPAllocation"
            }
          },
          "total": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListAssignableNodesForPlanResponse": {
        "type": "object",
        "properties": {
          "nodes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1AssignableNodeView"
            }
          }
        }
      },
      "v1ListAvailableAddonsResponse": {
        "type": "object",
        "properties": {
          "addons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Addon"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListAvailableIPsResponse": {
        "type": "object",
        "properties": {
          "availableIps": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "List of available IP addresses"
          },
          "totalIps": {
            "type": "integer",
            "format": "int32",
            "title": "Total IPs in prefix"
          },
          "allocatedCount": {
            "type": "integer",
            "format": "int32",
            "title": "Number of allocated IPs"
          },
          "reservedCount": {
            "type": "integer",
            "format": "int32",
            "title": "Number of reserved IPs"
          },
          "availableCount": {
            "type": "integer",
            "format": "int32",
            "title": "Number of available IPs"
          }
        }
      },
      "v1ListAvailablePlansResponse": {
        "type": "object",
        "properties": {
          "plans": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1AvailablePlanCode"
            },
            "title": "List of unique plan codes with their details"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32",
            "title": "Total number of unique plan codes"
          }
        }
      },
      "v1ListAvailableRegionsResponse": {
        "type": "object",
        "properties": {
          "regions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1RegionLocation"
            },
            "title": "List of unique city+country combinations"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32",
            "title": "Total number of unique regions"
          }
        }
      },
      "v1ListBackupsResponse": {
        "type": "object",
        "properties": {
          "backups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Backup"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListClientProviderReviewAssetsResponse": {
        "type": "object",
        "properties": {
          "assets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ClientProviderReviewAssetItem"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "reviewedAssetCount": {
            "type": "integer",
            "format": "int32",
            "description": "Submitted reviews across all assets (not just this page)."
          }
        }
      },
      "v1ListCloudInitTemplatesResponse": {
        "type": "object",
        "properties": {
          "cloudInitTemplates": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1CloudInitTemplate"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListCloudInitUserDataResponse": {
        "type": "object",
        "properties": {
          "profiles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1CloudInitUserData"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListConnectTaxRegistrationsResponse": {
        "type": "object",
        "properties": {
          "registrations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ConnectTaxRegistration"
            }
          }
        }
      },
      "v1ListConversationsResponse": {
        "type": "object",
        "properties": {
          "conversations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ConversationInfo"
            },
            "title": "List of conversations with IDs and titles"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32",
            "title": "Total number of conversations"
          }
        }
      },
      "v1ListCountriesCitiesResponse": {
        "type": "object",
        "properties": {
          "countries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Country"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListCouponCodeBatchesResponse": {
        "type": "object",
        "properties": {
          "batches": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1CouponCodeBatch"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListCouponCodesResponse": {
        "type": "object",
        "properties": {
          "codes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1CouponCode"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListCouponRedemptionsResponse": {
        "type": "object",
        "properties": {
          "redemptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1CouponRedemption"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListCouponsResponse": {
        "type": "object",
        "properties": {
          "coupons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Coupon"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListCreditLedgerEntriesResponse": {
        "type": "object",
        "properties": {
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1CreditLedgerEntryProto"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListDashboardAddonCatalogStatsResponse": {
        "type": "object",
        "properties": {
          "addonCatalog": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ProviderDashboardAddonCatalogRow"
            }
          },
          "addonCatalogFilteredTotal": {
            "type": "integer",
            "format": "int32"
          },
          "kpiActiveAddonSubscriptionsSum": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListDashboardInfrastructureResponse": {
        "type": "object",
        "properties": {
          "byNode": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ProviderDashboardNodeRollup"
            }
          },
          "nodeTotalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListDashboardIpamAssignmentsResponse": {
        "type": "object",
        "properties": {
          "assignments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardIpamAssignmentRow"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListDashboardIpamResponse": {
        "type": "object",
        "properties": {
          "networks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardIpamNetworkRollup"
            }
          },
          "allocatedSampleIpsHasMore": {
            "type": "boolean"
          }
        }
      },
      "v1ListDashboardPlanSubscriptionStatsResponse": {
        "type": "object",
        "properties": {
          "plans": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ProviderDashboardPlanSubscriptionStat"
            }
          },
          "kpiPlanCount": {
            "type": "integer",
            "format": "int32"
          },
          "kpiActiveSubscriptionsSum": {
            "type": "integer",
            "format": "int32"
          },
          "kpiVmAssetsSum": {
            "type": "integer",
            "format": "int32"
          },
          "plansFilteredTotal": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListDashboardTicketStatisticsResponse": {
        "type": "object",
        "properties": {
          "totalTickets": {
            "type": "integer",
            "format": "int32"
          },
          "openTickets": {
            "type": "integer",
            "format": "int32"
          },
          "closedTickets": {
            "type": "integer",
            "format": "int32"
          },
          "byStatus": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardTicketStatisticsByStatus"
            }
          },
          "byCaseType": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardTicketStatisticsByCaseType"
            }
          },
          "byPriority": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardTicketStatisticsByPriority"
            }
          },
          "averageFirstResponseTimeSeconds": {
            "type": "string",
            "format": "int64"
          },
          "averageResolutionTimeSeconds": {
            "type": "string",
            "format": "int64"
          },
          "slaFirstResponseBreachedTickets": {
            "type": "integer",
            "format": "int32"
          },
          "slaResolutionBreachedTickets": {
            "type": "integer",
            "format": "int32",
            "description": "Deprecated: ticket SLA is first-response only. Always 0; kept for wire compatibility."
          },
          "slaCompliantTickets": {
            "type": "integer",
            "format": "int32"
          },
          "ticketsCreatedPerDay": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardTicketStatisticsDayBucket"
            }
          },
          "awaitingReplyTickets": {
            "type": "integer",
            "format": "int32"
          },
          "openNeedingProviderFirstResponse": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListDashboardVirtualMachinesResponse": {
        "type": "object",
        "properties": {
          "dashboardVmCountTotal": {
            "type": "integer",
            "format": "int32"
          },
          "virtualMachines": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DashboardVirtualMachineRow"
            }
          },
          "vmtemplateIdsWithVirtualMachines": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Distinct VM template IDs with at least one provider-scoped dashboard VM (unfiltered facet for sidebar)."
          }
        }
      },
      "v1ListDatabasesResponse": {
        "type": "object",
        "properties": {
          "databases": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1GameServerDatabase"
            }
          }
        }
      },
      "v1ListDatacentersResponse": {
        "type": "object",
        "properties": {
          "datacenters": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DatacenterInfo"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListDistrosResponse": {
        "type": "object",
        "properties": {
          "distros": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DistroCatalogEntry"
            }
          }
        },
        "description": "ListDistrosResponse is the guest OS catalog."
      },
      "v1ListDnsGeoLocationsResponse": {
        "type": "object",
        "properties": {
          "locations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DnsGeoLocation"
            }
          }
        }
      },
      "v1ListDnsGeoRecordsResponse": {
        "type": "object",
        "properties": {
          "records": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DnsGeoRecord"
            }
          }
        }
      },
      "v1ListDnsRecordsResponse": {
        "type": "object",
        "properties": {
          "records": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DnsRecord"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "types": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1ListDnsZonesResponse": {
        "type": "object",
        "properties": {
          "zones": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DnsZone"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListEffectivePermissionsResponse": {
        "type": "object",
        "properties": {
          "effectivePermissions": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/v1EffectivePermissions"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListEligibleNodesForPlanResponse": {
        "type": "object",
        "properties": {
          "nodes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PlanLiveValidationNodeView"
            }
          }
        }
      },
      "v1ListEnvironmentVariablesResponse": {
        "type": "object",
        "properties": {
          "environmentVariables": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1EnvironmentVariable"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListFilesResponse": {
        "type": "object",
        "properties": {
          "files": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1GameServerFile"
            }
          }
        }
      },
      "v1ListFirewallAddressGroupsResponse": {
        "type": "object",
        "properties": {
          "groups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1FirewallAddressGroup"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListFirewallRuleSetsResponse": {
        "type": "object",
        "properties": {
          "rulesets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1FirewallRuleSet"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListFirewallRulesResponse": {
        "type": "object",
        "properties": {
          "rules": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1FirewallRuleResource"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListGameServerAllocationsResponse": {
        "type": "object",
        "properties": {
          "allocations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1GameServerAllocation"
            }
          }
        }
      },
      "v1ListGameServerBackupsResponse": {
        "type": "object",
        "properties": {
          "backups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1GameServerBackup"
            }
          }
        }
      },
      "v1ListGameServerTemplatesResponse": {
        "type": "object",
        "properties": {
          "templates": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1GameServerTemplate"
            }
          }
        }
      },
      "v1ListGameServersResponse": {
        "type": "object",
        "properties": {
          "gameServers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1GameServer"
            }
          }
        }
      },
      "v1ListGroupsResponse": {
        "type": "object",
        "properties": {
          "groups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Group"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListHeldPayoutsResponse": {
        "type": "object",
        "properties": {
          "heldPayouts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1HeldPayout"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListHighRiskCouponsResponse": {
        "type": "object",
        "properties": {
          "coupons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1HighRiskCoupon"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListHookScriptsResponse": {
        "type": "object",
        "properties": {
          "hookScripts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1HookScript"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListInstantAppsResponse": {
        "type": "object",
        "properties": {
          "instantApps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1InstantApp"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListInternalCommentsResponse": {
        "type": "object",
        "properties": {
          "comments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1TicketInternalComment"
            }
          }
        }
      },
      "v1ListInvitesResponse": {
        "type": "object",
        "properties": {
          "invites": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Invite"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListInvoicesResponse": {
        "type": "object",
        "properties": {
          "invoices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Invoice"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListLinkedIdentitiesResponse": {
        "type": "object",
        "properties": {
          "identities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1LinkedIdentity"
            }
          },
          "hasPassword": {
            "type": "boolean",
            "description": "True when the user has a local password (can unlink their last SSO identity)."
          },
          "ssoRegistered": {
            "type": "boolean",
            "description": "True when the account was created by SSO sign-up.\nPassword set, change, and recovery stay disabled for that account."
          }
        }
      },
      "v1ListMarketplaceProviderDirectoryResponse": {
        "type": "object",
        "properties": {
          "providers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ProviderInfo"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListMetricsResponse": {
        "type": "object",
        "properties": {
          "metrics": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Metric"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListMetricsWriteCredentialsResponse": {
        "type": "object",
        "properties": {
          "credentials": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1MetricsWriteCredential"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListMyInvitesResponse": {
        "type": "object",
        "properties": {
          "invites": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Invite"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListNetworkNodesResponse": {
        "type": "object",
        "properties": {
          "nodes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Node"
            },
            "title": "List of nodes assigned to this network"
          }
        }
      },
      "v1ListNetworksResponse": {
        "type": "object",
        "properties": {
          "networks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Network"
            }
          },
          "total": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListNodesResponse": {
        "type": "object",
        "properties": {
          "nodes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1NodeWithExpandedRegion"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListNotificationSettingsResponse": {
        "type": "object",
        "properties": {
          "notificationSettings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1NotificationSetting"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListNotificationTemplatesResponse": {
        "type": "object",
        "properties": {
          "notificationTemplates": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1NotificationTemplate"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListOAuth2ClientsResponse": {
        "type": "object",
        "properties": {
          "clients": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1OAuth2Client"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListOrderGamesResponse": {
        "type": "object",
        "properties": {
          "games": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1OrderGame"
            }
          }
        }
      },
      "v1ListOrganizationsResponse": {
        "type": "object",
        "properties": {
          "organizations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Organization"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListPaymentMethodsResponse": {
        "type": "object",
        "properties": {
          "paymentMethods": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PaymentMethod"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListPaymentsResponse": {
        "type": "object",
        "properties": {
          "payments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Payment"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListPayoutInvoicesResponse": {
        "type": "object",
        "properties": {
          "payoutInvoices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PayoutInvoice"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListPermissionsResponse": {
        "type": "object",
        "properties": {
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Permission"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListPlanLiveValidationBenchmarksResponse": {
        "type": "object",
        "properties": {
          "benchmarks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PlanLiveValidationBenchmarkView"
            }
          }
        }
      },
      "v1ListPlanLiveValidationsResponse": {
        "type": "object",
        "properties": {
          "validations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PlanLiveValidationView"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListPlansResponse": {
        "type": "object",
        "properties": {
          "plans": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Plan"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListPlatformsResponse": {
        "type": "object",
        "properties": {
          "platforms": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Platform"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListPrefixesResponse": {
        "type": "object",
        "properties": {
          "prefixes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Prefix"
            }
          },
          "total": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListPreflightChecksResponse": {
        "type": "object",
        "properties": {
          "plans": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PlanPreflightView"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "marketplaceReadyCheckIntervalSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Resolved from preflight.PLAN_MARKETPLACE_READY interval (seconds); for UI scheduling hints."
          },
          "marketplaceReadyCheckEnabled": {
            "type": "boolean",
            "description": "Explicit presence: false when PLAN_MARKETPLACE_READY is disabled in config (interval may be omitted as 0)."
          }
        }
      },
      "v1ListPromoCreditGrantsResponse": {
        "type": "object",
        "properties": {
          "grants": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PromoCreditGrant"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListProviderCustomerAssetsResponse": {
        "type": "object",
        "properties": {
          "assets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ProviderCustomerAssetRow"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListProviderCustomersResponse": {
        "type": "object",
        "properties": {
          "customers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ProviderCustomerRow"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListProviderReviewsResponse": {
        "type": "object",
        "properties": {
          "reviews": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ProviderReviewListItem"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32",
            "title": "total matching current filters"
          },
          "providerTotalReviews": {
            "type": "integer",
            "format": "int32",
            "title": "all reviews for this provider"
          },
          "providerAverageStar": {
            "type": "number",
            "format": "double",
            "title": "all reviews for this provider"
          },
          "providerStarSummary": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ProviderReviewStarSummary"
            }
          }
        }
      },
      "v1ListProvidersResponse": {
        "type": "object",
        "properties": {
          "providers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ProviderInfo"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListPublicStorefrontsResponse": {
        "type": "object",
        "properties": {
          "storefronts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PublicStorefrontCard"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListRefundsResponse": {
        "type": "object",
        "properties": {
          "refunds": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Refund"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListRegionsResponse": {
        "type": "object",
        "properties": {
          "regions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Region"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListRoadmapFeatureRequestCommentsResponse": {
        "type": "object",
        "properties": {
          "comments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1RoadmapFeatureRequestComment"
            }
          },
          "total": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListRoadmapFeatureRequestsResponse": {
        "type": "object",
        "properties": {
          "requests": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1RoadmapFeatureRequest"
            }
          },
          "total": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListRoadmapProductCategoriesResponse": {
        "type": "object",
        "properties": {
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1RoadmapProductCategory"
            }
          }
        }
      },
      "v1ListRolesResponse": {
        "type": "object",
        "properties": {
          "roles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Role"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListSSHKeysResponse": {
        "type": "object",
        "properties": {
          "sshKeys": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1SSHKey"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListSchedulesResponse": {
        "type": "object",
        "properties": {
          "schedules": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1GameServerSchedule"
            }
          }
        }
      },
      "v1ListSecretsResponse": {
        "type": "object",
        "properties": {
          "secrets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Secret"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListServiceAccountTokensResponse": {
        "type": "object",
        "properties": {
          "tokens": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ServiceAccountTokenInfo"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListServiceAccountsResponse": {
        "type": "object",
        "properties": {
          "serviceAccounts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ServiceAccountResponse"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListSnapshotsResponse": {
        "type": "object",
        "properties": {
          "snapshots": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Snapshot"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListSubscriptionsResponse": {
        "type": "object",
        "properties": {
          "subscriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Subscription"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListSupportedCurrenciesResponse": {
        "type": "object",
        "properties": {
          "currencies": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "List of supported currency codes"
          },
          "lastUpdated": {
            "type": "string",
            "format": "int64",
            "title": "Timestamp when rates were last updated"
          }
        }
      },
      "v1ListTicketAttachmentsResponse": {
        "type": "object",
        "properties": {
          "attachments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1TicketAttachment"
            }
          }
        }
      },
      "v1ListTicketTemplatesResponse": {
        "type": "object",
        "properties": {
          "ticketTemplates": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1TicketTemplate"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "availableVariables": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1TicketTemplateVariableDefinition"
            }
          }
        }
      },
      "v1ListTicketsResponse": {
        "type": "object",
        "properties": {
          "tickets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Ticket"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "userDetails": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/v1UserDetails"
            },
            "title": "Map of user ID to user details (first_name, last_name)"
          },
          "organizationDetails": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/v1OrganizationDetails"
            },
            "title": "Map of organization ID to organization name"
          }
        }
      },
      "v1ListUsageRecordsResponse": {
        "type": "object",
        "properties": {
          "usageRecords": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1UsageRecord"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListUsersResponse": {
        "type": "object",
        "properties": {
          "users": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1User"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListVMTagsResponse": {
        "type": "object",
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "List of unique tags from all VMs belonging to the organization"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32",
            "title": "Total number of unique tags"
          }
        }
      },
      "v1ListVMTemplatesResponse": {
        "type": "object",
        "properties": {
          "vmTemplates": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1VMTemplate"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32",
            "description": "Page count when pagination packs whole node groups (never splits a node across pages)."
          }
        }
      },
      "v1ListVirtualMachineSmtpOutboundPoliciesResponse": {
        "type": "object",
        "properties": {
          "policies": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1VirtualMachineSmtpOutboundPolicyView"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ListVirtualMachinesResponse": {
        "type": "object",
        "properties": {
          "virtualMachines": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1VirtualMachine"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1LiveValidationCheckView": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "passed": {
            "type": "boolean"
          },
          "note": {
            "type": "string"
          }
        }
      },
      "v1LoginMfaVerifyRequest": {
        "type": "object",
        "properties": {
          "loginSessionId": {
            "type": "string"
          },
          "code": {
            "type": "string",
            "description": "Authenticator TOTP code or a one-time recovery code."
          }
        }
      },
      "v1LoginRequest": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string"
          },
          "password": {
            "type": "string"
          },
          "turnstileToken": {
            "type": "string",
            "description": "Cloudflare Turnstile token from the client widget (optional unless auth.turnstile is enabled)."
          }
        }
      },
      "v1LoginResponse": {
        "type": "object",
        "properties": {
          "token": {
            "type": "string",
            "description": "Present when MFA is not required (or after LoginMfaVerify succeeds)."
          },
          "organizationId": {
            "type": "string"
          },
          "mfaRequired": {
            "type": "boolean",
            "description": "When true, token/organization_id are empty and login_session_id must be used with LoginMfaVerify."
          },
          "loginSessionId": {
            "type": "string"
          }
        }
      },
      "v1LogoutRequest": {
        "type": "object",
        "properties": {
          "invalidateAll": {
            "type": "boolean"
          }
        }
      },
      "v1ManualPayout": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Manual payout account ID"
          },
          "country": {
            "type": "string",
            "title": "ISO 3166-1 alpha-2 country code"
          },
          "iban": {
            "type": "string",
            "title": "International Bank Account Number (for SEPA countries)"
          },
          "bic": {
            "type": "string",
            "title": "Bank Identifier Code / SWIFT code (for SEPA countries)"
          },
          "accountNumber": {
            "type": "string",
            "title": "Bank account number (for non-SEPA countries)"
          },
          "routingNumber": {
            "type": "string",
            "title": "Routing number (for US accounts) or sort code (for UK accounts)"
          },
          "accountHolderName": {
            "type": "string",
            "title": "Name of the account holder"
          },
          "bankName": {
            "type": "string",
            "title": "Name of the bank"
          },
          "isVerified": {
            "type": "boolean",
            "title": "Whether the payout account has been verified by admin"
          },
          "verificationNotes": {
            "type": "string",
            "title": "Admin notes about verification status"
          },
          "notes": {
            "type": "string",
            "title": "User-provided notes about the payout account"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Account creation timestamp"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Last update timestamp"
          }
        }
      },
      "v1MarketplaceSearchParsedQuery": {
        "type": "object",
        "properties": {
          "filterCity": {
            "type": "string"
          },
          "filterCountry": {
            "type": "string"
          },
          "filterPlanCode": {
            "type": "string"
          },
          "minVcpus": {
            "type": "integer",
            "format": "int32"
          },
          "minRamGb": {
            "type": "integer",
            "format": "int32"
          },
          "minDiskGb": {
            "type": "integer",
            "format": "int32"
          },
          "filterBillingType": {
            "$ref": "#/components/schemas/v1BillingType"
          },
          "filterComputeType": {
            "$ref": "#/components/schemas/v1ComputeType"
          },
          "filterComputeCategory": {
            "$ref": "#/components/schemas/v1ComputeCategory"
          },
          "matchedTerms": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "parser": {
            "type": "string",
            "description": "Parser implementation id, e.g. \"word_matcher\" or future \"llm\"."
          }
        },
        "description": "Structured filters extracted from the user query (word matcher today; LLM later)."
      },
      "v1MarketplaceSearchPlanPriceSummary": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "unitAmount": {
            "type": "string"
          },
          "unitName": {
            "type": "string"
          },
          "billingPeriod": {
            "$ref": "#/components/schemas/v1BillingPeriod"
          },
          "pricingModel": {
            "$ref": "#/components/schemas/v1PricingModel"
          },
          "metricName": {
            "type": "string"
          },
          "productType": {
            "$ref": "#/components/schemas/v1ProductType"
          },
          "metadata": {
            "type": "object"
          },
          "freeUnits": {
            "type": "integer",
            "format": "int32",
            "description": "Included free units (e.g. bandwidth GB). Used for bandwidth summaries in search."
          },
          "overagePrice": {
            "type": "string",
            "description": "Overage unit price as decimal string (same precision as PlanPrice.overage_price)."
          },
          "pricingFormula": {
            "type": "object",
            "description": "Percentage / formula pricing for add-ons (e.g. backup = % of VM price)."
          }
        }
      },
      "v1MarketplaceSearchResult": {
        "type": "object",
        "properties": {
          "organizationId": {
            "type": "string"
          },
          "organizationName": {
            "type": "string"
          },
          "providerLogoUrl": {
            "type": "string"
          },
          "planId": {
            "type": "string"
          },
          "planCode": {
            "type": "string"
          },
          "vcpus": {
            "type": "integer",
            "format": "int32"
          },
          "ramGb": {
            "type": "integer",
            "format": "int32"
          },
          "diskGb": {
            "type": "integer",
            "format": "int32"
          },
          "regionCity": {
            "type": "string"
          },
          "regionCountry": {
            "type": "string"
          },
          "billingType": {
            "$ref": "#/components/schemas/v1BillingType"
          },
          "planPrice": {
            "$ref": "#/components/schemas/v1MarketplaceSearchPlanPriceSummary"
          },
          "addonPrices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1MarketplaceSearchPlanPriceSummary"
            }
          },
          "rating": {
            "type": "number",
            "format": "float"
          },
          "totalReviews": {
            "type": "integer",
            "format": "int32"
          },
          "regionId": {
            "type": "string",
            "title": "Region UUID for this offer (one plan = one region after plan-model change)"
          },
          "ddosProvider": {
            "type": "string"
          },
          "bandwidthPrices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1MarketplaceSearchPlanPriceSummary"
            },
            "description": "Bandwidth plan prices (egress/ingress) with free units + overage for search UI."
          }
        }
      },
      "v1Metadata": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "versionDetails": {
            "type": "string"
          },
          "buildDate": {
            "type": "string"
          },
          "buildCommit": {
            "type": "string"
          },
          "buildBranch": {
            "type": "string"
          },
          "buildTag": {
            "type": "string"
          }
        }
      },
      "v1Metric": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "name": {
            "type": "string",
            "title": "Metric identification"
          },
          "code": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "metricType": {
            "$ref": "#/components/schemas/v1MetricType"
          },
          "aggregationType": {
            "$ref": "#/components/schemas/v1AggregationType"
          },
          "unit": {
            "type": "string"
          },
          "unitPlural": {
            "type": "string"
          },
          "billable": {
            "type": "boolean",
            "title": "Billing configuration"
          },
          "recurring": {
            "type": "boolean"
          },
          "retentionDays": {
            "type": "integer",
            "format": "int32"
          },
          "externalId": {
            "type": "string",
            "title": "External integration"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1MetricAggregation": {
        "type": "string",
        "enum": [
          "METRIC_AGGREGATION_UNSPECIFIED",
          "METRIC_AGGREGATION_SUM",
          "METRIC_AGGREGATION_MAX",
          "METRIC_AGGREGATION_LAST_DURING_PERIOD",
          "METRIC_AGGREGATION_COUNT"
        ],
        "default": "METRIC_AGGREGATION_UNSPECIFIED"
      },
      "v1MetricType": {
        "type": "string",
        "enum": [
          "METRIC_TYPE_UNSPECIFIED",
          "METRIC_TYPE_COUNTER",
          "METRIC_TYPE_GAUGE",
          "METRIC_TYPE_HISTOGRAM",
          "METRIC_TYPE_SUMMARY"
        ],
        "default": "METRIC_TYPE_UNSPECIFIED"
      },
      "v1MetricsWriteCredential": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "publicId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "agentId": {
            "type": "string"
          },
          "organizationId": {
            "type": "string"
          },
          "createTime": {
            "type": "string",
            "format": "date-time"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "revokedAt": {
            "type": "string",
            "format": "date-time"
          },
          "lastUsedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "v1MoneyAmount": {
        "type": "object",
        "properties": {
          "amount": {
            "type": "string",
            "title": "Decimal string, e.g. \"11.00\""
          },
          "currency": {
            "type": "string",
            "title": "ISO 4217 currency code"
          }
        }
      },
      "v1MyStorefront": {
        "type": "object",
        "properties": {
          "optedIn": {
            "type": "boolean"
          },
          "unpublishedByOps": {
            "type": "boolean"
          },
          "liveSlug": {
            "type": "string"
          },
          "participationStatus": {
            "$ref": "#/components/schemas/v1StorefrontParticipationStatus"
          },
          "liveRevision": {
            "$ref": "#/components/schemas/v1StorefrontRevision"
          },
          "workingRevision": {
            "$ref": "#/components/schemas/v1StorefrontRevision"
          },
          "suggestedSlug": {
            "type": "string"
          },
          "slugLocked": {
            "type": "boolean"
          },
          "highlightAllowlist": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1Network": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "dnsServers": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "DNS server IP addresses (e.g., [\"8.8.8.8\", \"1.1.1.1\"])"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "organizationId": {
            "type": "string",
            "title": "Relations"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "nodes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1NetworkNode"
            },
            "title": "Nodes connected to this network (only populated in ListNetworks response)"
          },
          "macAddressPrefix": {
            "type": "string",
            "description": "First 3 octets for MAC allocation within this network (e.g. BC:24:11). Default: BC:24:11."
          }
        }
      },
      "v1NetworkNode": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "title": "NetworkNode represents a node connected to a network (simplified info)"
      },
      "v1Node": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Identification"
          },
          "name": {
            "type": "string"
          },
          "serviceStatus": {
            "$ref": "#/components/schemas/v1ServiceStatus"
          },
          "platform": {
            "type": "string",
            "title": "Relations"
          },
          "region": {
            "type": "string"
          },
          "organizationId": {
            "type": "string"
          },
          "inventory": {
            "$ref": "#/components/schemas/v1NodeInventory"
          },
          "cpuOverallocatePercent": {
            "type": "integer",
            "format": "int32",
            "title": "Overallocation"
          },
          "memoryOverallocatePercent": {
            "type": "integer",
            "format": "int32"
          },
          "storageOverallocatePercent": {
            "type": "integer",
            "format": "int32"
          },
          "networkId": {
            "type": "string",
            "description": "Network ID this node is assigned to (optional)",
            "title": "Network assignment (IPAM)"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "maintenanceMode": {
            "type": "boolean",
            "title": "Maintenance mode - when enabled, reconciliation loop skips Proxmox state checks"
          },
          "vmidSeed": {
            "type": "integer",
            "format": "int32",
            "title": "VM ID seed - starting point for VM ID generation on this node"
          },
          "vmStorageDestination": {
            "type": "string",
            "description": "Proxmox storage ID for new VM root disks (e.g. local-lvm)."
          },
          "backupStorageDestination": {
            "type": "string"
          },
          "backupStorageCompression": {
            "$ref": "#/components/schemas/v1BackupStorageCompression"
          },
          "networkBridge": {
            "type": "string",
            "description": "Node provisioning settings (copied into ProxmoxVM CR at generation time)\nProxmox Linux bridge for VM primary NIC (e.g. vmbr0). Default: vmbr0."
          },
          "networkName": {
            "type": "string",
            "description": "Proxmox net device key for primary NIC (e.g. net0). Default: net0."
          },
          "networkVlanId": {
            "type": "integer",
            "format": "int32",
            "description": "802.1Q VLAN tag on primary NIC (Proxmox tag=); 0 = untagged."
          },
          "networkModel": {
            "type": "string",
            "description": "Proxmox NIC model for primary NIC (virtio, e1000, ...). Default: virtio."
          },
          "computeType": {
            "$ref": "#/components/schemas/v1NodeComputeType"
          },
          "hasCpuTopology": {
            "type": "boolean",
            "description": "True when a dedicated node has a parsed CPU topology document stored\n(required before dedicated preflight can pass)."
          },
          "cpuCatalogSupported": {
            "type": "boolean",
            "description": "True when the host CPU model matches a cpu_catalog row with is_supported.\nFalse when the model is missing, unmatched, or matched but not supported."
          },
          "wingsNodeName": {
            "type": "string",
            "description": "Wings node name on a Pterodactyl platform. Empty on a hypervisor node."
          },
          "pterodactylLocationId": {
            "type": "integer",
            "format": "int32"
          },
          "panelNodeId": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1NodeCPUMapCPU": {
        "type": "object",
        "properties": {
          "cpu": {
            "type": "integer",
            "format": "int32",
            "description": "Host logical CPU id (the affinity bit)."
          },
          "core": {
            "type": "integer",
            "format": "int32",
            "description": "Physical core id (unique within a socket)."
          },
          "socket": {
            "type": "integer",
            "format": "int32"
          },
          "numa": {
            "type": "integer",
            "format": "int32"
          },
          "siblings": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Full SMT sibling set including this CPU."
          },
          "cpuStatus": {
            "$ref": "#/components/schemas/v1NodeCPUStatus"
          },
          "vmId": {
            "type": "string",
            "description": "Set when cpu_status is ALLOCATED_NR."
          },
          "vmHostname": {
            "type": "string"
          }
        }
      },
      "v1NodeCPUMapNUMA": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int32"
          },
          "sockets": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            }
          },
          "memoryMb": {
            "type": "string",
            "format": "int64"
          },
          "memoryReservedMb": {
            "type": "string",
            "format": "int64",
            "description": "Host reserve withheld from VMs on this NUMA node."
          },
          "memoryAllocatedMb": {
            "type": "string",
            "format": "int64",
            "description": "Memory attributed to NodeRings VMs placed on this NUMA node."
          },
          "memoryFreeMb": {
            "type": "string",
            "format": "int64"
          },
          "totalCores": {
            "type": "integer",
            "format": "int32",
            "description": "Logical CPU (vCPU) counts on this NUMA node — sellable capacity units."
          },
          "freeCores": {
            "type": "integer",
            "format": "int32"
          },
          "memoryEstimated": {
            "type": "boolean"
          }
        }
      },
      "v1NodeCPUStatus": {
        "type": "string",
        "enum": [
          "NODE_CPU_STATUS_UNSPECIFIED",
          "NODE_CPU_STATUS_AVAILABLE",
          "NODE_CPU_STATUS_ALLOCATED_NR",
          "NODE_CPU_STATUS_PINNED_FOREIGN",
          "NODE_CPU_STATUS_DRIFT"
        ],
        "default": "NODE_CPU_STATUS_UNSPECIFIED",
        "description": "Occupancy status of one host logical CPU (affinity bit).\n\n - NODE_CPU_STATUS_ALLOCATED_NR: Allocated to a NodeRings VM (vm_id/vm_hostname set).\n - NODE_CPU_STATUS_PINNED_FOREIGN: Pinned by a foreign (non-NodeRings) guest per exporter observation.\n - NODE_CPU_STATUS_DRIFT: DB expectation and exporter observation disagree for this CPU."
      },
      "v1NodeComputeType": {
        "type": "string",
        "enum": [
          "NODE_COMPUTE_TYPE_UNSPECIFIED",
          "NODE_COMPUTE_TYPE_SHARED",
          "NODE_COMPUTE_TYPE_DEDICATED"
        ],
        "default": "NODE_COMPUTE_TYPE_UNSPECIFIED",
        "description": "Compute product hosted by a node. Exclusive: a node is shared XOR dedicated\n(docs/README-DEDICATED-CPU-CORES.md, design decision D1).\n\n - NODE_COMPUTE_TYPE_SHARED: Shared vCPU hosting (CPU oversubscription allowed). Default.\n - NODE_COMPUTE_TYPE_DEDICATED: Dedicated pinned CPU cores (no CPU overallocation)."
      },
      "v1NodeInventory": {
        "type": "object",
        "properties": {
          "cpuType": {
            "$ref": "#/components/schemas/v1CPUType"
          },
          "cpuCore": {
            "type": "integer",
            "format": "int32"
          },
          "cpuCoreAllocated": {
            "type": "integer",
            "format": "int32"
          },
          "storagePools": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1StoragePool"
            }
          },
          "memory": {
            "type": "integer",
            "format": "int32"
          },
          "memoryAllocated": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1NodePlacementPolicy": {
        "type": "object",
        "properties": {
          "defaultStrategy": {
            "$ref": "#/components/schemas/v1NodePlacementStrategy"
          },
          "regionOverrides": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1NodePlacementRegionOverride"
            }
          }
        }
      },
      "v1NodePlacementRegionOverride": {
        "type": "object",
        "properties": {
          "regionId": {
            "type": "string"
          },
          "strategy": {
            "$ref": "#/components/schemas/v1NodePlacementStrategy"
          }
        }
      },
      "v1NodePlacementStrategy": {
        "type": "string",
        "enum": [
          "NODE_PLACEMENT_STRATEGY_UNSPECIFIED",
          "NODE_PLACEMENT_STRATEGY_FIRST_STABLE",
          "NODE_PLACEMENT_STRATEGY_ROUND_ROBIN",
          "NODE_PLACEMENT_STRATEGY_LEAST_ASSIGNED_VMS",
          "NODE_PLACEMENT_STRATEGY_RANDOM"
        ],
        "default": "NODE_PLACEMENT_STRATEGY_UNSPECIFIED"
      },
      "v1NodeWithExpandedRegion": {
        "type": "object",
        "properties": {
          "node": {
            "$ref": "#/components/schemas/v1Node"
          },
          "expandedRegion": {
            "$ref": "#/components/schemas/v1Region"
          }
        }
      },
      "v1NotificationSetting": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "enabled": {
            "type": "boolean"
          },
          "type": {
            "type": "string"
          },
          "user": {
            "type": "string",
            "title": "Relations"
          },
          "organization": {
            "type": "string"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1NotificationTemplate": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "emailSubjectTemplate": {
            "type": "string"
          },
          "emailBodyTemplate": {
            "type": "string"
          },
          "smsBodyTemplate": {
            "type": "string"
          },
          "webhookBodyTemplate": {
            "type": "string"
          },
          "pushNotificationTitleTemplate": {
            "type": "string"
          },
          "pushNotificationBodyTemplate": {
            "type": "string"
          },
          "contentType": {
            "type": "string"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1OAuth2Client": {
        "type": "object",
        "properties": {
          "clientId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "redirectUris": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "clientType": {
            "type": "string"
          },
          "requiresPkce": {
            "type": "boolean"
          },
          "isActive": {
            "type": "boolean"
          }
        }
      },
      "v1OpenConsoleResponse": {
        "type": "object",
        "properties": {
          "ticket": {
            "type": "string"
          },
          "websocketPath": {
            "type": "string"
          }
        }
      },
      "v1OperationStatus": {
        "type": "string",
        "enum": [
          "OPERATION_STATUS_UNSPECIFIED",
          "OPERATION_STATUS_CREATED",
          "OPERATION_STATUS_STARTED",
          "OPERATION_STATUS_STOPPED",
          "OPERATION_STATUS_DELETED",
          "OPERATION_STATUS_RESTARTED",
          "OPERATION_STATUS_REINSTALLING"
        ],
        "default": "OPERATION_STATUS_UNSPECIFIED"
      },
      "v1OrderGame": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "variables": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1EggVariable"
            }
          },
          "eula": {
            "type": "boolean",
            "description": "eula is true when this egg stops until the player accepts the Minecraft EULA."
          }
        }
      },
      "v1Organization": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/v1OrganizationType"
          },
          "enforceMfa": {
            "type": "boolean"
          },
          "enforceVerifiedDomain": {
            "type": "boolean"
          },
          "enforceSso": {
            "type": "boolean"
          },
          "asn": {
            "type": "string",
            "format": "int64"
          },
          "owner": {
            "type": "string",
            "title": "Relations"
          },
          "domains": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "groups": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "organizationRoles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "subscriptions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "providerLogoUrl": {
            "type": "string",
            "title": "Provider marketplace logo (data URL or https URL); only used for provider organizations"
          },
          "ddosProvider": {
            "type": "string",
            "description": "DDoS mitigation partner slug (e.g. \"none\"). Provider organizations only."
          },
          "providerWebsiteUrl": {
            "type": "string",
            "description": "Public storefront / company website (http or https). Provider organizations only."
          },
          "isVerified": {
            "type": "boolean",
            "description": "Provider marketplace / admin verification (first-class fields; not part of metadata)."
          },
          "reviewRequested": {
            "type": "boolean"
          },
          "onboarded": {
            "type": "boolean",
            "description": "True after the provider has completed the self-serve onboarding checklist once."
          },
          "hypervisorDriver": {
            "$ref": "#/components/schemas/v1PlatformDriver"
          }
        },
        "title": "Organization object for providers and clients"
      },
      "v1OrganizationDetails": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "orgType": {
            "type": "string"
          }
        },
        "title": "OrganizationDetails contains organization information"
      },
      "v1OrganizationType": {
        "type": "string",
        "enum": [
          "ORGANIZATION_TYPE_UNSPECIFIED",
          "ORGANIZATION_TYPE_PROVIDER",
          "ORGANIZATION_TYPE_CLIENT"
        ],
        "default": "ORGANIZATION_TYPE_UNSPECIFIED"
      },
      "v1PayInvoiceResponse": {
        "type": "object",
        "properties": {
          "invoice": {
            "$ref": "#/components/schemas/v1Invoice"
          },
          "invoiceLines": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1InvoiceLine"
            }
          },
          "transactionId": {
            "type": "string"
          },
          "paymentStatus": {
            "type": "string"
          }
        }
      },
      "v1Payment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "invoiceId": {
            "type": "string",
            "title": "Invoice this payment is for"
          },
          "paymentMethodId": {
            "type": "string",
            "title": "Payment method used for this payment"
          },
          "paymentStatus": {
            "$ref": "#/components/schemas/v1PaymentStatus"
          },
          "amount": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "currency": {
            "type": "string",
            "title": "Currency code (ISO 4217)"
          },
          "transactionId": {
            "type": "string",
            "title": "Payment provider transaction ID"
          },
          "paymentProvider": {
            "type": "string",
            "title": "Payment provider name (e.g., 'stripe', 'paypal')"
          },
          "failureReason": {
            "type": "string",
            "title": "Reason for payment failure (if applicable)"
          },
          "failureCode": {
            "type": "string",
            "title": "Payment provider failure code (if applicable)"
          },
          "processedAt": {
            "type": "string",
            "format": "date-time",
            "title": "When payment was processed"
          },
          "refundAmount": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "refundReason": {
            "type": "string",
            "title": "Reason for refund (if applicable)"
          },
          "refundedAt": {
            "type": "string",
            "format": "date-time",
            "title": "When payment was refunded"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        },
        "title": "Payment represents a payment transaction for an invoice"
      },
      "v1PaymentMethod": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "customerId": {
            "type": "string",
            "title": "Payment provider customer ID"
          },
          "paymentProviderPaymentMethodId": {
            "type": "string",
            "title": "Payment provider payment method ID (e.g., Stripe payment method ID,"
          },
          "type": {
            "type": "string",
            "description": "Payment method type: \"card\", \"paypal\", etc.",
            "title": "PayPal billing agreement ID)"
          },
          "last4": {
            "type": "string",
            "title": "Last 4 digits (for cards)"
          },
          "brand": {
            "type": "string",
            "description": "Card brand (for cards): \"visa\", \"mastercard\", etc."
          },
          "expiryMonth": {
            "type": "integer",
            "format": "int32",
            "title": "Expiry month (for cards, 1-12)"
          },
          "expiryYear": {
            "type": "integer",
            "format": "int32",
            "title": "Expiry year (for cards)"
          },
          "isDefault": {
            "type": "boolean",
            "title": "Whether this is the default payment method"
          },
          "metadata": {
            "type": "object",
            "title": "Payment method metadata"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "When payment method was attached"
          },
          "organizationId": {
            "type": "string",
            "description": "Organization that owns this payment method",
            "title": "Relations"
          },
          "subscriptionId": {
            "type": "string",
            "title": "Optional: Subscription this payment method is associated with"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        },
        "title": "PaymentMethod represents a payment method attached to a customer/organization"
      },
      "v1PaymentStatus": {
        "type": "string",
        "enum": [
          "PAYMENT_STATUS_UNSPECIFIED",
          "PAYMENT_STATUS_PENDING",
          "PAYMENT_STATUS_PROCESSING",
          "PAYMENT_STATUS_SUCCEEDED",
          "PAYMENT_STATUS_FAILED",
          "PAYMENT_STATUS_CANCELED",
          "PAYMENT_STATUS_REFUNDED",
          "PAYMENT_STATUS_PARTIALLY_REFUNDED"
        ],
        "default": "PAYMENT_STATUS_UNSPECIFIED"
      },
      "v1PayoutConfiguration": {
        "type": "object",
        "properties": {
          "scheduleType": {
            "$ref": "#/components/schemas/v1PayoutScheduleType"
          },
          "scheduleTime": {
            "type": "string",
            "title": "Time in HH:MM format (24-hour, UTC) - e.g., \"09:00\" for 9 AM"
          },
          "scheduleTimezone": {
            "type": "string",
            "title": "IANA timezone identifier (e.g., \"UTC\", \"America/New_York\") - defaults to \"UTC\""
          },
          "enabled": {
            "type": "boolean",
            "title": "Whether payout configuration is enabled (default: true)"
          }
        }
      },
      "v1PayoutHoldReason": {
        "type": "string",
        "enum": [
          "PAYOUT_HOLD_REASON_UNSPECIFIED",
          "PAYOUT_HOLD_REASON_COUPON_FIRST_PURCHASE",
          "PAYOUT_HOLD_REASON_CREDIT_FUNDED",
          "PAYOUT_HOLD_REASON_DISPUTE"
        ],
        "default": "PAYOUT_HOLD_REASON_UNSPECIFIED",
        "description": " - PAYOUT_HOLD_REASON_COUPON_FIRST_PURCHASE: Heavily discounted first purchase from a client.\n - PAYOUT_HOLD_REASON_CREDIT_FUNDED: Paid with prepaid credits.\n - PAYOUT_HOLD_REASON_DISPUTE: The client opened a dispute; held until it closes."
      },
      "v1PayoutInvoice": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "PayoutInvoice ID"
          },
          "amount": {
            "type": "string",
            "title": "Payout amount (decimal string with 6 decimal places precision)"
          },
          "platformFeeAmount": {
            "type": "string",
            "title": "Platform fee deducted from this payout (decimal string with 6 decimal places precision)"
          },
          "currency": {
            "type": "string",
            "title": "Currency code (ISO 4217)"
          },
          "payoutStatus": {
            "$ref": "#/components/schemas/v1PayoutStatus"
          },
          "transferTransactionId": {
            "type": "string",
            "title": "Payment provider transfer transaction ID"
          },
          "paymentProvider": {
            "type": "string",
            "title": "Payment provider name (e.g., 'stripe', 'paypal')"
          },
          "connectAccountId": {
            "type": "string",
            "title": "Provider's Connect account ID"
          },
          "processedAt": {
            "type": "string",
            "format": "date-time",
            "title": "When payout transfer was initiated/processed"
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "title": "When payout transfer was completed"
          },
          "failedAt": {
            "type": "string",
            "format": "date-time",
            "title": "When payout transfer failed"
          },
          "failureReason": {
            "type": "string",
            "title": "Reason for payout failure (if applicable)"
          },
          "failureCode": {
            "type": "string",
            "title": "Payment provider failure code (if applicable)"
          },
          "retryCount": {
            "type": "integer",
            "format": "int32",
            "title": "Number of retry attempts for failed transfers"
          },
          "maxRetries": {
            "type": "integer",
            "format": "int32",
            "title": "Maximum number of retry attempts"
          },
          "lastRetryAt": {
            "type": "string",
            "format": "date-time",
            "title": "Timestamp of last retry attempt"
          },
          "invoiceIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "IDs of client invoices that contributed to this payout"
          },
          "providerOrganizationId": {
            "type": "string",
            "title": "Provider organization that receives this payout"
          },
          "metadata": {
            "type": "object",
            "title": "Additional metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1PayoutScheduleType": {
        "type": "string",
        "enum": [
          "PAYOUT_SCHEDULE_TYPE_UNSPECIFIED",
          "PAYOUT_SCHEDULE_TYPE_IMMEDIATE",
          "PAYOUT_SCHEDULE_TYPE_DAILY",
          "PAYOUT_SCHEDULE_TYPE_WEEKLY",
          "PAYOUT_SCHEDULE_TYPE_MONTHLY"
        ],
        "default": "PAYOUT_SCHEDULE_TYPE_UNSPECIFIED",
        "description": "- PAYOUT_SCHEDULE_TYPE_IMMEDIATE: Transfer immediately when payment succeeds\n - PAYOUT_SCHEDULE_TYPE_DAILY: Transfer once per day at specified time\n - PAYOUT_SCHEDULE_TYPE_WEEKLY: Transfer once per week at specified time\n - PAYOUT_SCHEDULE_TYPE_MONTHLY: Transfer once per month at specified time",
        "title": "Payout Configuration"
      },
      "v1PayoutStatus": {
        "type": "string",
        "enum": [
          "PAYOUT_STATUS_UNSPECIFIED",
          "PAYOUT_STATUS_PENDING",
          "PAYOUT_STATUS_PROCESSING",
          "PAYOUT_STATUS_COMPLETED",
          "PAYOUT_STATUS_FAILED",
          "PAYOUT_STATUS_CANCELED"
        ],
        "default": "PAYOUT_STATUS_UNSPECIFIED",
        "title": "PayoutInvoice messages"
      },
      "v1Permission": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "methodName": {
            "type": "string"
          },
          "httpMethod": {
            "type": "string"
          },
          "serviceName": {
            "type": "string"
          },
          "scope": {
            "type": "string"
          }
        }
      },
      "v1Plan": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "endUser": {
            "$ref": "#/components/schemas/v1EndUser"
          },
          "billingPeriod": {
            "$ref": "#/components/schemas/v1BillingPeriod"
          },
          "planType": {
            "$ref": "#/components/schemas/v1PlanType"
          },
          "billingType": {
            "$ref": "#/components/schemas/v1BillingType"
          },
          "assetCategory": {
            "$ref": "#/components/schemas/v1AssetCategory"
          },
          "assetType": {
            "$ref": "#/components/schemas/v1AssetType"
          },
          "planCategory": {
            "$ref": "#/components/schemas/v1PlanCategory"
          },
          "currency": {
            "type": "string"
          },
          "setupFee": {
            "type": "string",
            "title": "Decimal string with 6 decimal places"
          },
          "trialDays": {
            "type": "integer",
            "format": "int32",
            "title": "precision (e.g., \"10.00\" for $10.00)"
          },
          "trialAvailable": {
            "type": "boolean"
          },
          "gracePeriodDays": {
            "type": "integer",
            "format": "int32"
          },
          "autoRenew": {
            "type": "boolean"
          },
          "maxSubscribers": {
            "type": "integer",
            "format": "int32"
          },
          "isPublic": {
            "type": "boolean"
          },
          "slaHours": {
            "type": "integer",
            "format": "int32"
          },
          "requiresManualApproval": {
            "type": "boolean"
          },
          "effectiveFrom": {
            "type": "string",
            "format": "date-time"
          },
          "effectiveUntil": {
            "type": "string",
            "format": "date-time"
          },
          "externalBillingId": {
            "type": "string"
          },
          "templatePlanId": {
            "type": "string"
          },
          "rulesetIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "Relations"
          },
          "planPrices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PlanPrice"
            }
          },
          "subscriptionIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "regionIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "nodeIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Nodes explicitly assigned to this plan (placement / preflight candidates)."
          },
          "organizationName": {
            "type": "string",
            "description": "Name of the organization that owns this plan",
            "title": "Organization/tenant information"
          },
          "onCreditExhaustion": {
            "type": "string",
            "description": "Provider choice when client prepaid credits are exhausted.\nValues: \"suspend\" (default), \"continue_with_dunning\". Relevant for usage-based Offerings."
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1PlanCategory": {
        "type": "string",
        "enum": [
          "PLAN_CATEGORY_UNSPECIFIED",
          "PLAN_CATEGORY_FREE",
          "PLAN_CATEGORY_STARTER",
          "PLAN_CATEGORY_PREMIUM",
          "PLAN_CATEGORY_CUSTOM"
        ],
        "default": "PLAN_CATEGORY_UNSPECIFIED"
      },
      "v1PlanLiveValidationBenchmarkView": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "createTime": {
            "type": "string",
            "format": "date-time"
          },
          "passed": {
            "type": "boolean"
          },
          "cpu": {
            "type": "object"
          },
          "memory": {
            "type": "object"
          },
          "storage": {
            "type": "object"
          },
          "network": {
            "type": "object"
          },
          "misc": {
            "type": "object"
          },
          "planId": {
            "type": "string"
          },
          "nodeId": {
            "type": "string"
          },
          "planCode": {
            "type": "string"
          },
          "nodeName": {
            "type": "string"
          }
        }
      },
      "v1PlanLiveValidationNodeView": {
        "type": "object",
        "properties": {
          "nodeId": {
            "type": "string"
          },
          "nodeName": {
            "type": "string"
          },
          "regionId": {
            "type": "string"
          },
          "regionName": {
            "type": "string"
          }
        }
      },
      "v1PlanLiveValidationView": {
        "type": "object",
        "properties": {
          "planId": {
            "type": "string"
          },
          "planCode": {
            "type": "string"
          },
          "nodeId": {
            "type": "string"
          },
          "passed": {
            "type": "boolean"
          },
          "status": {
            "type": "string"
          },
          "phase": {
            "type": "string"
          },
          "includeBenchmarking": {
            "type": "boolean"
          },
          "summaryNote": {
            "type": "string"
          },
          "checks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1LiveValidationCheckView"
            }
          },
          "marketplaceLiveValidated": {
            "type": "boolean"
          },
          "nodeName": {
            "type": "string"
          },
          "regionName": {
            "type": "string"
          },
          "checkedAt": {
            "type": "string",
            "format": "date-time"
          },
          "startedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "v1PlanPreflightView": {
        "type": "object",
        "properties": {
          "planCode": {
            "type": "string"
          },
          "planName": {
            "type": "string"
          },
          "marketplaceReady": {
            "type": "boolean"
          },
          "summaryNote": {
            "type": "string"
          },
          "planChecks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PreflightCheckView"
            }
          },
          "infrastructure": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PreflightInfrastructureView"
            }
          },
          "planId": {
            "type": "string"
          },
          "billingType": {
            "$ref": "#/components/schemas/v1BillingType"
          },
          "summaryIssues": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "regionLabels": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1PlanPrice": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "pricingModel": {
            "$ref": "#/components/schemas/v1PricingModel"
          },
          "chargeTiming": {
            "$ref": "#/components/schemas/v1ChargeTiming"
          },
          "tierMode": {
            "$ref": "#/components/schemas/v1TierMode"
          },
          "currency": {
            "type": "string",
            "title": "Pricing details"
          },
          "unitAmount": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "unitName": {
            "type": "string"
          },
          "unitQuantity": {
            "type": "integer",
            "format": "int32"
          },
          "metricName": {
            "type": "string",
            "title": "Usage-based pricing"
          },
          "metricAggregation": {
            "$ref": "#/components/schemas/v1MetricAggregation"
          },
          "packageSize": {
            "type": "integer",
            "format": "int32",
            "title": "Package pricing"
          },
          "packagePrice": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "overagePrice": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "billingPeriod": {
            "$ref": "#/components/schemas/v1BillingPeriod"
          },
          "billingInterval": {
            "type": "integer",
            "format": "int32"
          },
          "minimumCharge": {
            "type": "string",
            "description": "Decimal string with 6 decimal places precision",
            "title": "Minimum and maximum charges"
          },
          "maximumCharge": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "freeUnits": {
            "type": "integer",
            "format": "int32",
            "title": "Free tier configuration"
          },
          "freeAmount": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "prorate": {
            "type": "boolean",
            "title": "Proration and billing"
          },
          "metered": {
            "type": "boolean"
          },
          "effectiveFrom": {
            "type": "string",
            "format": "date-time",
            "title": "Status and lifecycle"
          },
          "effectiveUntil": {
            "type": "string",
            "format": "date-time"
          },
          "externalId": {
            "type": "string",
            "title": "External integration"
          },
          "productType": {
            "$ref": "#/components/schemas/v1ProductType"
          },
          "parentPlanId": {
            "type": "string",
            "title": "For addon prices: reference to parent plan (percentage-based pricing)"
          },
          "minQuantity": {
            "type": "integer",
            "format": "int32",
            "title": "Minimum quantity (primarily for addons)"
          },
          "maxQuantity": {
            "type": "integer",
            "format": "int32",
            "title": "Maximum quantity (primarily for addons)"
          },
          "pricingFormula": {
            "type": "object",
            "title": "Pricing formula for percentage/complex calculations"
          },
          "planPrices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Plan"
            },
            "title": "Relations"
          },
          "pricingTierIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "subscriptionTemplateIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "metricIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1PlanPriceInput": {
        "type": "object",
        "properties": {
          "pricingModel": {
            "$ref": "#/components/schemas/v1PricingModel"
          },
          "chargeTiming": {
            "$ref": "#/components/schemas/v1ChargeTiming"
          },
          "billingPeriod": {
            "$ref": "#/components/schemas/v1BillingPeriod"
          },
          "billingInterval": {
            "type": "integer",
            "format": "int32"
          },
          "unitAmount": {
            "type": "string",
            "description": "Decimal string with 6 decimal places precision",
            "title": "Fixed & usage-based pricing"
          },
          "unitName": {
            "type": "string"
          },
          "unitQuantity": {
            "type": "integer",
            "format": "int32"
          },
          "metricName": {
            "type": "string",
            "title": "Usage-based specific"
          },
          "metricAggregation": {
            "$ref": "#/components/schemas/v1MetricAggregation"
          },
          "freeUnits": {
            "type": "integer",
            "format": "int32"
          },
          "minimumCharge": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "maximumCharge": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "packageSize": {
            "type": "integer",
            "format": "int32",
            "title": "Package pricing"
          },
          "packagePrice": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "overagePrice": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "tiers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PricingTierInput"
            },
            "title": "Tiered pricing"
          },
          "prorate": {
            "type": "boolean",
            "title": "Proration"
          },
          "productType": {
            "$ref": "#/components/schemas/v1ProductType"
          },
          "addonCode": {
            "type": "string",
            "title": "Addon code (required if product_type is PRODUCT_TYPE_ADDON)"
          },
          "pricingFormula": {
            "type": "object",
            "title": "Pricing formula for percentage-based or complex pricing\nExample: {\"type\": \"percentage\", \"value\": 30.0, \"base\":\n\"parent_plan.total_price\"}"
          }
        }
      },
      "v1PlanPriceOverride": {
        "type": "object",
        "properties": {
          "metricId": {
            "type": "string"
          },
          "planPriceId": {
            "type": "string"
          },
          "unitAmount": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "freeUnits": {
            "type": "integer",
            "format": "int32"
          },
          "minimumCharge": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "maximumCharge": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          }
        },
        "description": "PlanPriceOverride allows overriding specific fields for plan prices when\ncloning. Either metric_id (for usage-based pricing) or plan_price_id (for\nfixed pricing) must be provided to identify which plan price to override."
      },
      "v1PlanPricingConfig": {
        "type": "object",
        "properties": {
          "planName": {
            "type": "string",
            "title": "Plan metadata"
          },
          "assetCategory": {
            "type": "string"
          },
          "assetType": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "prices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PlanPriceInput"
            },
            "title": "Pricing models (at least one required)"
          }
        }
      },
      "v1PlanRegion": {
        "type": "object",
        "properties": {
          "regionId": {
            "type": "string",
            "title": "Region ID"
          },
          "country": {
            "type": "string",
            "title": "Country name from CityCountry"
          },
          "city": {
            "type": "string",
            "title": "City name from CityCountry"
          },
          "latitude": {
            "type": "number",
            "format": "double",
            "title": "Latitude from CityCountry"
          },
          "longitude": {
            "type": "number",
            "format": "double",
            "title": "Longitude from CityCountry"
          }
        },
        "description": "Plan region information (simplified for marketplace).\nUsed by ListProviders (ProviderInfo.plan_regions), GetProvider (ProviderCatalogPlan.regions),\nand encoded by the same backend helpers as plan-linked region edges."
      },
      "v1PlanType": {
        "type": "string",
        "enum": [
          "PLAN_TYPE_UNSPECIFIED",
          "PLAN_TYPE_FREE",
          "PLAN_TYPE_TRIAL",
          "PLAN_TYPE_PAID",
          "PLAN_TYPE_ENTERPRISE"
        ],
        "default": "PLAN_TYPE_UNSPECIFIED"
      },
      "v1Platform": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "driver": {
            "$ref": "#/components/schemas/v1PlatformDriver"
          },
          "name": {
            "type": "string"
          },
          "endpointUrl": {
            "type": "string"
          },
          "serviceStatus": {
            "$ref": "#/components/schemas/v1ServiceStatus"
          },
          "organizationId": {
            "type": "string"
          },
          "agentId": {
            "type": "string"
          },
          "metadata": {
            "type": "object"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "assignCustomerIpv6": {
            "type": "boolean",
            "description": "VirtFusion/SolusVM: guests on this platform are offered panel-assigned IPv6.\nIgnored for Proxmox (IPv6 is prefix-derived). Default false."
          },
          "kind": {
            "$ref": "#/components/schemas/v1PlatformKind"
          }
        }
      },
      "v1PlatformDriver": {
        "type": "string",
        "enum": [
          "PLATFORM_DRIVER_UNSPECIFIED",
          "PLATFORM_DRIVER_PROXMOX",
          "PLATFORM_DRIVER_VIRTFUSION",
          "PLATFORM_DRIVER_SOLUSVM",
          "PLATFORM_DRIVER_PTERODACTYL"
        ],
        "default": "PLATFORM_DRIVER_UNSPECIFIED",
        "description": " - PLATFORM_DRIVER_PTERODACTYL: Game-server platform. Not a value of the organization hypervisor driver."
      },
      "v1PlatformKind": {
        "type": "string",
        "enum": [
          "PLATFORM_KIND_UNSPECIFIED",
          "PLATFORM_KIND_HYPERVISOR",
          "PLATFORM_KIND_PTERODACTYL"
        ],
        "default": "PLATFORM_KIND_UNSPECIFIED"
      },
      "v1PlatformVersions": {
        "type": "object",
        "properties": {
          "components": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ComponentVersion"
            }
          },
          "schemaVersion": {
            "type": "string",
            "description": "Schema version for forward-compatible clients (currently \"1\")."
          }
        },
        "description": "PlatformVersions is the install matrix for provider CLI tooling and cluster components."
      },
      "v1Prefix": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "cidr": {
            "type": "string",
            "title": "Network prefix in CIDR notation (e.g., 10.0.0.0/24, 2001:db8::/64)"
          },
          "gateway": {
            "type": "string",
            "description": "Default gateway IP (e.g., 10.0.0.1). Must be within the prefix CIDR."
          },
          "reservedIps": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "List of reserved IP addresses (e.g., [\"10.0.0.1\", \"10.0.0.100\"])"
          },
          "allocationStrategy": {
            "$ref": "#/components/schemas/v1AllocationStrategy"
          },
          "description": {
            "type": "string"
          },
          "networkId": {
            "type": "string",
            "description": "Network this prefix belongs to (for DNS servers). Optional.",
            "title": "Relations"
          },
          "organizationId": {
            "type": "string"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "vmAssignmentPrefixLength": {
            "type": "integer",
            "format": "int32",
            "title": "IPv6 only: VM assignment length (64, 128, …)"
          },
          "reservedPrefixes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "Reserved sub-prefix CIDRs at assignment length"
          }
        }
      },
      "v1PreflightAgentView": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "checks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PreflightCheckView"
            }
          },
          "platform": {
            "$ref": "#/components/schemas/v1PreflightPlatformView"
          }
        }
      },
      "v1PreflightCheckView": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "passed": {
            "type": "boolean"
          },
          "note": {
            "type": "string"
          },
          "subChecks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PreflightCheckView"
            }
          }
        }
      },
      "v1PreflightInfrastructureView": {
        "type": "object",
        "properties": {
          "passed": {
            "type": "boolean"
          },
          "agent": {
            "$ref": "#/components/schemas/v1PreflightAgentView"
          }
        }
      },
      "v1PreflightNodeView": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "checks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PreflightCheckView"
            }
          }
        }
      },
      "v1PreflightPlatformView": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "checks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PreflightCheckView"
            }
          },
          "node": {
            "$ref": "#/components/schemas/v1PreflightNodeView"
          }
        }
      },
      "v1PreviewCouponRequest": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "planId": {
            "type": "string"
          },
          "billingPeriod": {
            "$ref": "#/components/schemas/v1BillingPeriod"
          },
          "quantity": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1PreviewCouponResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "discountType": {
            "$ref": "#/components/schemas/v1CouponDiscountType"
          },
          "percentOff": {
            "type": "string"
          },
          "amountOff": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "termsSummary": {
            "type": "string",
            "description": "Server-rendered disclosure; show it verbatim."
          },
          "originalPrice": {
            "type": "string",
            "description": "Fixed price for the selected period, empty for usage-priced plans."
          },
          "discountedPrice": {
            "type": "string"
          }
        }
      },
      "v1PreviewMyStorefrontResponse": {
        "type": "object",
        "properties": {
          "storefront": {
            "$ref": "#/components/schemas/v1PublicStorefront"
          },
          "sourceStatus": {
            "$ref": "#/components/schemas/v1StorefrontRevisionStatus"
          }
        }
      },
      "v1PreviewNotificationTemplateResponse": {
        "type": "object",
        "properties": {
          "previewEmailSubject": {
            "type": "string"
          },
          "previewEmailBody": {
            "type": "string"
          },
          "previewSmsBody": {
            "type": "string"
          },
          "previewWebhookBody": {
            "type": "string"
          },
          "previewPushNotificationTitle": {
            "type": "string"
          },
          "previewPushNotificationBody": {
            "type": "string"
          }
        }
      },
      "v1PricingCalculationConfig": {
        "type": "object",
        "properties": {
          "capHours": {
            "type": "number",
            "format": "double",
            "title": "Maximum billable hours (default 730 for monthly cap)"
          },
          "taxRate": {
            "type": "number",
            "format": "double",
            "title": "Tax rate (e.g., 0.10 for 10%)"
          },
          "discountPercent": {
            "type": "number",
            "format": "double",
            "title": "Discounts"
          },
          "couponValue": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision (e.g., \"5.00\" for $5.00)"
          },
          "overageRates": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "format": "double"
            },
            "title": "Overage rates (metric_name -> rate in minor currency units)"
          }
        }
      },
      "v1PricingLineItem": {
        "type": "object",
        "properties": {
          "instanceLabel": {
            "type": "string",
            "title": "Human-readable label"
          },
          "quantity": {
            "type": "integer",
            "format": "int32"
          },
          "base": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "addons": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "subtotal": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "currency": {
            "type": "string"
          }
        }
      },
      "v1PricingModel": {
        "type": "string",
        "enum": [
          "PRICING_MODEL_UNSPECIFIED",
          "PRICING_MODEL_FIXED",
          "PRICING_MODEL_USAGE_BASED",
          "PRICING_MODEL_TIERED",
          "PRICING_MODEL_VOLUME",
          "PRICING_MODEL_GRADUATED",
          "PRICING_MODEL_PACKAGE",
          "PRICING_MODEL_HYBRID"
        ],
        "default": "PRICING_MODEL_UNSPECIFIED"
      },
      "v1PricingTierInput": {
        "type": "object",
        "properties": {
          "tierOrder": {
            "type": "integer",
            "format": "int32"
          },
          "tierName": {
            "type": "string"
          },
          "startInclusive": {
            "type": "number",
            "format": "double"
          },
          "endExclusive": {
            "type": "number",
            "format": "double",
            "title": "null = unlimited"
          },
          "unitAmount": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "tierType": {
            "$ref": "#/components/schemas/v1TierMode"
          },
          "flatFee": {
            "type": "boolean"
          },
          "flatFeeAmount": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          }
        }
      },
      "v1ProductType": {
        "type": "string",
        "enum": [
          "PRODUCT_TYPE_UNSPECIFIED",
          "PRODUCT_TYPE_PLAN",
          "PRODUCT_TYPE_ADDON"
        ],
        "default": "PRODUCT_TYPE_UNSPECIFIED",
        "title": "- PRODUCT_TYPE_PLAN: Standalone subscription plan\n - PRODUCT_TYPE_ADDON: Addon attached to a subscription"
      },
      "v1PromoCreditGrant": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "remaining": {
            "type": "string"
          },
          "reserved": {
            "type": "string"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "couponName": {
            "type": "string"
          },
          "code": {
            "type": "string"
          }
        }
      },
      "v1ProviderCatalogPlan": {
        "type": "object",
        "properties": {
          "planId": {
            "type": "string"
          },
          "planCode": {
            "type": "string"
          },
          "planName": {
            "type": "string"
          },
          "planDescription": {
            "type": "string"
          },
          "billingType": {
            "$ref": "#/components/schemas/v1BillingType"
          },
          "computeType": {
            "$ref": "#/components/schemas/v1ComputeType"
          },
          "computeCategory": {
            "$ref": "#/components/schemas/v1ComputeCategory"
          },
          "regions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PlanRegion"
            }
          },
          "planPrices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PlanPrice"
            }
          },
          "assetType": {
            "$ref": "#/components/schemas/v1AssetType"
          }
        },
        "description": "One public plan offering for a provider (GetProvider catalog). Reuses PlanRegion + PlanPrice\nfrom the same marketplace encoding as ListProviders rows."
      },
      "v1ProviderCustomerActivityFilter": {
        "type": "string",
        "enum": [
          "PROVIDER_CUSTOMER_ACTIVITY_FILTER_UNSPECIFIED",
          "PROVIDER_CUSTOMER_ACTIVITY_FILTER_ALL",
          "PROVIDER_CUSTOMER_ACTIVITY_FILTER_ACTIVE",
          "PROVIDER_CUSTOMER_ACTIVITY_FILTER_INACTIVE"
        ],
        "default": "PROVIDER_CUSTOMER_ACTIVITY_FILTER_UNSPECIFIED",
        "description": "Active: at least one non-deleted VM from this provider. Inactive: all VMs from this provider are soft-deleted (delete_time set).\n\n - PROVIDER_CUSTOMER_ACTIVITY_FILTER_ALL: All customers (any VM history with this provider, including when every VM is soft-deleted)."
      },
      "v1ProviderCustomerAssetRow": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "assetType": {
            "$ref": "#/components/schemas/v1ProviderCustomerAssetType"
          },
          "displayName": {
            "type": "string"
          },
          "activityStatus": {
            "$ref": "#/components/schemas/v1ProviderCustomerVmActivityStatus"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "deleteTime": {
            "type": "string",
            "format": "date-time",
            "description": "Set when the VM was deleted or terminated (soft-delete)."
          },
          "spec": {
            "type": "string",
            "description": "Human-readable size, e.g. \"2 vCPU · 4096 MB RAM · 80 GB disk\"."
          },
          "region": {
            "type": "string",
            "description": "Region label, e.g. \"Frankfurt, DE\"."
          },
          "ipv4": {
            "type": "string"
          },
          "ipv6": {
            "type": "string"
          },
          "os": {
            "type": "string",
            "description": "OS/distro label from the VM template (e.g. ubuntu-22)."
          },
          "planName": {
            "type": "string"
          },
          "planCode": {
            "type": "string",
            "description": "Plan code (e.g. DC-HF-32C-…) from the subscription plan."
          },
          "regionId": {
            "type": "string",
            "description": "UUID of the node's region (same dimension as ListProviderCustomerAssetsRequest.region_id filter)."
          },
          "complianceHeld": {
            "type": "boolean"
          },
          "complianceReason": {
            "$ref": "#/components/schemas/v1ComplianceReason"
          },
          "complianceMessage": {
            "type": "string"
          },
          "complianceActor": {
            "$ref": "#/components/schemas/v1ComplianceActor"
          }
        }
      },
      "v1ProviderCustomerAssetType": {
        "type": "string",
        "enum": [
          "PROVIDER_CUSTOMER_ASSET_TYPE_UNSPECIFIED",
          "PROVIDER_CUSTOMER_ASSET_TYPE_ALL",
          "PROVIDER_CUSTOMER_ASSET_TYPE_VIRTUAL_MACHINE",
          "PROVIDER_CUSTOMER_ASSET_TYPE_DEDICATED_SERVER",
          "PROVIDER_CUSTOMER_ASSET_TYPE_GAME_SERVER"
        ],
        "default": "PROVIDER_CUSTOMER_ASSET_TYPE_UNSPECIFIED"
      },
      "v1ProviderCustomerRow": {
        "type": "object",
        "properties": {
          "organizationId": {
            "type": "string"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "lastLoginTime": {
            "type": "string",
            "format": "date-time"
          },
          "organizationName": {
            "type": "string"
          },
          "addressSummary": {
            "type": "string",
            "description": "Best-effort summary from organization metadata (billing/address keys)."
          },
          "vmActivityStatus": {
            "$ref": "#/components/schemas/v1ProviderCustomerVmActivityStatus"
          },
          "paymentMethodBrand": {
            "type": "string",
            "description": "Default payment method brand when known (visa, mastercard, amex, paypal, …)."
          },
          "paymentMethodLast4": {
            "type": "string",
            "description": "Last 4 digits of the default card. Empty for non-card methods or if unknown."
          },
          "purchasesBlocked": {
            "type": "boolean"
          },
          "purchasesBlockedActor": {
            "$ref": "#/components/schemas/v1ComplianceActor"
          }
        }
      },
      "v1ProviderCustomerVmActivityStatus": {
        "type": "string",
        "enum": [
          "PROVIDER_CUSTOMER_VM_ACTIVITY_STATUS_UNSPECIFIED",
          "PROVIDER_CUSTOMER_VM_ACTIVITY_STATUS_ACTIVE",
          "PROVIDER_CUSTOMER_VM_ACTIVITY_STATUS_INACTIVE"
        ],
        "default": "PROVIDER_CUSTOMER_VM_ACTIVITY_STATUS_UNSPECIFIED"
      },
      "v1ProviderDashboardAddonCatalogRow": {
        "type": "object",
        "properties": {
          "addonId": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "addonType": {
            "$ref": "#/components/schemas/v1AddonType"
          },
          "billingType": {
            "$ref": "#/components/schemas/v1BillingType"
          },
          "pricingModel": {
            "$ref": "#/components/schemas/v1PricingModel"
          },
          "distinctVmCount": {
            "type": "integer",
            "format": "int32"
          },
          "distinctCustomerOrgCount": {
            "type": "integer",
            "format": "int32"
          },
          "activeSubscriptionCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ProviderDashboardNodeRollup": {
        "type": "object",
        "properties": {
          "nodeId": {
            "type": "string"
          },
          "nodeName": {
            "type": "string"
          },
          "platformId": {
            "type": "string"
          },
          "platformName": {
            "type": "string"
          },
          "regionId": {
            "type": "string"
          },
          "vmCount": {
            "type": "integer",
            "format": "int32"
          },
          "soldCpuCores": {
            "type": "string",
            "format": "int64"
          },
          "soldMemoryMb": {
            "type": "string",
            "format": "int64"
          },
          "soldStorageGb": {
            "type": "string",
            "format": "int64"
          },
          "capacityCpuCores": {
            "type": "integer",
            "format": "int32"
          },
          "capacityMemoryMb": {
            "type": "string",
            "format": "int64"
          },
          "nodeCpuCoreAllocated": {
            "type": "integer",
            "format": "int32"
          },
          "nodeMemoryAllocatedMb": {
            "type": "string",
            "format": "int64"
          },
          "cpuOverallocatePercent": {
            "type": "integer",
            "format": "int32"
          },
          "memoryOverallocatePercent": {
            "type": "integer",
            "format": "int32"
          },
          "storageOverallocatePercent": {
            "type": "integer",
            "format": "int32"
          },
          "hypervisorId": {
            "type": "string",
            "description": "VirtFusion hypervisor_id or SolusVM compute_resource_id; used to join Prom series."
          }
        }
      },
      "v1ProviderDashboardPlanSubscriptionStat": {
        "type": "object",
        "properties": {
          "planId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "billingType": {
            "$ref": "#/components/schemas/v1BillingType"
          },
          "billingPeriod": {
            "$ref": "#/components/schemas/v1BillingPeriod"
          },
          "assetType": {
            "$ref": "#/components/schemas/v1AssetType"
          },
          "activeSubscriptionCount": {
            "type": "integer",
            "format": "int32"
          },
          "distinctCustomerOrgCount": {
            "type": "integer",
            "format": "int32"
          },
          "vmAssetCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ProviderDashboardPlansTabStats": {
        "type": "object",
        "properties": {
          "kpiPlanCount": {
            "type": "integer",
            "format": "int32"
          },
          "kpiActiveSubscriptionsSum": {
            "type": "integer",
            "format": "int32"
          },
          "kpiActiveAddonSubscriptionsSum": {
            "type": "integer",
            "format": "int32"
          },
          "kpiVmAssetsSum": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ProviderDetails": {
        "type": "object",
        "properties": {
          "provider": {
            "$ref": "#/components/schemas/v1ProviderInfo"
          },
          "website": {
            "type": "string"
          },
          "availableRegions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "ddosSolution": {
            "type": "string"
          },
          "avgTicketResponseSeconds": {
            "type": "string",
            "format": "int64"
          },
          "reviewBreakdown": {
            "$ref": "#/components/schemas/v1ProviderReviewBreakdown"
          },
          "availablePlans": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ProviderCatalogPlan"
            }
          },
          "hasIpv6": {
            "type": "boolean",
            "description": "True when any listed region would report ipv6_available_in_filtered_region."
          }
        },
        "description": "GetProvider payload: nested ProviderInfo shares the same core fields as list rows; extended\nfields are provider-wide (website, review breakdown, catalog plans, etc.)."
      },
      "v1ProviderInfo": {
        "type": "object",
        "properties": {
          "organizationId": {
            "type": "string"
          },
          "organizationName": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "rating": {
            "type": "number",
            "format": "float",
            "title": "Average rating (0-5 stars)"
          },
          "totalReviews": {
            "type": "integer",
            "format": "int32",
            "title": "Total number of reviews"
          },
          "planPrices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PlanPrice"
            },
            "title": "All prices for the requested plan code (includes plan prices and addon prices, same format as price calculator)"
          },
          "metadata": {
            "type": "object",
            "title": "Additional provider metadata"
          },
          "planRegions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1PlanRegion"
            },
            "title": "All regions where the plan is available (region_id, country, city)"
          },
          "planId": {
            "type": "string",
            "title": "The plan ID for the requested plan code"
          },
          "hasCapacityInFilteredRegion": {
            "type": "boolean",
            "title": "True if provider has at least one node with capacity in the filtered region (plan + country + city)"
          },
          "providerLogoUrl": {
            "type": "string"
          },
          "ipv6AvailableInFilteredRegion": {
            "type": "boolean",
            "description": "True when customers in the filtered region (country + city) are offered IPv6:\nProxmox = active IPv6 prefix on a network attached to a node there;\nVirtFusion/SolusVM = a node there whose platform has assign_customer_ipv6."
          },
          "ddosProvider": {
            "type": "string",
            "description": "DDoS mitigation partner slug; \"none\" or empty means no DDoS vendor icon in marketplace."
          },
          "platformDriver": {
            "$ref": "#/components/schemas/v1PlatformDriver"
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Capability strings from platformdriver (guest_firewall, instant_apps, …)."
          }
        },
        "title": "Provider information for marketplace/discovery"
      },
      "v1ProviderOnboardingStep": {
        "type": "object",
        "properties": {
          "code": {
            "$ref": "#/components/schemas/v1ProviderOnboardingStepCode"
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "completed": {
            "type": "boolean"
          },
          "actionPath": {
            "type": "string",
            "description": "Deep-link path in the provider console (e.g. \"/organization/settings\")."
          },
          "hint": {
            "type": "string",
            "description": "Optional guidance when incomplete (e.g. agent/Proxmox metrics hint)."
          }
        }
      },
      "v1ProviderOnboardingStepCode": {
        "type": "string",
        "enum": [
          "PROVIDER_ONBOARDING_STEP_CODE_UNSPECIFIED",
          "PROVIDER_ONBOARDING_STEP_CODE_KYC",
          "PROVIDER_ONBOARDING_STEP_CODE_DOMAIN",
          "PROVIDER_ONBOARDING_STEP_CODE_STRIPE_CONNECT",
          "PROVIDER_ONBOARDING_STEP_CODE_REGION",
          "PROVIDER_ONBOARDING_STEP_CODE_PLATFORM",
          "PROVIDER_ONBOARDING_STEP_CODE_NODE",
          "PROVIDER_ONBOARDING_STEP_CODE_NODE_METRICS",
          "PROVIDER_ONBOARDING_STEP_CODE_CLOUD_INIT",
          "PROVIDER_ONBOARDING_STEP_CODE_VM_TEMPLATE",
          "PROVIDER_ONBOARDING_STEP_CODE_NETWORK",
          "PROVIDER_ONBOARDING_STEP_CODE_NODE_NETWORK",
          "PROVIDER_ONBOARDING_STEP_CODE_PREFLIGHT",
          "PROVIDER_ONBOARDING_STEP_CODE_LIVE_VALIDATION",
          "PROVIDER_ONBOARDING_STEP_CODE_AGENT",
          "PROVIDER_ONBOARDING_STEP_CODE_PREFIX_IPV4",
          "PROVIDER_ONBOARDING_STEP_CODE_PREFIX_IPV6",
          "PROVIDER_ONBOARDING_STEP_CODE_PLAN",
          "PROVIDER_ONBOARDING_STEP_CODE_ADDONS",
          "PROVIDER_ONBOARDING_STEP_CODE_FIXED_PRICE_ADDONS"
        ],
        "default": "PROVIDER_ONBOARDING_STEP_CODE_UNSPECIFIED",
        "description": "Provider self-serve onboarding checklist (provider orgs only)."
      },
      "v1ProviderPlanPriceSort": {
        "type": "string",
        "enum": [
          "PROVIDER_PLAN_PRICE_SORT_UNSPECIFIED",
          "PROVIDER_PLAN_PRICE_SORT_LEAST_EXPENSIVE_FIRST",
          "PROVIDER_PLAN_PRICE_SORT_MOST_EXPENSIVE_FIRST"
        ],
        "default": "PROVIDER_PLAN_PRICE_SORT_UNSPECIFIED",
        "description": "Order for marketplace provider list by the plan price shown in the row (aligns with UI).\nWhen set, the first three providers from the default newest-first order stay pinned\nas Recommendations; only the remaining providers are ordered by list price.\n\n - PROVIDER_PLAN_PRICE_SORT_LEAST_EXPENSIVE_FIRST: Ascending among non-recommended providers: lowest list price first\n(usage: hourly, subscription: fixed monthly, free: 0)\n - PROVIDER_PLAN_PRICE_SORT_MOST_EXPENSIVE_FIRST: Descending among non-recommended providers: highest list price first"
      },
      "v1ProviderRevenueWaterfall": {
        "type": "object",
        "properties": {
          "grossSales": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "grossSalesSettled": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "platformFee": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "platformFeeSettled": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "stripeProcessingFee": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "currencyConversionFee": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "refunds": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "refundsSettled": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "netProfit": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "chargeCurrency": {
            "type": "string"
          },
          "settlementCurrency": {
            "type": "string"
          }
        }
      },
      "v1ProviderReviewBreakdown": {
        "type": "object",
        "properties": {
          "oneStar": {
            "type": "integer",
            "format": "int32"
          },
          "twoStar": {
            "type": "integer",
            "format": "int32"
          },
          "threeStar": {
            "type": "integer",
            "format": "int32"
          },
          "fourStar": {
            "type": "integer",
            "format": "int32"
          },
          "fiveStar": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ProviderReviewListItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "starRating": {
            "type": "integer",
            "format": "int32"
          },
          "comment": {
            "type": "string"
          },
          "providerReply": {
            "type": "string"
          },
          "createTime": {
            "type": "string",
            "format": "date-time"
          },
          "updateTime": {
            "type": "string",
            "format": "date-time"
          },
          "providerRepliedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "description": "Provider UI: list and respond to client reviews (no VM identifiers: anonymous to provider)."
      },
      "v1ProviderReviewStarSummary": {
        "type": "object",
        "properties": {
          "starRating": {
            "type": "integer",
            "format": "int32"
          },
          "reviewCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ProviderStripeActivityEvent": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string"
          },
          "at": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "v1ProviderStripePaymentMethodDetails": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "last4": {
            "type": "string"
          },
          "brand": {
            "type": "string"
          },
          "fingerprint": {
            "type": "string"
          },
          "expMonth": {
            "type": "integer",
            "format": "int32"
          },
          "expYear": {
            "type": "integer",
            "format": "int32"
          },
          "cardType": {
            "type": "string",
            "title": "e.g. visa credit card"
          },
          "issuer": {
            "type": "string"
          },
          "ownerName": {
            "type": "string"
          },
          "originCountry": {
            "type": "string"
          }
        }
      },
      "v1ProviderStripeTransaction": {
        "type": "object",
        "properties": {
          "paymentIntentId": {
            "type": "string"
          },
          "chargeId": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "amount": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "paymentMethodLast4": {
            "type": "string"
          },
          "paymentMethodBrand": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "customerId": {
            "type": "string"
          },
          "customerName": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "settlementMerchant": {
            "type": "string"
          },
          "transferredTo": {
            "type": "string"
          },
          "refundedAt": {
            "type": "string",
            "format": "date-time"
          },
          "declineReason": {
            "type": "string"
          },
          "paymentAmountSettled": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "exchangeRate": {
            "type": "string"
          },
          "platformFee": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "applicationFeeId": {
            "type": "string"
          },
          "stripeProcessingFee": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "currencyConversionFee": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "netAmount": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "activity": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ProviderStripeActivityEvent"
            }
          },
          "paymentMethodDetails": {
            "$ref": "#/components/schemas/v1ProviderStripePaymentMethodDetails"
          },
          "statementDescriptor": {
            "type": "string"
          },
          "feesTotalSettled": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          },
          "platformFeeSettled": {
            "$ref": "#/components/schemas/v1MoneyAmount"
          }
        }
      },
      "v1ProviderTicketNotificationPolicy": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "destinationEmail": {
            "type": "string"
          },
          "extraEmails": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "notifyOnCreated": {
            "type": "boolean"
          },
          "notifyOnClientReplied": {
            "type": "boolean"
          },
          "notifyOnEscalated": {
            "type": "boolean"
          },
          "notifyOnClosed": {
            "type": "boolean"
          },
          "includeMessageBody": {
            "type": "boolean"
          },
          "includeClientContact": {
            "type": "boolean"
          },
          "minPriority": {
            "$ref": "#/components/schemas/v1TicketPriority"
          },
          "effectiveDestinationEmail": {
            "type": "string",
            "description": "Resolved mailbox used when destination_email is empty (support_email fallback)."
          },
          "inboundRepliesEnabled": {
            "type": "boolean",
            "description": "True when NodeRings can accept helpdesk replies (inbound secret configured)."
          }
        }
      },
      "v1PublicStorefront": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "providerId": {
            "type": "string"
          },
          "organizationName": {
            "type": "string"
          },
          "tagline": {
            "type": "string"
          },
          "aboutHtml": {
            "type": "string"
          },
          "coverImageUrl": {
            "type": "string"
          },
          "logoImageUrl": {
            "type": "string",
            "description": "Approved storefront wordmark. Not the organization marketplace logo."
          },
          "highlightKeys": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "highlightCustom": {
            "type": "string"
          },
          "highlightCustomLines": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "featuredPlanIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "faqs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1StorefrontFAQ"
            }
          },
          "catalog": {
            "$ref": "#/components/schemas/v1ProviderDetails"
          },
          "reviews": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1StorefrontPublicReview"
            }
          },
          "socialUrls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "approvedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "v1PublicStorefrontCard": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "providerId": {
            "type": "string"
          },
          "organizationName": {
            "type": "string"
          },
          "providerLogoUrl": {
            "type": "string",
            "description": "Approved storefront wordmark. Not the organization marketplace logo."
          },
          "tagline": {
            "type": "string"
          },
          "rating": {
            "type": "number",
            "format": "float"
          },
          "totalReviews": {
            "type": "integer",
            "format": "int32"
          },
          "cities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "website": {
            "type": "string"
          }
        }
      },
      "v1PurchaseCreditsRequest": {
        "type": "object",
        "properties": {
          "amount": {
            "type": "string",
            "title": "Decimal string: USD amount to top-up"
          },
          "paymentMethodId": {
            "type": "string",
            "description": "Optional: payment method ID to charge. If omitted, the org's default\npayment method is used."
          }
        }
      },
      "v1PurchaseCreditsResponse": {
        "type": "object",
        "properties": {
          "clientSecret": {
            "type": "string",
            "title": "Stripe PaymentIntent client_secret for 3DS confirmation"
          },
          "creditPurchaseId": {
            "type": "string",
            "title": "CreditPurchase row id"
          },
          "paymentIntentId": {
            "type": "string",
            "title": "Stripe PaymentIntent id"
          },
          "requiresAction": {
            "type": "boolean",
            "title": "True if 3DS/SCA confirmation is needed client-side"
          }
        }
      },
      "v1ReadFileResponse": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string",
            "format": "byte"
          }
        }
      },
      "v1RecordUsageRequest": {
        "type": "object",
        "properties": {
          "subscriptionId": {
            "type": "string",
            "title": "Subscription reference"
          },
          "metricId": {
            "type": "string",
            "title": "Metric reference (either metric_id or metric_code must be provided)"
          },
          "metricCode": {
            "type": "string"
          },
          "quantity": {
            "type": "string",
            "description": "Decimal as string",
            "title": "Usage data"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "eventId": {
            "type": "string",
            "description": "For idempotent writes",
            "title": "Deduplication and metadata"
          },
          "properties": {
            "type": "object",
            "title": "Additional metadata (region, instance_id, etc.)"
          },
          "externalId": {
            "type": "string",
            "title": "External integration"
          }
        }
      },
      "v1RecordUsageResponse": {
        "type": "object",
        "properties": {
          "usageRecord": {
            "$ref": "#/components/schemas/v1UsageRecord"
          },
          "isDuplicate": {
            "type": "boolean",
            "title": "True if event_id already existed"
          }
        }
      },
      "v1RedeemPromoCodeRequest": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          }
        }
      },
      "v1RedeemPromoCodeResponse": {
        "type": "object",
        "properties": {
          "grantId": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "remaining": {
            "type": "string"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "v1RefreshTokenRequest": {
        "type": "object",
        "properties": {
          "refreshToken": {
            "type": "string"
          },
          "clientId": {
            "type": "string"
          },
          "clientSecret": {
            "type": "string",
            "title": "Optional for public clients"
          }
        }
      },
      "v1Refund": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "paymentId": {
            "type": "string",
            "title": "Payment this refund is for"
          },
          "refundStatus": {
            "$ref": "#/components/schemas/v1RefundStatus"
          },
          "amount": {
            "type": "string",
            "title": "Decimal string with 6 decimal places precision"
          },
          "currency": {
            "type": "string",
            "title": "Currency code (ISO 4217)"
          },
          "providerRefundId": {
            "type": "string",
            "title": "Payment provider refund ID (e.g.,"
          },
          "paymentProvider": {
            "type": "string",
            "description": "Payment provider name (e.g., 'stripe', 'paypal')",
            "title": "Stripe refund.id, PayPal refund.id)"
          },
          "failureReason": {
            "type": "string",
            "title": "Reason for refund failure (if applicable)"
          },
          "processedAt": {
            "type": "string",
            "format": "date-time",
            "title": "When refund was processed"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        },
        "title": "Refund represents a refund transaction for a payment"
      },
      "v1RefundStatus": {
        "type": "string",
        "enum": [
          "REFUND_STATUS_UNSPECIFIED",
          "REFUND_STATUS_PENDING",
          "REFUND_STATUS_PROCESSING",
          "REFUND_STATUS_SUCCEEDED",
          "REFUND_STATUS_FAILED",
          "REFUND_STATUS_CANCELED"
        ],
        "default": "REFUND_STATUS_UNSPECIFIED"
      },
      "v1RegenerateMfaBackupCodesRequest": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          }
        }
      },
      "v1RegenerateMfaBackupCodesResponse": {
        "type": "object",
        "properties": {
          "backupCodes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1Region": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "organizationId": {
            "type": "string"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "cityCountry": {
            "$ref": "#/components/schemas/v1CityCountry"
          },
          "datacenter": {
            "$ref": "#/components/schemas/v1Datacenter"
          }
        }
      },
      "v1RegionLocation": {
        "type": "object",
        "properties": {
          "country": {
            "type": "string",
            "title": "Country name"
          },
          "city": {
            "type": "string",
            "title": "City name"
          }
        },
        "title": "Region location information (deduplicated city+country combinations)"
      },
      "v1RegisterUserRequest": {
        "type": "object",
        "properties": {
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "password": {
            "type": "string"
          },
          "turnstileToken": {
            "type": "string",
            "description": "Cloudflare Turnstile token from the client widget (optional unless auth.turnstile is enabled)."
          }
        }
      },
      "v1ReinstallStatus": {
        "type": "string",
        "enum": [
          "REINSTALL_STATUS_UNSPECIFIED",
          "REINSTALL_STATUS_NONE",
          "REINSTALL_STATUS_REQUESTED",
          "REINSTALL_STATUS_DELETING",
          "REINSTALL_STATUS_PROVISIONING",
          "REINSTALL_STATUS_COMPLETED",
          "REINSTALL_STATUS_FAILED"
        ],
        "default": "REINSTALL_STATUS_UNSPECIFIED"
      },
      "v1RemoveAddonResponse": {
        "type": "object",
        "properties": {
          "addonSubscription": {
            "$ref": "#/components/schemas/v1AddonSubscription"
          }
        }
      },
      "v1RemovePaymentMethodResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      },
      "v1ReplaceRoleForGroupRequest": {
        "type": "object",
        "properties": {
          "roleId": {
            "type": "string"
          },
          "groupId": {
            "type": "string"
          }
        }
      },
      "v1ReplaceRoleForServiceAccountRequest": {
        "type": "object",
        "properties": {
          "roleId": {
            "type": "string"
          },
          "serviceAccountId": {
            "type": "string"
          }
        }
      },
      "v1ReplaceRoleForUserRequest": {
        "type": "object",
        "properties": {
          "roleId": {
            "type": "string"
          },
          "userId": {
            "type": "string"
          }
        }
      },
      "v1ResendVerificationEmailRequest": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string"
          },
          "turnstileToken": {
            "type": "string",
            "description": "Cloudflare Turnstile token from the client widget (optional unless auth.turnstile is enabled)."
          }
        }
      },
      "v1ResetPasswordRequest": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string"
          },
          "resetToken": {
            "type": "string"
          },
          "newPassword": {
            "type": "string"
          }
        }
      },
      "v1ResourceInstanceInput": {
        "type": "object",
        "properties": {
          "quantity": {
            "type": "integer",
            "format": "int32"
          },
          "hoursUsed": {
            "type": "number",
            "format": "double"
          },
          "region": {
            "type": "string"
          },
          "usage": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "format": "double"
            },
            "title": "Usage metrics (e.g., {\"vCPU\": 2, \"RAM_GB\": 4, \"Egress_GB\": 1200})"
          },
          "addons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1AddonInput"
            },
            "title": "Add-ons"
          }
        }
      },
      "v1RestoreStatus": {
        "type": "string",
        "enum": [
          "RESTORE_STATUS_UNSPECIFIED",
          "RESTORE_STATUS_NONE",
          "RESTORE_STATUS_REQUESTED",
          "RESTORE_STATUS_RESTORING",
          "RESTORE_STATUS_COMPLETED",
          "RESTORE_STATUS_FAILED"
        ],
        "default": "RESTORE_STATUS_UNSPECIFIED",
        "title": "RestoreStatus represents the restore status of a backup or snapshot"
      },
      "v1RetryPaymentRequest": {
        "type": "object",
        "properties": {
          "subscriptionId": {
            "type": "string",
            "title": "Optional: subscription ID to retry payment for\nIf not provided, retries payment for the user's active subscription"
          },
          "paymentMethodId": {
            "type": "string",
            "title": "Optional: payment method ID to use for retry\nIf not provided, uses the default payment method"
          }
        }
      },
      "v1RetryPaymentResponse": {
        "type": "object",
        "properties": {
          "subscription": {
            "$ref": "#/components/schemas/v1Subscription"
          },
          "transactionId": {
            "type": "string",
            "title": "Transaction ID from payment provider (available after task completes)"
          },
          "paymentStatus": {
            "type": "string",
            "title": "Payment status (available after task completes)"
          },
          "taskId": {
            "type": "string",
            "title": "Task ID for tracking async payment retry processing"
          }
        }
      },
      "v1RevokeCouponResponse": {
        "type": "object",
        "properties": {
          "coupon": {
            "$ref": "#/components/schemas/v1Coupon"
          },
          "revokedApplications": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1RevokeTokenRequest": {
        "type": "object",
        "properties": {
          "token": {
            "type": "string"
          },
          "tokenTypeHint": {
            "type": "string",
            "title": "\"access_token\" or \"refresh_token\""
          },
          "clientId": {
            "type": "string"
          }
        }
      },
      "v1RoadmapFeatureRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/v1RoadmapRequestStatus"
          },
          "product": {
            "$ref": "#/components/schemas/v1RoadmapProductCategory"
          },
          "voteScore": {
            "type": "integer",
            "format": "int32"
          },
          "upvoteCount": {
            "type": "integer",
            "format": "int32"
          },
          "commentCount": {
            "type": "integer",
            "format": "int32"
          },
          "authorDisplayName": {
            "type": "string"
          },
          "assigneeName": {
            "type": "string"
          },
          "isPinned": {
            "type": "boolean"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "statusChangedAt": {
            "type": "string",
            "format": "date-time"
          },
          "userVote": {
            "$ref": "#/components/schemas/v1RoadmapVoteType"
          }
        }
      },
      "v1RoadmapFeatureRequestComment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "body": {
            "type": "string"
          },
          "authorDisplayName": {
            "type": "string"
          },
          "isEdited": {
            "type": "boolean"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "isOwn": {
            "type": "boolean"
          },
          "canEdit": {
            "type": "boolean"
          }
        }
      },
      "v1RoadmapProductCategory": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "color": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1RoadmapProductStats": {
        "type": "object",
        "properties": {
          "productSlug": {
            "type": "string"
          },
          "productName": {
            "type": "string"
          },
          "inReview": {
            "type": "integer",
            "format": "int32"
          },
          "planned": {
            "type": "integer",
            "format": "int32"
          },
          "inProgress": {
            "type": "integer",
            "format": "int32"
          },
          "completed": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1RoadmapRequestStatus": {
        "type": "string",
        "enum": [
          "ROADMAP_REQUEST_STATUS_UNSPECIFIED",
          "ROADMAP_REQUEST_STATUS_IN_REVIEW",
          "ROADMAP_REQUEST_STATUS_PLANNED",
          "ROADMAP_REQUEST_STATUS_IN_PROGRESS",
          "ROADMAP_REQUEST_STATUS_COMPLETED",
          "ROADMAP_REQUEST_STATUS_DECLINED"
        ],
        "default": "ROADMAP_REQUEST_STATUS_UNSPECIFIED"
      },
      "v1RoadmapVoteType": {
        "type": "string",
        "enum": [
          "ROADMAP_VOTE_TYPE_UNSPECIFIED",
          "ROADMAP_VOTE_TYPE_UP"
        ],
        "default": "ROADMAP_VOTE_TYPE_UNSPECIFIED"
      },
      "v1Role": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "isBuiltin": {
            "type": "boolean"
          },
          "organizationId": {
            "type": "string",
            "title": "Relations"
          },
          "permissions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "groupIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "users": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1UserSummary"
            }
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1RuleEffect": {
        "type": "string",
        "enum": [
          "RULE_EFFECT_UNSPECIFIED",
          "RULE_EFFECT_ENABLE",
          "RULE_EFFECT_ENTITLE",
          "RULE_EFFECT_LIMIT"
        ],
        "default": "RULE_EFFECT_UNSPECIFIED",
        "description": "- RULE_EFFECT_ENABLE: Feature toggle: true/false (use false to disable)\n - RULE_EFFECT_ENTITLE: Entitlement: granted\n - RULE_EFFECT_LIMIT: Limit: numeric ceiling",
        "title": "RuleEffect represents the effect type of a rule"
      },
      "v1Rules": {
        "type": "object",
        "properties": {
          "ruleKey": {
            "type": "string",
            "title": "Rule key (e.g., \"organization.max_members\", \"secrets.enabled\")"
          },
          "effect": {
            "$ref": "#/components/schemas/v1RuleEffect"
          },
          "boolValue": {
            "type": "boolean",
            "title": "Boolean value for ENABLE/ENTITLE effects"
          },
          "int64Value": {
            "type": "string",
            "format": "int64",
            "title": "Numeric value for LIMIT effect"
          },
          "currentUsage": {
            "type": "string",
            "format": "int64",
            "title": "Optional: current usage count (only for LIMIT rules)"
          }
        },
        "title": "RuleStatus represents the status of a rule from the ruleset"
      },
      "v1SSHKey": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "publicKey": {
            "type": "string"
          },
          "keyType": {
            "type": "string",
            "description": "rsa, ed25519, ecdsa, dsa, etc."
          },
          "name": {
            "type": "string"
          },
          "fingerprint": {
            "type": "string"
          },
          "organizationId": {
            "type": "string"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        },
        "title": "SSH Key messages"
      },
      "v1ScanDnsZoneRecordsResponse": {
        "type": "object",
        "properties": {
          "records": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1DnsRecord"
            }
          }
        }
      },
      "v1SearchMarketplaceRequest": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "filterBillingType": {
            "$ref": "#/components/schemas/v1BillingType"
          },
          "turnstileToken": {
            "type": "string",
            "description": "Cloudflare Turnstile token (required for anonymous callers when auth.turnstile.requireOnAnonymousMarketplaceSearch)."
          }
        },
        "description": "Natural-language marketplace search (anonymous landing page)."
      },
      "v1SearchMarketplaceResponse": {
        "type": "object",
        "properties": {
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1MarketplaceSearchResult"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "parsedQuery": {
            "$ref": "#/components/schemas/v1MarketplaceSearchParsedQuery"
          },
          "appliedBillingType": {
            "$ref": "#/components/schemas/v1BillingType"
          }
        }
      },
      "v1SearchTicketsRequest": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "filterTicketStatus": {
            "$ref": "#/components/schemas/v1TicketStatus"
          },
          "filterCaseType": {
            "$ref": "#/components/schemas/v1CaseType"
          },
          "filterPriority": {
            "$ref": "#/components/schemas/v1TicketPriority"
          },
          "includeHighlights": {
            "type": "boolean"
          }
        }
      },
      "v1SearchTicketsResponse": {
        "type": "object",
        "properties": {
          "tickets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Ticket"
            }
          },
          "userDetails": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/v1UserDetails"
            },
            "title": "Map of user ID to user details (first_name, last_name)"
          },
          "organizationDetails": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/v1OrganizationDetails"
            },
            "title": "Map of organization ID to organization name"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "highlights": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/v1TicketSearchHighlight"
            },
            "title": "Map of ticket ID to highlighted snippets"
          }
        }
      },
      "v1Secret": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "key": {
            "type": "string"
          },
          "user": {
            "type": "string",
            "title": "Relations"
          },
          "organization": {
            "type": "string"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1ServiceAccountResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "isActive": {
            "type": "boolean"
          },
          "allowedIps": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "organizationId": {
            "type": "string"
          },
          "createdByUserId": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "lastUsedAt": {
            "type": "string",
            "format": "date-time"
          },
          "activeTokenCount": {
            "type": "integer",
            "format": "int32"
          },
          "groupIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "roleIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1ServiceAccountTokenInfo": {
        "type": "object",
        "properties": {
          "tokenId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "lastUsedAt": {
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "type": "string"
          },
          "createdByUserId": {
            "type": "string"
          },
          "expiresInDays": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1ServiceStatus": {
        "type": "string",
        "enum": [
          "SERVICE_STATUS_UNSPECIFIED",
          "SERVICE_STATUS_ONLINE",
          "SERVICE_STATUS_OFFLINE",
          "SERVICE_STATUS_MAINTENANCE"
        ],
        "default": "SERVICE_STATUS_UNSPECIFIED"
      },
      "v1ServingStatus": {
        "type": "string",
        "enum": [
          "UNKNOWN",
          "SERVING",
          "NOT_SERVING"
        ],
        "default": "UNKNOWN"
      },
      "v1SessionInfo": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "realIp": {
            "type": "string"
          },
          "requestIp": {
            "type": "string"
          },
          "browser": {
            "type": "string"
          },
          "lastLogin": {
            "type": "string"
          },
          "os": {
            "type": "string"
          },
          "deviceType": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "isCurrentSession": {
            "type": "boolean"
          }
        }
      },
      "v1SetDefaultPaymentMethodResponse": {
        "type": "object",
        "properties": {
          "paymentMethod": {
            "$ref": "#/components/schemas/v1PaymentMethod"
          }
        }
      },
      "v1SetGameNestOrderingRequest": {
        "type": "object",
        "properties": {
          "platformId": {
            "type": "string"
          },
          "catalogKey": {
            "type": "string"
          },
          "orderingEnabled": {
            "type": "boolean"
          }
        }
      },
      "v1SetPasswordRequest": {
        "type": "object",
        "properties": {
          "newPassword": {
            "type": "string"
          }
        },
        "description": "SetPassword is for passwordless (SSO-only) accounts that have never set a local password."
      },
      "v1SmtpOutboundProviderPolicy": {
        "type": "object",
        "properties": {
          "blockByDefault": {
            "type": "boolean"
          }
        }
      },
      "v1SmtpOutboundVmAction": {
        "type": "string",
        "enum": [
          "SMTP_OUTBOUND_VM_ACTION_UNSPECIFIED",
          "SMTP_OUTBOUND_VM_ACTION_INHERIT",
          "SMTP_OUTBOUND_VM_ACTION_ALLOW",
          "SMTP_OUTBOUND_VM_ACTION_BLOCK"
        ],
        "default": "SMTP_OUTBOUND_VM_ACTION_UNSPECIFIED"
      },
      "v1Snapshot": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true
          },
          "name": {
            "type": "string",
            "readOnly": true
          },
          "snapshotId": {
            "type": "string",
            "readOnly": true
          },
          "virtualMachineId": {
            "type": "string",
            "readOnly": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "snapshotStatus": {
            "$ref": "#/components/schemas/v1SnapshotStatus"
          },
          "restoreStatus": {
            "$ref": "#/components/schemas/v1RestoreStatus"
          },
          "operationStatus": {
            "$ref": "#/components/schemas/v1SnapshotOperationStatus"
          },
          "restoredAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "description": {
            "type": "string",
            "readOnly": true
          },
          "lastRestore": {
            "$ref": "#/components/schemas/v1LastRestore"
          },
          "metadata": {
            "type": "object"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        },
        "title": "Snapshot represents a snapshot of a virtual machine"
      },
      "v1SnapshotOperationStatus": {
        "type": "string",
        "enum": [
          "SNAPSHOT_OPERATION_STATUS_UNSPECIFIED",
          "SNAPSHOT_OPERATION_STATUS_PENDING",
          "SNAPSHOT_OPERATION_STATUS_PROCESSING",
          "SNAPSHOT_OPERATION_STATUS_COMPLETED",
          "SNAPSHOT_OPERATION_STATUS_FAILED"
        ],
        "default": "SNAPSHOT_OPERATION_STATUS_UNSPECIFIED",
        "title": "SnapshotOperationStatus represents the status of snapshot creation operation"
      },
      "v1SnapshotStatus": {
        "type": "string",
        "enum": [
          "SNAPSHOT_STATUS_UNSPECIFIED",
          "SNAPSHOT_STATUS_ACTIVE",
          "SNAPSHOT_STATUS_DELETED",
          "SNAPSHOT_STATUS_EXPIRED",
          "SNAPSHOT_STATUS_UNKNOWN"
        ],
        "default": "SNAPSHOT_STATUS_UNSPECIFIED",
        "title": "SnapshotStatus represents the status of a snapshot"
      },
      "v1StartConnectOAuthRequest": {
        "type": "object"
      },
      "v1StartConnectOAuthResponse": {
        "type": "object",
        "properties": {
          "authorizeUrl": {
            "type": "string",
            "title": "Stripe OAuth authorize URL (single-use state)"
          }
        }
      },
      "v1StartPlanLiveValidationResponse": {
        "type": "object",
        "properties": {
          "runId": {
            "type": "string"
          },
          "status": {
            "type": "string"
          }
        }
      },
      "v1StartupVariable": {
        "type": "object",
        "properties": {
          "envVariable": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "serverValue": {
            "type": "string"
          },
          "userViewable": {
            "type": "boolean"
          },
          "userEditable": {
            "type": "boolean"
          },
          "rules": {
            "type": "string"
          }
        }
      },
      "v1StoragePool": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "storage": {
            "type": "integer",
            "format": "int32"
          },
          "storageAllocated": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "v1StorefrontFAQ": {
        "type": "object",
        "properties": {
          "question": {
            "type": "string"
          },
          "answer": {
            "type": "string"
          }
        }
      },
      "v1StorefrontParticipationStatus": {
        "type": "string",
        "enum": [
          "STOREFRONT_PARTICIPATION_STATUS_UNSPECIFIED",
          "STOREFRONT_PARTICIPATION_STATUS_NOT_PARTICIPATING",
          "STOREFRONT_PARTICIPATION_STATUS_DRAFT",
          "STOREFRONT_PARTICIPATION_STATUS_PENDING_APPROVAL",
          "STOREFRONT_PARTICIPATION_STATUS_LIVE",
          "STOREFRONT_PARTICIPATION_STATUS_LIVE_CHANGES_PENDING",
          "STOREFRONT_PARTICIPATION_STATUS_OPTED_OUT"
        ],
        "default": "STOREFRONT_PARTICIPATION_STATUS_UNSPECIFIED"
      },
      "v1StorefrontPublicReview": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "starRating": {
            "type": "integer",
            "format": "int32"
          },
          "comment": {
            "type": "string"
          },
          "providerReply": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "providerRepliedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "v1StorefrontRevision": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/v1StorefrontRevisionStatus"
          },
          "proposedSlug": {
            "type": "string"
          },
          "tagline": {
            "type": "string"
          },
          "aboutMarkdown": {
            "type": "string"
          },
          "aboutHtml": {
            "type": "string"
          },
          "coverImageUrl": {
            "type": "string"
          },
          "logoImageUrl": {
            "type": "string"
          },
          "highlightKeys": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "highlightCustom": {
            "type": "string"
          },
          "highlightCustomLines": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "featuredPlanIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "faqs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1StorefrontFAQ"
            }
          },
          "submittedAt": {
            "type": "string",
            "format": "date-time"
          },
          "approvedAt": {
            "type": "string",
            "format": "date-time"
          },
          "rejectReason": {
            "type": "string"
          }
        }
      },
      "v1StorefrontRevisionStatus": {
        "type": "string",
        "enum": [
          "STOREFRONT_REVISION_STATUS_UNSPECIFIED",
          "STOREFRONT_REVISION_STATUS_DRAFT",
          "STOREFRONT_REVISION_STATUS_PENDING_REVIEW",
          "STOREFRONT_REVISION_STATUS_APPROVED",
          "STOREFRONT_REVISION_STATUS_REJECTED",
          "STOREFRONT_REVISION_STATUS_SUPERSEDED"
        ],
        "default": "STOREFRONT_REVISION_STATUS_UNSPECIFIED",
        "description": "Public provider storefront (anonymous). Copy is always the latest approved revision."
      },
      "v1SubmitRoadmapFeatureRequestRequest": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "productSlug": {
            "type": "string"
          }
        }
      },
      "v1SubmitRoadmapFeatureRequestResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "v1SubscribeResponse": {
        "type": "object",
        "properties": {
          "subscription": {
            "$ref": "#/components/schemas/v1Subscription"
          }
        }
      },
      "v1Subscription": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "startDate": {
            "type": "string",
            "format": "date-time"
          },
          "trialEndDate": {
            "type": "string",
            "format": "date-time"
          },
          "currentPeriodStart": {
            "type": "string",
            "format": "date-time"
          },
          "currentPeriodEnd": {
            "type": "string",
            "format": "date-time"
          },
          "canceledAt": {
            "type": "string",
            "format": "date-time"
          },
          "subscriptionStatus": {
            "$ref": "#/components/schemas/v1SubscriptionStatus"
          },
          "cancelAtPeriodEnd": {
            "type": "boolean"
          },
          "quantity": {
            "type": "integer",
            "format": "int32",
            "title": "Quantity of this subscription item (e.g., number of VMs,"
          },
          "organization": {
            "type": "string",
            "title": "Relations"
          },
          "organizationName": {
            "type": "string"
          },
          "activatedByUser": {
            "type": "string"
          },
          "activatedByServiceAccount": {
            "type": "string",
            "description": "Service account that started this subscription. Empty when a user did, or when neither is recorded."
          },
          "plan": {
            "type": "string"
          },
          "planName": {
            "type": "string"
          },
          "planCode": {
            "type": "string",
            "description": "Plan catalog code (e.g. SC-GC-1C-1G-20) for display alongside plan_name."
          },
          "resourceHostname": {
            "type": "string",
            "description": "Primary linked VM hostname for client compute subscriptions (empty otherwise)."
          },
          "resourceProviderName": {
            "type": "string",
            "description": "Provider organization name for the linked VM (empty when not applicable)."
          },
          "resourceVmId": {
            "type": "string",
            "description": "Linked VM id for navigation (empty when not applicable)."
          },
          "resourceRegionName": {
            "type": "string",
            "description": "Region label for the linked VM (e.g. city and country, or datacenter name)."
          },
          "resourceCpu": {
            "type": "integer",
            "format": "int32",
            "description": "Linked VM resource snapshot for display (0 when not applicable)."
          },
          "resourceMemory": {
            "type": "integer",
            "format": "int32"
          },
          "resourceStorage": {
            "type": "integer",
            "format": "int32"
          },
          "planBillingPeriod": {
            "$ref": "#/components/schemas/v1BillingPeriod"
          },
          "recurringAmount": {
            "type": "string",
            "description": "Bound catalog amount for the current period (plan unit price × quantity). Empty when unknown."
          },
          "currency": {
            "type": "string",
            "description": "ISO currency for recurring_amount (e.g. USD)."
          },
          "billingType": {
            "$ref": "#/components/schemas/v1BillingType"
          },
          "pricingModel": {
            "$ref": "#/components/schemas/v1PricingModel"
          },
          "hasUsageCharges": {
            "type": "boolean",
            "description": "True when the bound plan also has metered/usage prices (bandwidth, compute hours, etc.)."
          },
          "addonSubscriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1AddonSubscription"
            },
            "description": "Active add-on subscriptions on this subscription (name, quantity, and catalog price)."
          },
          "platformFeeId": {
            "type": "string",
            "description": "Platform fee ID if applicable",
            "title": "Platform fee (only for provider organizations)"
          },
          "platformFeeType": {
            "type": "string",
            "title": "Platform fee type (percentage, fixed, etc.)"
          },
          "platformFeePercent": {
            "type": "number",
            "format": "double",
            "title": "Platform fee percentage (e.g., 10.0 for 10%)"
          },
          "platformFeeCurrency": {
            "type": "string",
            "title": "Currency for platform fee"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1SubscriptionCoupon": {
        "type": "object",
        "properties": {
          "applicationId": {
            "type": "string"
          },
          "subscriptionId": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "termsSummary": {
            "type": "string",
            "description": "Disclosure text the customer accepted."
          },
          "status": {
            "$ref": "#/components/schemas/v1CouponApplicationStatus"
          },
          "periodsRemaining": {
            "type": "integer",
            "format": "int32"
          },
          "windowEndsAt": {
            "type": "string",
            "format": "date-time"
          },
          "appliedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "description": "The coupon attached to one subscription."
      },
      "v1SubscriptionStatus": {
        "type": "string",
        "enum": [
          "SUBSCRIPTION_STATUS_UNSPECIFIED",
          "SUBSCRIPTION_STATUS_TRIALING",
          "SUBSCRIPTION_STATUS_ACTIVE",
          "SUBSCRIPTION_STATUS_PAST_DUE",
          "SUBSCRIPTION_STATUS_CANCELED",
          "SUBSCRIPTION_STATUS_PAUSED"
        ],
        "default": "SUBSCRIPTION_STATUS_UNSPECIFIED"
      },
      "v1SuccessResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      },
      "v1Ticket": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "ticketId": {
            "type": "string",
            "format": "int64"
          },
          "title": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "ticketStatus": {
            "$ref": "#/components/schemas/v1TicketStatus"
          },
          "caseType": {
            "$ref": "#/components/schemas/v1CaseType"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "replies": {
            "type": "string",
            "title": "Relations"
          },
          "fromOrganization": {
            "type": "string"
          },
          "fromUser": {
            "type": "string"
          },
          "toOrganization": {
            "type": "string"
          },
          "toUser": {
            "type": "string"
          },
          "virtualMachines": {
            "type": "string"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "priority": {
            "$ref": "#/components/schemas/v1TicketPriority"
          },
          "assignedToUser": {
            "type": "string"
          },
          "firstResponseAt": {
            "type": "string",
            "format": "date-time"
          },
          "firstResponseTimeSeconds": {
            "type": "string",
            "format": "int64"
          },
          "resolvedAt": {
            "type": "string",
            "format": "date-time"
          },
          "resolutionTimeSeconds": {
            "type": "string",
            "format": "int64"
          },
          "lastActivityAt": {
            "type": "string",
            "format": "date-time"
          },
          "lockedByUser": {
            "type": "string"
          },
          "lockedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "v1TicketAttachment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "ticketId": {
            "type": "string"
          },
          "fileName": {
            "type": "string"
          },
          "fileSize": {
            "type": "string",
            "format": "int64"
          },
          "mimeType": {
            "type": "string"
          },
          "uploadedByUserId": {
            "type": "string"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1TicketInternalComment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "ticketId": {
            "type": "string"
          },
          "comment": {
            "type": "string"
          },
          "createdByUserId": {
            "type": "string"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1TicketMessage": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Ticket ID (same for original, different for each reply)"
          },
          "sequence": {
            "type": "string",
            "format": "int64",
            "title": "Order in the thread (0 for original, 1+ for replies, based on creation time)"
          },
          "message": {
            "type": "string",
            "title": "The message content"
          },
          "fromUser": {
            "type": "string",
            "title": "User who sent this message"
          },
          "fromOrganization": {
            "type": "string",
            "title": "Organization of the user who sent this message"
          },
          "toUser": {
            "type": "string",
            "title": "User who should receive this message"
          },
          "toOrganization": {
            "type": "string",
            "title": "Organization of the recipient"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "isReply": {
            "type": "boolean",
            "title": "True if this is a reply, false if it's the original message"
          }
        },
        "title": "TicketMessage represents a single message in a ticket thread\nThis includes both the original ticket message and all replies"
      },
      "v1TicketPriority": {
        "type": "string",
        "enum": [
          "TICKET_PRIORITY_UNSPECIFIED",
          "TICKET_PRIORITY_LOW",
          "TICKET_PRIORITY_NORMAL",
          "TICKET_PRIORITY_HIGH",
          "TICKET_PRIORITY_URGENT",
          "TICKET_PRIORITY_CRITICAL"
        ],
        "default": "TICKET_PRIORITY_UNSPECIFIED"
      },
      "v1TicketSearchHighlight": {
        "type": "object",
        "properties": {
          "ticketId": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "v1TicketStatus": {
        "type": "string",
        "enum": [
          "TICKET_STATUS_UNSPECIFIED",
          "TICKET_STATUS_IN_PROGRESS",
          "TICKET_STATUS_ESCALATED",
          "TICKET_STATUS_PENDING",
          "TICKET_STATUS_AWAITING_REPLY",
          "TICKET_STATUS_RESOLVED",
          "TICKET_STATUS_WONT_FIX",
          "TICKET_STATUS_DUPLICATE",
          "TICKET_STATUS_NOT_REPRODUCIBLE"
        ],
        "default": "TICKET_STATUS_UNSPECIFIED"
      },
      "v1TicketTemplate": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "caseType": {
            "$ref": "#/components/schemas/v1CaseType"
          },
          "titleTemplate": {
            "type": "string"
          },
          "messageTemplate": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "isActive": {
            "type": "boolean"
          },
          "createdByUserId": {
            "type": "string"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "variables": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1TicketTemplateInput": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "caseType": {
            "$ref": "#/components/schemas/v1CaseType"
          },
          "titleTemplate": {
            "type": "string"
          },
          "messageTemplate": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "isActive": {
            "type": "boolean"
          }
        }
      },
      "v1TicketTemplateVariableDefinition": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "required": {
            "type": "boolean"
          },
          "source": {
            "type": "string"
          },
          "example": {
            "type": "string"
          }
        }
      },
      "v1TierMode": {
        "type": "string",
        "enum": [
          "TIER_MODE_UNSPECIFIED",
          "TIER_MODE_NONE",
          "TIER_MODE_VOLUME",
          "TIER_MODE_TIERED",
          "TIER_MODE_GRADUATED"
        ],
        "default": "TIER_MODE_UNSPECIFIED"
      },
      "v1Timestamps": {
        "type": "object",
        "properties": {
          "createTime": {
            "type": "string",
            "format": "date-time"
          },
          "updateTime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "title": "Object details"
      },
      "v1TokenRequest": {
        "type": "object",
        "properties": {
          "grantType": {
            "type": "string"
          },
          "code": {
            "type": "string",
            "title": "Required for authorization_code grant"
          },
          "redirectUri": {
            "type": "string",
            "title": "Required for authorization_code grant"
          },
          "clientId": {
            "type": "string"
          },
          "clientSecret": {
            "type": "string",
            "title": "Optional for public clients"
          },
          "codeVerifier": {
            "type": "string",
            "title": "Required for PKCE"
          },
          "refreshToken": {
            "type": "string",
            "title": "Required for refresh_token grant"
          }
        }
      },
      "v1TokenResponse": {
        "type": "object",
        "properties": {
          "accessToken": {
            "type": "string"
          },
          "tokenType": {
            "type": "string",
            "title": "\"Bearer\""
          },
          "expiresIn": {
            "type": "string",
            "format": "int64",
            "title": "Seconds until expiry"
          },
          "refreshToken": {
            "type": "string"
          },
          "scope": {
            "type": "string"
          }
        }
      },
      "v1UndoCancelRenewalRequest": {
        "type": "object",
        "properties": {
          "subscriptionId": {
            "type": "string"
          }
        }
      },
      "v1UpdateAgentResponse": {
        "type": "object",
        "properties": {
          "agent": {
            "$ref": "#/components/schemas/v1Agent"
          }
        }
      },
      "v1UpdateClientReviewResponse": {
        "type": "object",
        "properties": {
          "review": {
            "$ref": "#/components/schemas/v1ClientProviderReview"
          }
        }
      },
      "v1UpdateCloudInitTemplateResponse": {
        "type": "object",
        "properties": {
          "cloudInitTemplate": {
            "$ref": "#/components/schemas/v1CloudInitTemplate"
          }
        }
      },
      "v1UpdateConnectTaxSettingsRequest": {
        "type": "object",
        "properties": {
          "headOffice": {
            "$ref": "#/components/schemas/v1ConnectTaxAddress"
          },
          "defaultTaxCode": {
            "type": "string"
          },
          "defaultTaxBehavior": {
            "type": "string"
          }
        }
      },
      "v1UpdateConnectTaxSettingsResponse": {
        "type": "object",
        "properties": {
          "settings": {
            "$ref": "#/components/schemas/v1ConnectTaxSettingsDetails"
          }
        }
      },
      "v1UpdateGroupResponse": {
        "type": "object",
        "properties": {
          "group": {
            "$ref": "#/components/schemas/v1Group"
          }
        }
      },
      "v1UpdateInviteRequest": {
        "type": "object",
        "properties": {
          "inviteId": {
            "type": "string"
          },
          "roleId": {
            "type": "string"
          },
          "groupId": {
            "type": "string"
          }
        }
      },
      "v1UpdateMyStorefrontRequest": {
        "type": "object",
        "properties": {
          "proposedSlug": {
            "type": "string"
          },
          "tagline": {
            "type": "string"
          },
          "aboutMarkdown": {
            "type": "string"
          },
          "coverImageUrl": {
            "type": "string"
          },
          "logoImageUrl": {
            "type": "string"
          },
          "highlightKeys": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "highlightCustom": {
            "type": "string"
          },
          "highlightCustomLines": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "featuredPlanIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "faqs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1StorefrontFAQ"
            }
          }
        }
      },
      "v1UpdateNetworkResponse": {
        "type": "object",
        "properties": {
          "network": {
            "$ref": "#/components/schemas/v1Network"
          }
        }
      },
      "v1UpdateNodePlacementPolicyRequest": {
        "type": "object",
        "properties": {
          "defaultStrategy": {
            "$ref": "#/components/schemas/v1NodePlacementStrategy"
          },
          "regionOverrides": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1NodePlacementRegionOverride"
            }
          }
        }
      },
      "v1UpdateNodePlacementPolicyResponse": {
        "type": "object",
        "properties": {
          "policy": {
            "$ref": "#/components/schemas/v1NodePlacementPolicy"
          }
        }
      },
      "v1UpdateNodeResponse": {
        "type": "object",
        "properties": {
          "node": {
            "$ref": "#/components/schemas/v1Node"
          }
        }
      },
      "v1UpdateNotificationSettingResponse": {
        "type": "object",
        "properties": {
          "notificationSetting": {
            "$ref": "#/components/schemas/v1NotificationSetting"
          }
        }
      },
      "v1UpdateNotificationTemplateResponse": {
        "type": "object",
        "properties": {
          "notificationTemplate": {
            "$ref": "#/components/schemas/v1NotificationTemplate"
          }
        }
      },
      "v1UpdateOrganizationRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "enforceMfa": {
            "type": "boolean"
          },
          "enforceVerifiedDomain": {
            "type": "boolean"
          },
          "enforceSso": {
            "type": "boolean"
          },
          "asn": {
            "type": "string",
            "format": "int64"
          },
          "providerLogoUrl": {
            "type": "string"
          },
          "ddosProvider": {
            "type": "string"
          },
          "providerWebsiteUrl": {
            "type": "string"
          },
          "address": {
            "type": "string"
          },
          "taxId": {
            "type": "string"
          },
          "accountHolderName": {
            "type": "string"
          },
          "supportEmail": {
            "type": "string"
          },
          "supportPhone": {
            "type": "string"
          },
          "addressLine1": {
            "type": "string"
          },
          "addressLine2": {
            "type": "string"
          },
          "addressCity": {
            "type": "string"
          },
          "addressRegion": {
            "type": "string"
          },
          "addressPostcode": {
            "type": "string"
          },
          "addressCountry": {
            "type": "string",
            "description": "ISO 3166-1 alpha-2 (e.g. US, DE)."
          },
          "vatId": {
            "type": "string"
          },
          "billingEmail": {
            "type": "string"
          },
          "socialAccountsJson": {
            "type": "string",
            "description": "JSON array of up to 4 objects: [{\"platform\":\"x\",\"url\":\"https://...\"}, ...].\nplatform must be one of: x, linkedin, instagram, facebook (Facebook/Meta)."
          }
        }
      },
      "v1UpdateOrganizationResponse": {
        "type": "object",
        "properties": {
          "organization": {
            "$ref": "#/components/schemas/v1Organization"
          }
        }
      },
      "v1UpdatePayoutConfigurationRequest": {
        "type": "object",
        "properties": {
          "scheduleType": {
            "$ref": "#/components/schemas/v1PayoutScheduleType"
          },
          "scheduleTime": {
            "type": "string",
            "title": "Required for daily/weekly/monthly, ignored for immediate. Format: HH:MM (24-hour)"
          },
          "scheduleTimezone": {
            "type": "string",
            "title": "IANA timezone - defaults to \"UTC\""
          },
          "enabled": {
            "type": "boolean",
            "title": "Whether to enable/disable payout configuration"
          }
        }
      },
      "v1UpdatePlatformResponse": {
        "type": "object",
        "properties": {
          "platform": {
            "$ref": "#/components/schemas/v1Platform"
          }
        }
      },
      "v1UpdatePrefixResponse": {
        "type": "object",
        "properties": {
          "prefix": {
            "$ref": "#/components/schemas/v1Prefix"
          }
        }
      },
      "v1UpdateProviderReviewReplyResponse": {
        "type": "object",
        "properties": {
          "review": {
            "$ref": "#/components/schemas/v1ProviderReviewListItem"
          }
        }
      },
      "v1UpdateProviderTicketNotificationPolicyRequest": {
        "type": "object",
        "properties": {
          "policy": {
            "$ref": "#/components/schemas/v1ProviderTicketNotificationPolicy"
          }
        }
      },
      "v1UpdateRoadmapFeatureRequestCommentResponse": {
        "type": "object",
        "properties": {
          "comment": {
            "$ref": "#/components/schemas/v1RoadmapFeatureRequestComment"
          }
        }
      },
      "v1UpdateRoleResponse": {
        "type": "object",
        "properties": {
          "role": {
            "$ref": "#/components/schemas/v1Role"
          }
        }
      },
      "v1UpdateSmtpOutboundProviderPolicyRequest": {
        "type": "object",
        "properties": {
          "blockByDefault": {
            "type": "boolean",
            "description": "Must accept false (allow-by-default). Proto3 required on bool rejects the\nzero value because there is no field presence without `optional`."
          }
        }
      },
      "v1UpdateUserResponse": {
        "type": "object",
        "properties": {
          "user": {
            "$ref": "#/components/schemas/v1User"
          }
        }
      },
      "v1UpdateVMTemplateResponse": {
        "type": "object",
        "properties": {
          "vmTemplate": {
            "$ref": "#/components/schemas/v1VMTemplate"
          }
        }
      },
      "v1UploadInboundPeeringConfigResponse": {
        "type": "object",
        "properties": {
          "inboundPeeringState": {
            "$ref": "#/components/schemas/v1InboundPeeringState"
          }
        }
      },
      "v1UploadTicketAttachmentContentRequest": {
        "type": "object",
        "properties": {
          "uploadToken": {
            "type": "string"
          },
          "fileContent": {
            "type": "string",
            "format": "byte"
          }
        }
      },
      "v1UpsertHookScriptRequest": {
        "type": "object",
        "properties": {
          "hook": {
            "$ref": "#/components/schemas/v1LifecycleHook"
          },
          "script": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean",
            "title": "Omit to keep the stored value; create defaults to true"
          },
          "subject": {
            "$ref": "#/components/schemas/v1HookSubject"
          }
        }
      },
      "v1UsageAggregate": {
        "type": "object",
        "properties": {
          "subscriptionId": {
            "type": "string"
          },
          "metricId": {
            "type": "string"
          },
          "metricName": {
            "type": "string"
          },
          "metricCode": {
            "type": "string"
          },
          "aggregationType": {
            "$ref": "#/components/schemas/v1AggregationType"
          },
          "totalQuantity": {
            "type": "string",
            "description": "Decimal as string",
            "title": "Aggregated values"
          },
          "recordCount": {
            "type": "integer",
            "format": "int32"
          },
          "firstTimestamp": {
            "type": "string",
            "format": "date-time"
          },
          "lastTimestamp": {
            "type": "string",
            "format": "date-time"
          },
          "billingPeriodStart": {
            "type": "string",
            "format": "date-time",
            "title": "Billing period"
          },
          "billingPeriodEnd": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "v1UsageRecord": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "quantity": {
            "type": "string",
            "description": "Stored as string for decimal precision",
            "title": "Usage data"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "billingPeriodStart": {
            "type": "string",
            "format": "date-time"
          },
          "billingPeriodEnd": {
            "type": "string",
            "format": "date-time"
          },
          "eventId": {
            "type": "string",
            "description": "For deduplication",
            "title": "Usage metadata"
          },
          "properties": {
            "type": "object",
            "title": "Additional metadata (region, instance_id, etc.)"
          },
          "usageRecordStatus": {
            "$ref": "#/components/schemas/v1UsageRecordStatus"
          },
          "errorMessage": {
            "type": "string"
          },
          "processedAt": {
            "type": "string",
            "format": "date-time"
          },
          "externalId": {
            "type": "string",
            "title": "External integration"
          },
          "subscriptionId": {
            "type": "string",
            "title": "Relations"
          },
          "metricId": {
            "type": "string"
          },
          "invoiceId": {
            "type": "string"
          },
          "invoiceLineId": {
            "type": "string"
          },
          "subscriptionName": {
            "type": "string",
            "title": "Relation details (populated in responses)"
          },
          "metricName": {
            "type": "string"
          },
          "metricCode": {
            "type": "string"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1UsageRecordStatus": {
        "type": "string",
        "enum": [
          "USAGE_RECORD_STATUS_UNSPECIFIED",
          "USAGE_RECORD_STATUS_PENDING",
          "USAGE_RECORD_STATUS_PROCESSED",
          "USAGE_RECORD_STATUS_BILLED",
          "USAGE_RECORD_STATUS_FAILED"
        ],
        "default": "USAGE_RECORD_STATUS_UNSPECIFIED"
      },
      "v1User": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "email": {
            "type": "string"
          },
          "password": {
            "type": "string"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "isVerified": {
            "type": "boolean"
          },
          "allowOrgInvites": {
            "type": "boolean"
          },
          "organization": {
            "type": "string",
            "title": "Relations"
          },
          "userRoles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "groupIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "subscriptionIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          }
        }
      },
      "v1UserDetails": {
        "type": "object",
        "properties": {
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          }
        },
        "title": "UserDetails contains user information"
      },
      "v1UserSummary": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "email": {
            "type": "string"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          }
        }
      },
      "v1VMTemplate": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Fields"
          },
          "name": {
            "type": "string"
          },
          "distro": {
            "$ref": "#/components/schemas/v1Distro"
          },
          "templateId": {
            "type": "integer",
            "format": "int32"
          },
          "nodeId": {
            "type": "string"
          },
          "cloudInitTemplateId": {
            "type": "string"
          },
          "nodeName": {
            "type": "string"
          },
          "cloudInitTemplateName": {
            "type": "string"
          },
          "platformName": {
            "type": "string"
          },
          "metadata": {
            "type": "object",
            "title": "Metadata"
          },
          "status": {
            "$ref": "#/components/schemas/protov1Status"
          },
          "timestamps": {
            "$ref": "#/components/schemas/v1Timestamps"
          },
          "proxmoxCpuType": {
            "type": "string",
            "description": "Proxmox cpu= guest CPU model for VMs cloned from this template. Default: host."
          }
        }
      },
      "v1ValidateNodeTopologyRequest": {
        "type": "object",
        "properties": {
          "topologyPaste": {
            "type": "string",
            "description": "Raw topology paste to validate without persisting."
          },
          "nodeId": {
            "type": "string",
            "description": "Optional node to cross-check the paste against (edit flow). When set, the\nparsed totals are compared with the node's Proxmox-reported CPU inventory\n(metadata.proxmox_cpu) and mismatches are returned as warnings."
          }
        }
      },
      "v1ValidateNodeTopologyResponse": {
        "type": "object",
        "properties": {
          "valid": {
            "type": "boolean"
          },
          "error": {
            "type": "string",
            "description": "Parse/validation error when valid is false."
          },
          "modelName": {
            "type": "string"
          },
          "sockets": {
            "type": "integer",
            "format": "int32"
          },
          "numaNodes": {
            "type": "integer",
            "format": "int32"
          },
          "physicalCores": {
            "type": "integer",
            "format": "int32"
          },
          "threadsPerCore": {
            "type": "integer",
            "format": "int32"
          },
          "logicalCpus": {
            "type": "integer",
            "format": "int32"
          },
          "smtEnabled": {
            "type": "boolean"
          },
          "numaSummary": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1NodeCPUMapNUMA"
            },
            "description": "Per-NUMA memory in MB, indexed by NUMA node id order."
          },
          "warnings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1ValidateNodeTopologyWarning"
            }
          }
        }
      },
      "v1ValidateNodeTopologyWarning": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "v1VerificationType": {
        "type": "string",
        "enum": [
          "VERIFICATION_TYPE_UNSPECIFIED",
          "VERIFICATION_TYPE_DNS",
          "VERIFICATION_TYPE_HTTPS"
        ],
        "default": "VERIFICATION_TYPE_UNSPECIFIED"
      },
      "v1VerifyMfaEnrollmentRequest": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          }
        }
      },
      "v1VerifyMfaEnrollmentResponse": {
        "type": "object",
        "properties": {
          "backupCodes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1VirtualMachine": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The unique identifier for the virtual machine. This is a read-only field.",
            "readOnly": true
          },
          "hostname": {
            "type": "string",
            "description": "The name of the virtual machine."
          },
          "operationStatus": {
            "$ref": "#/components/schemas/v1OperationStatus"
          },
          "cpu": {
            "type": "integer",
            "format": "int32",
            "description": "The number of CPU cores allocated to the virtual machine."
          },
          "memory": {
            "type": "integer",
            "format": "int32",
            "description": "The amount of memory in MB allocated to the virtual machine."
          },
          "storage": {
            "type": "integer",
            "format": "int32",
            "description": "Target storage for full clone."
          },
          "providerOrganizationId": {
            "type": "string",
            "description": "The ID of the service provider organization for the virtual machine."
          },
          "ipv4": {
            "type": "string",
            "description": "Primary IPv4 from active IPAM allocations (when available).",
            "readOnly": true
          },
          "ipv6": {
            "type": "string",
            "description": "Primary IPv6 from active IPAM allocations (when available).",
            "readOnly": true
          },
          "distro": {
            "$ref": "#/components/schemas/v1Distro"
          },
          "createTime": {
            "type": "string",
            "format": "date-time",
            "description": "The creation timestamp of the virtual machine.",
            "readOnly": true
          },
          "updateTime": {
            "type": "string",
            "format": "date-time",
            "description": "The last update timestamp of the virtual machine.",
            "readOnly": true
          },
          "regionCountry": {
            "type": "string",
            "description": "The country of the region where the virtual machine is located.",
            "readOnly": true
          },
          "regionCity": {
            "type": "string",
            "description": "The city of the region where the virtual machine is located.",
            "readOnly": true
          },
          "providerName": {
            "type": "string",
            "description": "The name of the provider organization that owns the node where the virtual machine is located.",
            "readOnly": true
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "Tags for categorizing the virtual machine (e.g., \"database\", \"webserver\")"
          },
          "firewallRulesetId": {
            "type": "string",
            "description": "Firewall ruleset attached to this VM (contains both ingress and egress rules).\nManaged via attach/detach firewall endpoints.",
            "readOnly": true
          },
          "addonSubscriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1AddonSubscription"
            },
            "title": "Active addon subscriptions for this VM (backup, etc.)",
            "readOnly": true
          },
          "hasActiveBackupSubscription": {
            "type": "boolean",
            "description": "True when this VM has an active backup-class addon subscription (derived from subscription add-ons).",
            "readOnly": true
          },
          "activeBackupSubscriptionName": {
            "type": "string",
            "description": "Display name of the active backup addon (empty when has_active_backup_subscription is false).",
            "readOnly": true
          },
          "planBillingType": {
            "$ref": "#/components/schemas/v1BillingType"
          },
          "additionalIpv4": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1AdditionalIPAddress"
            },
            "description": "Extra IPv4 addresses purchased via the ADDITIONAL-IP addon (same prefix as primary).",
            "readOnly": true
          },
          "bandwidthEgress": {
            "$ref": "#/components/schemas/v1VirtualMachineBandwidthQuota"
          },
          "bandwidthIngress": {
            "$ref": "#/components/schemas/v1VirtualMachineBandwidthQuota"
          },
          "reinstallStatus": {
            "$ref": "#/components/schemas/v1ReinstallStatus"
          },
          "reinstalledAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "instantAppId": {
            "type": "string",
            "description": "Platform Instant App used when this VM was created/reinstalled (empty when OS-only).",
            "readOnly": true
          },
          "instantAppSlug": {
            "type": "string",
            "readOnly": true
          },
          "instantAppName": {
            "type": "string",
            "readOnly": true
          },
          "instantAppVersion": {
            "type": "string",
            "readOnly": true
          },
          "instantAppFamily": {
            "type": "string",
            "description": "Family key used for icons under /icons/instant-apps/{family}.svg (e.g. portainer).",
            "readOnly": true
          },
          "instantAppIconUrl": {
            "type": "string",
            "description": "Optional override; when empty, clients fall back to the family icon path.",
            "readOnly": true
          },
          "planCode": {
            "type": "string",
            "description": "Marketplace plan code for this VM's subscription (e.g. \"DC-CPU-4C-4G-160\").",
            "readOnly": true
          },
          "platformDriver": {
            "$ref": "#/components/schemas/v1PlatformDriver"
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Features that hypervisor supports (same strings as marketplace ProviderInfo).",
            "readOnly": true
          },
          "complianceHeld": {
            "type": "boolean",
            "description": "True when the VM is seized for fraud, abuse, copyright, or related reasons.",
            "readOnly": true
          },
          "complianceReason": {
            "$ref": "#/components/schemas/v1ComplianceReason"
          },
          "complianceMessage": {
            "type": "string",
            "readOnly": true
          },
          "complianceHeldAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "complianceActor": {
            "$ref": "#/components/schemas/v1ComplianceActor"
          }
        },
        "description": "VirtualMachine represents a managed virtual machine resource."
      },
      "v1VirtualMachineBandwidthQuota": {
        "type": "object",
        "properties": {
          "usedGb": {
            "type": "number",
            "format": "double",
            "description": "Total bandwidth used this billing period (decimal GB, 1000^3 bytes).",
            "readOnly": true
          },
          "freeUnitsGb": {
            "type": "integer",
            "format": "int32",
            "description": "Included free bandwidth per period (GB). Zero when unlimited or not configured.",
            "readOnly": true
          },
          "blockSizeGb": {
            "type": "integer",
            "format": "int32",
            "description": "Overage block size (GB). Zero when unlimited or linear pricing.",
            "readOnly": true
          },
          "blockPrice": {
            "type": "string",
            "description": "Price per overage block (decimal string, e.g. \"2.00\").",
            "readOnly": true
          },
          "currency": {
            "type": "string",
            "readOnly": true
          },
          "unlimited": {
            "type": "boolean",
            "description": "True when bandwidth is effectively unlimited ($0 overage) for this direction.",
            "readOnly": true
          },
          "periodStart": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "periodEnd": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "overageGb": {
            "type": "number",
            "format": "double",
            "description": "GB above the free allowance (0 when within free tier).",
            "readOnly": true
          },
          "billableBlocks": {
            "type": "integer",
            "format": "int32",
            "description": "Whole overage blocks currently billable (ceil(overage_gb / block_size_gb)).",
            "readOnly": true
          },
          "nextBlockGb": {
            "type": "number",
            "format": "double",
            "description": "Total usage GB at which the next overage block would begin (0 when unlimited).",
            "readOnly": true
          },
          "estimatedOverageAmount": {
            "type": "string",
            "description": "Estimated overage charge for the current period (decimal string).",
            "readOnly": true
          },
          "billingEnabled": {
            "type": "boolean",
            "description": "False when usage is shown for visibility only (e.g. ingress not billed on this plan).",
            "readOnly": true
          }
        },
        "description": "VirtualMachineBandwidthQuota summarizes plan bandwidth allowance and metered usage for graphs/billing UX.\nShared by both bandwidth_egress and bandwidth_ingress on VirtualMachine."
      },
      "v1VirtualMachineSmtpOutboundPolicyView": {
        "type": "object",
        "properties": {
          "virtualMachineId": {
            "type": "string"
          },
          "hostname": {
            "type": "string"
          },
          "action": {
            "$ref": "#/components/schemas/v1SmtpOutboundVmAction"
          },
          "effectiveBlocked": {
            "type": "boolean"
          },
          "clientOrganizationId": {
            "type": "string",
            "description": "Client organization that owns the VM (grouping key for provider UI)."
          },
          "clientOwnerUserId": {
            "type": "string",
            "description": "First owner user of that client organization (when resolved)."
          },
          "clientContactEmail": {
            "type": "string",
            "description": "Contact email of that owner (when resolved)."
          },
          "ipv4": {
            "type": "string",
            "description": "Primary active IPv4 / IPv6 from IPAM allocations (empty when none)."
          },
          "ipv6": {
            "type": "string"
          }
        }
      },
      "v1VoteRoadmapFeatureRequestResponse": {
        "type": "object",
        "properties": {
          "request": {
            "$ref": "#/components/schemas/v1RoadmapFeatureRequest"
          }
        }
      }
    }
  }
}
