management

type APIConfigData struct {
	// Context Base path for all API routes (must start with /, no trailing slash). Use $version to embed the version in the path (e.g., /reading-list/$version resolves to /reading-list/v1.0).
	Context string `json:"context" yaml:"context"`

	// DeploymentState Desired deployment state - 'deployed' (default) or 'undeployed'. When set to 'undeployed', the API is removed from router traffic but configuration, API keys, and policies are preserved for potential redeployment.
	DeploymentState *APIConfigDataDeploymentState `json:"deploymentState,omitempty" yaml:"deploymentState,omitempty"`

	// DisplayName Human-readable API name (must be URL-friendly - only letters, numbers, spaces, hyphens, underscores, and dots allowed)
	DisplayName string `json:"displayName" yaml:"displayName"`

	// Operations List of HTTP operations/routes
	Operations []Operation `json:"operations" yaml:"operations"`

	// Policies List of API-level policies applied to all operations unless overridden
	Policies *[]Policy `json:"policies,omitempty" yaml:"policies,omitempty"`

	// SubscriptionPlans List of subscription plan names available for this API
	SubscriptionPlans *[]string `json:"subscriptionPlans,omitempty" yaml:"subscriptionPlans,omitempty"`

	// Upstream API-level upstream configuration
	Upstream struct {
		// Main Upstream backend configuration (single target or reference)
		Main Upstream `json:"main" yaml:"main"`

		// Sandbox Upstream backend configuration (single target or reference)
		Sandbox *Upstream `json:"sandbox,omitempty" yaml:"sandbox,omitempty"`
	} `json:"upstream" yaml:"upstream"`

	// UpstreamDefinitions List of reusable upstream definitions with optional timeout configurations
	UpstreamDefinitions *[]UpstreamDefinition `json:"upstreamDefinitions,omitempty" yaml:"upstreamDefinitions,omitempty"`

	// Version Semantic version of the API
	Version string `json:"version" yaml:"version"`

	// Vhosts Custom virtual hosts/domains for the API
	Vhosts *struct {
		// Main Custom virtual host/domain for production traffic
		Main string `json:"main" yaml:"main"`

		// Sandbox Custom virtual host/domain for sandbox traffic
		Sandbox *string `json:"sandbox,omitempty" yaml:"sandbox,omitempty"`
	} `json:"vhosts,omitempty" yaml:"vhosts,omitempty"`
}

type APIConfigDataDeploymentState string

type APIKey struct {
	// ApiId Unique public identifier of the API that the key is associated with
	ApiId string `json:"apiId" yaml:"apiId"`

	// ApiKey Generated API key with apip_ prefix
	ApiKey *string `json:"apiKey,omitempty" yaml:"apiKey,omitempty"`

	// CreatedAt Timestamp when the API key was generated
	CreatedAt time.Time `json:"createdAt" yaml:"createdAt"`

	// CreatedBy Identifier of the user who generated the API key
	CreatedBy string `json:"createdBy" yaml:"createdBy"`

	// DisplayName Human-readable name for the API key (user-provided, mutable)
	DisplayName *string `json:"displayName,omitempty" yaml:"displayName,omitempty"`

	// ExpiresAt Expiration timestamp (null if no expiration)
	ExpiresAt *time.Time `json:"expiresAt" yaml:"expiresAt"`

	// ExternalRefId External reference ID for the API key
	ExternalRefId *string `json:"externalRefId,omitempty" yaml:"externalRefId,omitempty"`

	// Name URL-safe identifier for the API key (auto-generated from displayName, immutable, used as path parameter)
	Name string `json:"name" yaml:"name"`

	// Source Source of the API key (local or external)
	Source APIKeySource `json:"source" yaml:"source"`

	// Status Status of the API key
	Status APIKeyStatus `json:"status" yaml:"status"`
}

type APIKeyCreationRequest struct {
	// ApiKey Optional plain-text API key value for external key injection.
	// If provided, this key will be used instead of generating a new one.
	// The key will be hashed before storage. The key can be in any format
	// (minimum 36 characters). Use this for injecting externally generated
	// API keys.
	ApiKey *string `json:"apiKey,omitempty" yaml:"apiKey,omitempty"`

	// ExpiresAt Expiration timestamp. If both expiresIn and expiresAt are provided, expiresAt takes precedence.
	ExpiresAt *time.Time `json:"expiresAt,omitempty" yaml:"expiresAt,omitempty"`

	// ExpiresIn Expiration duration for the API key
	ExpiresIn *struct {
		// Duration Duration value for expiration
		Duration int `json:"duration" yaml:"duration"`

		// Unit Time unit for expiration
		Unit APIKeyCreationRequestExpiresInUnit `json:"unit" yaml:"unit"`
	} `json:"expiresIn,omitempty" yaml:"expiresIn,omitempty"`

	// ExternalRefId External reference ID for the API key.
	// This field is optional and used for tracing purposes only.
	// The gateway generates its own internal ID for tracking.
	ExternalRefId *string `json:"externalRefId,omitempty" yaml:"externalRefId,omitempty"`

	// Issuer Identifies the portal that created this key. If provided, only api keys generated from
	// the same portal will be accepted. If not provided, there is no portal restriction.
	Issuer *string `json:"issuer,omitempty" yaml:"issuer,omitempty"`

	// MaskedApiKey Masked version of the API key for display purposes.
	// Provided by the platform API when injecting pre-hashed keys.
	MaskedApiKey *string `json:"maskedApiKey,omitempty" yaml:"maskedApiKey,omitempty"`

	// Name Identifier of the API key. If not provided, a default identifier will be generated
	Name *string `json:"name,omitempty" yaml:"name,omitempty"`
}

type APIKeyCreationRequestExpiresInUnit string

type APIKeyCreationResponse struct {
	// ApiKey Details of an API key
	ApiKey  *APIKey `json:"apiKey,omitempty" yaml:"apiKey,omitempty"`
	Message string  `json:"message" yaml:"message"`

	// RemainingApiKeyQuota Remaining API key quota for the user
	RemainingApiKeyQuota *int   `json:"remainingApiKeyQuota,omitempty" yaml:"remainingApiKeyQuota,omitempty"`
	Status               string `json:"status" yaml:"status"`
}

type APIKeyListResponse struct {
	ApiKeys *[]APIKey `json:"apiKeys,omitempty" yaml:"apiKeys,omitempty"`
	Status  *string   `json:"status,omitempty" yaml:"status,omitempty"`

	// TotalCount Total number of API keys
	TotalCount *int `json:"totalCount,omitempty" yaml:"totalCount,omitempty"`
}

type APIKeyRegenerationRequest struct {
	// ExpiresAt Expiration timestamp
	ExpiresAt *time.Time `json:"expiresAt,omitempty" yaml:"expiresAt,omitempty"`

	// ExpiresIn Expiration duration for the API key
	ExpiresIn *struct {
		// Duration Duration value for expiration
		Duration int `json:"duration" yaml:"duration"`

		// Unit Time unit for expiration
		Unit APIKeyRegenerationRequestExpiresInUnit `json:"unit" yaml:"unit"`
	} `json:"expiresIn,omitempty" yaml:"expiresIn,omitempty"`
}

type APIKeyRegenerationRequestExpiresInUnit string

type APIKeyRevocationResponse struct {
	Message string `json:"message" yaml:"message"`
	Status  string `json:"status" yaml:"status"`
}

type APIKeySource string

type APIKeyStatus string

type APIKeyUpdateRequest = APIKeyCreationRequest

type CertificateListResponse struct {
	Certificates *[]CertificateResponse `json:"certificates,omitempty" yaml:"certificates,omitempty"`
	Status       *string                `json:"status,omitempty" yaml:"status,omitempty"`

	// TotalBytes Total bytes of all certificate files
	TotalBytes *int `json:"totalBytes,omitempty" yaml:"totalBytes,omitempty"`

	// TotalCount Total number of certificate files
	TotalCount *int `json:"totalCount,omitempty" yaml:"totalCount,omitempty"`
}

type CertificateResponse struct {
	// Count Number of certificates in the file
	Count *int `json:"count,omitempty" yaml:"count,omitempty"`

	// Id Unique identifier (UUID) for the certificate
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Issuer Certificate issuer DN (for first cert if bundle)
	Issuer *string `json:"issuer,omitempty" yaml:"issuer,omitempty"`

	// Message Success or informational message
	Message *string `json:"message,omitempty" yaml:"message,omitempty"`

	// Name Name of the certificate
	Name *string `json:"name,omitempty" yaml:"name,omitempty"`

	// NotAfter Certificate expiration date (for first cert if bundle)
	NotAfter *time.Time                 `json:"notAfter,omitempty" yaml:"notAfter,omitempty"`
	Status   *CertificateResponseStatus `json:"status,omitempty" yaml:"status,omitempty"`

	// Subject Certificate subject DN (for first cert if bundle)
	Subject *string `json:"subject,omitempty" yaml:"subject,omitempty"`
}

type CertificateResponseStatus string

type CertificateUploadRequest struct {
	// Certificate PEM-encoded X.509 certificate(s). Can contain multiple certificates.
	Certificate string `json:"certificate" yaml:"certificate"`

	// Name Unique name for the certificate. Must be unique across all certificates.
	Name string `json:"name" yaml:"name"`
}

type CreateAPIKeyJSONRequestBody = APIKeyCreationRequest

type CreateLLMProviderAPIKeyJSONRequestBody = APIKeyCreationRequest

type CreateLLMProviderJSONRequestBody = LLMProviderConfigurationRequest

type CreateLLMProviderTemplateJSONRequestBody = LLMProviderTemplateRequest

type CreateLLMProxyAPIKeyJSONRequestBody = APIKeyCreationRequest

type CreateLLMProxyJSONRequestBody = LLMProxyConfigurationRequest

type CreateMCPProxyJSONRequestBody = MCPProxyConfigurationRequest

type CreateRestAPIJSONRequestBody = RestAPIRequest

type CreateSecretJSONRequestBody = SecretConfigurationRequest

type CreateSubscriptionJSONRequestBody = SubscriptionCreateRequest

type CreateSubscriptionPlanJSONRequestBody = SubscriptionPlanCreateRequest

type CreateWebBrokerAPIKeyJSONRequestBody = APIKeyCreationRequest

type CreateWebBrokerApiJSONRequestBody = WebBrokerApiRequest

type CreateWebSubAPIJSONRequestBody = WebSubAPIRequest

type CreateWebSubAPIKeyJSONRequestBody = APIKeyCreationRequest

type ErrorResponse struct {
	// Errors Detailed validation errors
	Errors *[]ValidationError `json:"errors,omitempty" yaml:"errors,omitempty"`

	// Message High-level error description
	Message string `json:"message" yaml:"message"`
	Status  string `json:"status" yaml:"status"`
}

type ExtractionIdentifier struct {
	// Identifier JSONPath expression or header name to identify the token value
	Identifier string `json:"identifier" yaml:"identifier"`

	// Location Where to find the token information
	Location ExtractionIdentifierLocation `json:"location" yaml:"location"`
}

type ExtractionIdentifierLocation string

type GinServerOptions struct {
	BaseURL      string
	Middlewares  []MiddlewareFunc
	ErrorHandler func(*gin.Context, error, int)
}

type LLMAccessControl struct {
	// Exceptions Path exceptions to the access control mode
	Exceptions *[]RouteException `json:"exceptions,omitempty" yaml:"exceptions,omitempty"`

	// Mode Access control mode
	Mode LLMAccessControlMode `json:"mode" yaml:"mode"`
}

type LLMAccessControlMode string

type LLMPolicy struct {
	Name    string          `json:"name" yaml:"name"`
	Paths   []LLMPolicyPath `json:"paths" yaml:"paths"`
	Version string          `json:"version" yaml:"version"`
}

type LLMPolicyPath struct {
	Methods []LLMPolicyPathMethods `json:"methods" yaml:"methods"`

	// Params JSON Schema describing the parameters accepted by this policy. This itself is a JSON Schema document.
	Params map[string]interface{} `json:"params" yaml:"params"`
	Path   string                 `json:"path" yaml:"path"`
}

type LLMPolicyPathMethods string

type LLMProviderConfigData struct {
	AccessControl LLMAccessControl `json:"accessControl" yaml:"accessControl"`

	// Context Base path for all API routes (must start with /, no trailing slash)
	Context *string `json:"context,omitempty" yaml:"context,omitempty"`

	// DeploymentState Desired deployment state - 'deployed' (default) or 'undeployed'. When set to 'undeployed', the LLM Provider is removed from router traffic but configuration and policies are preserved for potential redeployment.
	DeploymentState *LLMProviderConfigDataDeploymentState `json:"deploymentState,omitempty" yaml:"deploymentState,omitempty"`

	// DisplayName Human-readable LLM Provider name
	DisplayName string `json:"displayName" yaml:"displayName"`

	// Policies List of policies applied only to this operation (overrides or adds to API-level policies)
	Policies *[]LLMPolicy `json:"policies,omitempty" yaml:"policies,omitempty"`

	// Template Template name to use for this LLM Provider
	Template string                         `json:"template" yaml:"template"`
	Upstream LLMProviderConfigData_Upstream `json:"upstream" yaml:"upstream"`

	// Version Semantic version of the LLM Provider
	Version string `json:"version" yaml:"version"`

	// Vhost Virtual host name used for routing. Supports standard domain names, subdomains, or wildcard domains. Must follow RFC-compliant hostname rules. Wildcards are only allowed in the left-most label (e.g., *.example.com).
	Vhost *string `json:"vhost,omitempty" yaml:"vhost,omitempty"`
}

type LLMProviderConfigDataDeploymentState string

type LLMProviderConfigDataUpstream0 = interface{}

type LLMProviderConfigDataUpstream1 = interface{}

type LLMProviderConfigDataUpstreamAuthType string

type LLMProviderConfigDataUpstreamHostRewrite string

type LLMProviderConfigData_Upstream struct {
	Auth *struct {
		Header *string                               `json:"header,omitempty" yaml:"header,omitempty"`
		Type   LLMProviderConfigDataUpstreamAuthType `json:"type" yaml:"type"`
		Value  *string                               `json:"value,omitempty" yaml:"value,omitempty"`
	} `json:"auth,omitempty" yaml:"auth,omitempty"`

	// HostRewrite Controls how the Host header is handled when routing to the upstream. `auto` delegates host rewriting to Envoy, which rewrites the Host header using the upstream cluster host. `manual` disables automatic rewriting and expects explicit configuration.
	HostRewrite *LLMProviderConfigDataUpstreamHostRewrite `json:"hostRewrite,omitempty" yaml:"hostRewrite,omitempty"`

	// Ref Reference to a predefined upstreamDefinition
	Ref *string `json:"ref,omitempty" yaml:"ref,omitempty"`

	// Url Direct backend URL to route traffic to
	Url *string `json:"url,omitempty" yaml:"url,omitempty"`
	// contains filtered or unexported fields
}

type LLMProviderConfiguration struct {
	// ApiVersion Provider specification version
	ApiVersion LLMProviderConfigurationApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind Provider kind
	Kind     LLMProviderConfigurationKind `json:"kind" yaml:"kind"`
	Metadata Metadata                     `json:"metadata" yaml:"metadata"`
	Spec     LLMProviderConfigData        `json:"spec" yaml:"spec"`

	// Status Server-managed lifecycle fields. Populated on responses.
	Status *ResourceStatus `json:"status,omitempty" yaml:"status,omitempty"`
}

type LLMProviderConfigurationApiVersion string

type LLMProviderConfigurationKind string

type LLMProviderConfigurationRequest struct {
	// ApiVersion Provider specification version
	ApiVersion LLMProviderConfigurationRequestApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind Provider kind
	Kind     LLMProviderConfigurationRequestKind `json:"kind" yaml:"kind"`
	Metadata Metadata                            `json:"metadata" yaml:"metadata"`
	Spec     LLMProviderConfigData               `json:"spec" yaml:"spec"`
}

type LLMProviderConfigurationRequestApiVersion string

type LLMProviderConfigurationRequestKind string

type LLMProviderTemplate struct {
	// ApiVersion Template specification version
	ApiVersion LLMProviderTemplateApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind Template kind
	Kind     LLMProviderTemplateKind `json:"kind" yaml:"kind"`
	Metadata Metadata                `json:"metadata" yaml:"metadata"`
	Spec     LLMProviderTemplateData `json:"spec" yaml:"spec"`

	// Status Server-managed lifecycle fields. Populated on responses.
	Status *ResourceStatus `json:"status,omitempty" yaml:"status,omitempty"`
}

type LLMProviderTemplateApiVersion string

type LLMProviderTemplateData struct {
	CompletionTokens *ExtractionIdentifier `json:"completionTokens,omitempty" yaml:"completionTokens,omitempty"`

	// DisplayName Human-readable LLM Template name
	DisplayName      string                               `json:"displayName" yaml:"displayName"`
	PromptTokens     *ExtractionIdentifier                `json:"promptTokens,omitempty" yaml:"promptTokens,omitempty"`
	RemainingTokens  *ExtractionIdentifier                `json:"remainingTokens,omitempty" yaml:"remainingTokens,omitempty"`
	RequestModel     *ExtractionIdentifier                `json:"requestModel,omitempty" yaml:"requestModel,omitempty"`
	ResourceMappings *LLMProviderTemplateResourceMappings `json:"resourceMappings,omitempty" yaml:"resourceMappings,omitempty"`
	ResponseModel    *ExtractionIdentifier                `json:"responseModel,omitempty" yaml:"responseModel,omitempty"`
	TotalTokens      *ExtractionIdentifier                `json:"totalTokens,omitempty" yaml:"totalTokens,omitempty"`
}

type LLMProviderTemplateKind string

type LLMProviderTemplateRequest struct {
	// ApiVersion Template specification version
	ApiVersion LLMProviderTemplateRequestApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind Template kind
	Kind     LLMProviderTemplateRequestKind `json:"kind" yaml:"kind"`
	Metadata Metadata                       `json:"metadata" yaml:"metadata"`
	Spec     LLMProviderTemplateData        `json:"spec" yaml:"spec"`
}

type LLMProviderTemplateRequestApiVersion string

type LLMProviderTemplateRequestKind string

type LLMProviderTemplateResourceMapping struct {
	CompletionTokens *ExtractionIdentifier `json:"completionTokens,omitempty" yaml:"completionTokens,omitempty"`
	PromptTokens     *ExtractionIdentifier `json:"promptTokens,omitempty" yaml:"promptTokens,omitempty"`
	RemainingTokens  *ExtractionIdentifier `json:"remainingTokens,omitempty" yaml:"remainingTokens,omitempty"`
	RequestModel     *ExtractionIdentifier `json:"requestModel,omitempty" yaml:"requestModel,omitempty"`

	// Resource Resource path pattern for this mapping
	Resource      string                `json:"resource" yaml:"resource"`
	ResponseModel *ExtractionIdentifier `json:"responseModel,omitempty" yaml:"responseModel,omitempty"`
	TotalTokens   *ExtractionIdentifier `json:"totalTokens,omitempty" yaml:"totalTokens,omitempty"`
}

type LLMProviderTemplateResourceMappings struct {
	Resources *[]LLMProviderTemplateResourceMapping `json:"resources,omitempty" yaml:"resources,omitempty"`
}

type LLMProxyConfigData struct {
	// Context Base path for all API routes (must start with /, no trailing slash)
	Context *string `json:"context,omitempty" yaml:"context,omitempty"`

	// DeploymentState Desired deployment state - 'deployed' (default) or 'undeployed'. When set to 'undeployed', the LLM Proxy is removed from router traffic but configuration and policies are preserved for potential redeployment.
	DeploymentState *LLMProxyConfigDataDeploymentState `json:"deploymentState,omitempty" yaml:"deploymentState,omitempty"`

	// DisplayName Human-readable LLM proxy name (must be URL-friendly - only letters, numbers, spaces, hyphens, underscores, and dots allowed)
	DisplayName string `json:"displayName" yaml:"displayName"`

	// Policies List of policies applied only to this operation (overrides or adds to API-level policies)
	Policies *[]LLMPolicy     `json:"policies,omitempty" yaml:"policies,omitempty"`
	Provider LLMProxyProvider `json:"provider" yaml:"provider"`

	// Version Semantic version of the LLM proxy
	Version string `json:"version" yaml:"version"`

	// Vhost Virtual host name used for routing. Supports standard domain names, subdomains, or wildcard domains. Must follow RFC-compliant hostname rules. Wildcards are only allowed in the left-most label (e.g., *.example.com).
	Vhost *string `json:"vhost,omitempty" yaml:"vhost,omitempty"`
}

type LLMProxyConfigDataDeploymentState string

type LLMProxyConfiguration struct {
	// ApiVersion Proxy specification version
	ApiVersion LLMProxyConfigurationApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind Proxy kind
	Kind     LLMProxyConfigurationKind `json:"kind" yaml:"kind"`
	Metadata Metadata                  `json:"metadata" yaml:"metadata"`
	Spec     LLMProxyConfigData        `json:"spec" yaml:"spec"`

	// Status Server-managed lifecycle fields. Populated on responses.
	Status *ResourceStatus `json:"status,omitempty" yaml:"status,omitempty"`
}

type LLMProxyConfigurationApiVersion string

type LLMProxyConfigurationKind string

type LLMProxyConfigurationRequest struct {
	// ApiVersion Proxy specification version
	ApiVersion LLMProxyConfigurationRequestApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind Proxy kind
	Kind     LLMProxyConfigurationRequestKind `json:"kind" yaml:"kind"`
	Metadata Metadata                         `json:"metadata" yaml:"metadata"`
	Spec     LLMProxyConfigData               `json:"spec" yaml:"spec"`
}

type LLMProxyConfigurationRequestApiVersion string

type LLMProxyConfigurationRequestKind string

type LLMProxyProvider struct {
	Auth *LLMUpstreamAuth `json:"auth,omitempty" yaml:"auth,omitempty"`

	// Id Unique id of a deployed llm provider
	Id string `json:"id" yaml:"id"`
}

type LLMUpstreamAuth struct {
	Header *string             `json:"header,omitempty" yaml:"header,omitempty"`
	Type   LLMUpstreamAuthType `json:"type" yaml:"type"`
	Value  *string             `json:"value,omitempty" yaml:"value,omitempty"`
}

type LLMUpstreamAuthType string

type ListLLMProviderTemplatesParams struct {
	// DisplayName Filter by template display name
	DisplayName *string `form:"displayName,omitempty" json:"displayName,omitempty" yaml:"displayName,omitempty"`
}

type ListLLMProvidersParams struct {
	// DisplayName Filter by LLM provider display name
	DisplayName *string `form:"displayName,omitempty" json:"displayName,omitempty" yaml:"displayName,omitempty"`

	// Version Filter by LLM provider version
	Version *string `form:"version,omitempty" json:"version,omitempty" yaml:"version,omitempty"`

	// Context Filter by LLM provider context/path
	Context *string `form:"context,omitempty" json:"context,omitempty" yaml:"context,omitempty"`

	// Status Filter by deployment status
	Status *ListLLMProvidersParamsStatus `form:"status,omitempty" json:"status,omitempty" yaml:"status,omitempty"`

	// Vhost Filter by LLM provider vhost
	Vhost *string `form:"vhost,omitempty" json:"vhost,omitempty" yaml:"vhost,omitempty"`
}

type ListLLMProvidersParamsStatus string

type ListLLMProxiesParams struct {
	// DisplayName Filter by LLM proxy displayName
	DisplayName *string `form:"displayName,omitempty" json:"displayName,omitempty" yaml:"displayName,omitempty"`

	// Version Filter by LLM proxy version
	Version *string `form:"version,omitempty" json:"version,omitempty" yaml:"version,omitempty"`

	// Context Filter by LLM proxy context/path
	Context *string `form:"context,omitempty" json:"context,omitempty" yaml:"context,omitempty"`

	// Status Filter by deployment status
	Status *ListLLMProxiesParamsStatus `form:"status,omitempty" json:"status,omitempty" yaml:"status,omitempty"`

	// Vhost Filter by LLM proxy vhost
	Vhost *string `form:"vhost,omitempty" json:"vhost,omitempty" yaml:"vhost,omitempty"`
}

type ListLLMProxiesParamsStatus string

type ListMCPProxiesParams struct {
	// DisplayName Filter by MCP proxy display name
	DisplayName *string `form:"displayName,omitempty" json:"displayName,omitempty" yaml:"displayName,omitempty"`

	// Version Filter by MCP proxy version
	Version *string `form:"version,omitempty" json:"version,omitempty" yaml:"version,omitempty"`

	// Context Filter by MCP proxy context/path
	Context *string `form:"context,omitempty" json:"context,omitempty" yaml:"context,omitempty"`

	// Status Filter by deployment status
	Status *ListMCPProxiesParamsStatus `form:"status,omitempty" json:"status,omitempty" yaml:"status,omitempty"`
}

type ListMCPProxiesParamsStatus string

type ListRestAPIsParams struct {
	// DisplayName Filter by API display name
	DisplayName *string `form:"displayName,omitempty" json:"displayName,omitempty" yaml:"displayName,omitempty"`

	// Version Filter by API version
	Version *string `form:"version,omitempty" json:"version,omitempty" yaml:"version,omitempty"`

	// Context Filter by API context/path
	Context *string `form:"context,omitempty" json:"context,omitempty" yaml:"context,omitempty"`

	// Status Filter by deployment status
	Status *ListRestAPIsParamsStatus `form:"status,omitempty" json:"status,omitempty" yaml:"status,omitempty"`
}

type ListRestAPIsParamsStatus string

type ListSubscriptionsParams struct {
	// ApiId Filter by API ID (deployment ID or handle)
	ApiId         *string                        `form:"apiId,omitempty" json:"apiId,omitempty" yaml:"apiId,omitempty"`
	ApplicationId *string                        `form:"applicationId,omitempty" json:"applicationId,omitempty" yaml:"applicationId,omitempty"`
	Status        *ListSubscriptionsParamsStatus `form:"status,omitempty" json:"status,omitempty" yaml:"status,omitempty"`
}

type ListSubscriptionsParamsStatus string

type ListWebBrokerApisParams struct {
	// DisplayName Filter by WebBroker API display name
	DisplayName *string `form:"displayName,omitempty" json:"displayName,omitempty" yaml:"displayName,omitempty"`

	// Version Filter by WebBroker API version
	Version *string `form:"version,omitempty" json:"version,omitempty" yaml:"version,omitempty"`

	// Status Filter by deployment status
	Status *ListWebBrokerApisParamsStatus `form:"status,omitempty" json:"status,omitempty" yaml:"status,omitempty"`
}

type ListWebBrokerApisParamsStatus string

type ListWebSubAPIsParams struct {
	// DisplayName Filter by WebSub API display name
	DisplayName *string `form:"displayName,omitempty" json:"displayName,omitempty" yaml:"displayName,omitempty"`

	// Version Filter by WebSub API version
	Version *string `form:"version,omitempty" json:"version,omitempty" yaml:"version,omitempty"`

	// Context Filter by WebSub API context/path
	Context *string `form:"context,omitempty" json:"context,omitempty" yaml:"context,omitempty"`

	// Status Filter by deployment status
	Status *ListWebSubAPIsParamsStatus `form:"status,omitempty" json:"status,omitempty" yaml:"status,omitempty"`
}

type ListWebSubAPIsParamsStatus string

type MCPPrompt struct {
	// Arguments Optional list of arguments for customization
	Arguments *[]struct {
		// Description Description of the argument
		Description *string `json:"description,omitempty" yaml:"description,omitempty"`

		// Name Name of the argument
		Name string `json:"name" yaml:"name"`

		// Required Whether the argument is required
		Required *bool `json:"required,omitempty" yaml:"required,omitempty"`

		// Title Optional human-readable title of the argument
		Title *string `json:"title,omitempty" yaml:"title,omitempty"`
	} `json:"arguments,omitempty" yaml:"arguments,omitempty"`

	// Description Optional human-readable description
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// Name Unique identifier for the prompt
	Name string `json:"name" yaml:"name"`

	// Title Optional human-readable name of the prompt for display purposes
	Title *string `json:"title,omitempty" yaml:"title,omitempty"`
}

type MCPProxyConfigData struct {
	// Context MCP Proxy context path
	Context *string `json:"context,omitempty" yaml:"context,omitempty"`

	// DeploymentState Desired deployment state - 'deployed' (default) or 'undeployed'. When set to 'undeployed', the MCP Proxy is removed from router traffic but configuration and policies are preserved for potential redeployment.
	DeploymentState *MCPProxyConfigDataDeploymentState `json:"deploymentState,omitempty" yaml:"deploymentState,omitempty"`

	// DisplayName Human-readable MCP Proxy display name
	DisplayName string `json:"displayName" yaml:"displayName"`

	// Policies List of MCP Proxy level policies applied
	Policies  *[]Policy      `json:"policies,omitempty" yaml:"policies,omitempty"`
	Prompts   *[]MCPPrompt   `json:"prompts,omitempty" yaml:"prompts,omitempty"`
	Resources *[]MCPResource `json:"resources,omitempty" yaml:"resources,omitempty"`

	// SpecVersion MCP specification version
	SpecVersion *string    `json:"specVersion,omitempty" yaml:"specVersion,omitempty"`
	Tools       *[]MCPTool `json:"tools,omitempty" yaml:"tools,omitempty"`

	// Upstream The backend MCP server url and auth configurations
	Upstream MCPProxyConfigData_Upstream `json:"upstream" yaml:"upstream"`

	// Version MCP Proxy version
	Version string `json:"version" yaml:"version"`

	// Vhost Virtual host name used for routing. Supports standard domain names, subdomains, or wildcard domains. Must follow RFC-compliant hostname rules. Wildcards are only allowed in the left-most label (e.g., *.example.com).
	Vhost *string `json:"vhost,omitempty" yaml:"vhost,omitempty"`
}

type MCPProxyConfigDataDeploymentState string

type MCPProxyConfigDataUpstream0 = interface{}

type MCPProxyConfigDataUpstream1 = interface{}

type MCPProxyConfigDataUpstreamAuthType string

type MCPProxyConfigDataUpstreamHostRewrite string

type MCPProxyConfigData_Upstream struct {
	Auth *struct {
		Header *string                            `json:"header,omitempty" yaml:"header,omitempty"`
		Type   MCPProxyConfigDataUpstreamAuthType `json:"type" yaml:"type"`
		Value  *string                            `json:"value,omitempty" yaml:"value,omitempty"`
	} `json:"auth,omitempty" yaml:"auth,omitempty"`

	// HostRewrite Controls how the Host header is handled when routing to the upstream. `auto` delegates host rewriting to Envoy, which rewrites the Host header using the upstream cluster host. `manual` disables automatic rewriting and expects explicit configuration.
	HostRewrite *MCPProxyConfigDataUpstreamHostRewrite `json:"hostRewrite,omitempty" yaml:"hostRewrite,omitempty"`

	// Ref Reference to a predefined upstreamDefinition
	Ref *string `json:"ref,omitempty" yaml:"ref,omitempty"`

	// Url Direct backend URL to route traffic to
	Url *string `json:"url,omitempty" yaml:"url,omitempty"`
	// contains filtered or unexported fields
}

type MCPProxyConfiguration struct {
	// ApiVersion MCP Proxy specification version
	ApiVersion MCPProxyConfigurationApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind MCP Proxy type
	Kind     MCPProxyConfigurationKind `json:"kind" yaml:"kind"`
	Metadata Metadata                  `json:"metadata" yaml:"metadata"`
	Spec     MCPProxyConfigData        `json:"spec" yaml:"spec"`

	// Status Server-managed lifecycle fields. Populated on responses.
	Status *ResourceStatus `json:"status,omitempty" yaml:"status,omitempty"`
}

type MCPProxyConfigurationApiVersion string

type MCPProxyConfigurationKind string

type MCPProxyConfigurationRequest struct {
	// ApiVersion MCP Proxy specification version
	ApiVersion MCPProxyConfigurationRequestApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind MCP Proxy type
	Kind     MCPProxyConfigurationRequestKind `json:"kind" yaml:"kind"`
	Metadata Metadata                         `json:"metadata" yaml:"metadata"`
	Spec     MCPProxyConfigData               `json:"spec" yaml:"spec"`
}

type MCPProxyConfigurationRequestApiVersion string

type MCPProxyConfigurationRequestKind string

type MCPResource struct {
	// Description Optional description
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// MimeType Optional MIME type
	MimeType *string `json:"mimeType,omitempty" yaml:"mimeType,omitempty"`

	// Name The name of the resource
	Name string `json:"name" yaml:"name"`

	// Size Optional size in bytes
	Size *int `json:"size,omitempty" yaml:"size,omitempty"`

	// Title Optional human-readable name of the resource for display purposes
	Title *string `json:"title,omitempty" yaml:"title,omitempty"`

	// Uri Unique identifier for the resource
	Uri string `json:"uri" yaml:"uri"`
}

type MCPTool struct {
	// Description Human-readable description of functionality
	Description string `json:"description" yaml:"description"`

	// InputSchema JSON Schema defining expected parameters
	InputSchema string `json:"inputSchema" yaml:"inputSchema"`

	// Name Unique identifier for the tool
	Name string `json:"name" yaml:"name"`

	// OutputSchema Optional JSON Schema defining expected output structure
	OutputSchema *string `json:"outputSchema,omitempty" yaml:"outputSchema,omitempty"`

	// Title Optional human-readable name of the tool for display purposes.
	Title *string `json:"title,omitempty" yaml:"title,omitempty"`
}

type Metadata struct {
	// Annotations Annotations are arbitrary non-identifying metadata. Use domain-prefixed keys.
	Annotations *map[string]string `json:"annotations,omitempty" yaml:"annotations,omitempty"`

	// Labels Labels are key-value pairs for organizing and selecting APIs. Keys must not contain spaces.
	Labels *map[string]string `json:"labels,omitempty" yaml:"labels,omitempty"`

	// Name Unique handle for the resource
	Name string `json:"name" yaml:"name"`
}

type MiddlewareFunc func(c *gin.Context)

type Operation struct {
	// Method HTTP method
	Method OperationMethod `json:"method" yaml:"method"`

	// Path Route path with optional {param} placeholders
	Path string `json:"path" yaml:"path"`

	// Policies List of policies applied only to this operation (overrides or adds to API-level policies)
	Policies *[]Policy `json:"policies,omitempty" yaml:"policies,omitempty"`
}

type OperationMethod string

type Policy struct {
	// ExecutionCondition Expression controlling conditional execution of the policy
	ExecutionCondition *string `json:"executionCondition,omitempty" yaml:"executionCondition,omitempty"`

	// Name Name of the policy
	Name string `json:"name" yaml:"name"`

	// Params Arbitrary parameters for the policy (free-form key/value structure)
	Params *map[string]interface{} `json:"params,omitempty" yaml:"params,omitempty"`

	// Version Version of the policy. Only major-only version is allowed (e.g., v0, v1). Full semantic version (e.g., v1.0.0) is not accepted and will be rejected. The Gateway Controller resolves the major version to the single matching full version installed in the gateway image.
	Version string `json:"version" yaml:"version"`
}

type RegenerateAPIKeyJSONRequestBody = APIKeyRegenerationRequest

type RegenerateLLMProviderAPIKeyJSONRequestBody = APIKeyRegenerationRequest

type RegenerateLLMProxyAPIKeyJSONRequestBody = APIKeyRegenerationRequest

type RegenerateWebBrokerAPIKeyJSONRequestBody = APIKeyRegenerationRequest

type RegenerateWebSubAPIKeyJSONRequestBody = APIKeyRegenerationRequest

type ResourceStatus struct {
	// CreatedAt Timestamp when the resource was first created (UTC)
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// DeployedAt Timestamp when the resource was last deployed (omitted when undeployed)
	DeployedAt *time.Time `json:"deployedAt,omitempty" yaml:"deployedAt,omitempty"`

	// Id Unique identifier assigned by the server (equal to metadata.name)
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// State Desired deployment state reported by the server
	State *ResourceStatusState `json:"state,omitempty" yaml:"state,omitempty"`

	// UpdatedAt Timestamp when the resource was last updated (UTC)
	UpdatedAt *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`
}

type ResourceStatusState string

type RestAPI struct {
	// ApiVersion API specification version
	ApiVersion RestAPIApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind API type
	Kind     RestAPIKind   `json:"kind" yaml:"kind"`
	Metadata Metadata      `json:"metadata" yaml:"metadata"`
	Spec     APIConfigData `json:"spec" yaml:"spec"`

	// Status Server-managed lifecycle fields. Populated on responses.
	Status *ResourceStatus `json:"status,omitempty" yaml:"status,omitempty"`
}

type RestAPIApiVersion string

type RestAPIKind string

type RestAPIRequest struct {
	// ApiVersion API specification version
	ApiVersion RestAPIRequestApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind API type
	Kind     RestAPIRequestKind `json:"kind" yaml:"kind"`
	Metadata Metadata           `json:"metadata" yaml:"metadata"`
	Spec     APIConfigData      `json:"spec" yaml:"spec"`
}

type RestAPIRequestApiVersion string

type RestAPIRequestKind string

type RouteException struct {
	// Methods HTTP methods
	Methods []RouteExceptionMethods `json:"methods" yaml:"methods"`

	// Path Path pattern
	Path string `json:"path" yaml:"path"`
}

type RouteExceptionMethods string

type SecretConfigData struct {
	// Description Description of the secret
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable secret name (must be URL-friendly - only letters, numbers, spaces, hyphens, underscores, and dots allowed)
	DisplayName string `json:"displayName" yaml:"displayName"`

	// Value Secret value (stored encrypted)
	Value string `json:"value" yaml:"value"`
}

type SecretConfigListData struct {
	// Description Description of the secret, if the server includes it
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable secret name (must be URL-friendly - only letters, numbers, spaces, hyphens, underscores, and dots allowed)
	DisplayName string `json:"displayName" yaml:"displayName"`
}

type SecretConfigurationRequest struct {
	// ApiVersion Secret specification version
	ApiVersion SecretConfigurationRequestApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind Secret resource kind
	Kind     SecretConfigurationRequestKind `json:"kind" yaml:"kind"`
	Metadata Metadata                       `json:"metadata" yaml:"metadata"`
	Spec     SecretConfigData               `json:"spec" yaml:"spec"`
}

type SecretConfigurationRequestApiVersion string

type SecretConfigurationRequestKind string

type SecretConfigurationResponseCreateUpdate struct {
	ApiVersion SecretConfigurationResponseCreateUpdateApiVersion `json:"apiVersion" yaml:"apiVersion"`
	Kind       SecretConfigurationResponseCreateUpdateKind       `json:"kind" yaml:"kind"`
	Metadata   Metadata                                          `json:"metadata" yaml:"metadata"`
	Spec       SecretConfigListData                              `json:"spec" yaml:"spec"`

	// Status Id and optional timestamps. Not the full ResourceStatus model (no `state` or
	// `deployedAt`).
	Status SecretResourceServiceStatus `json:"status" yaml:"status"`
}

type SecretConfigurationResponseCreateUpdateApiVersion string

type SecretConfigurationResponseCreateUpdateKind string

type SecretConfigurationResponseRetrieved struct {
	ApiVersion SecretConfigurationResponseRetrievedApiVersion `json:"apiVersion" yaml:"apiVersion"`
	Kind       SecretConfigurationResponseRetrievedKind       `json:"kind" yaml:"kind"`
	Metadata   Metadata                                       `json:"metadata" yaml:"metadata"`
	Spec       SecretConfigData                               `json:"spec" yaml:"spec"`

	// Status Id and optional timestamps. Not the full ResourceStatus model (no `state` or
	// `deployedAt`).
	Status SecretResourceServiceStatus `json:"status" yaml:"status"`
}

type SecretConfigurationResponseRetrievedApiVersion string

type SecretConfigurationResponseRetrievedKind string

type SecretListItem struct {
	// ApiVersion Secret specification version
	ApiVersion SecretListItemApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind Secret resource kind
	Kind     SecretListItemKind   `json:"kind" yaml:"kind"`
	Metadata Metadata             `json:"metadata" yaml:"metadata"`
	Spec     SecretConfigListData `json:"spec" yaml:"spec"`

	// Status Server-managed lifecycle fields. Omitted in list items may vary; the secret value is never included here.
	Status *ResourceStatus `json:"status,omitempty" yaml:"status,omitempty"`
}

type SecretListItemApiVersion string

type SecretListItemKind string

type SecretListResponse struct {
	// Count Total number of secrets
	Count *int `json:"count,omitempty" yaml:"count,omitempty"`

	// Secrets List of secrets. For security, the spec.value field is omitted for every item in the list; retrieve a single secret by id to obtain the decrypted value.
	Secrets *[]SecretListItem `json:"secrets,omitempty" yaml:"secrets,omitempty"`
	Status  *string           `json:"status,omitempty" yaml:"status,omitempty"`
}

type SecretResourceServiceStatus struct {
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// Id Same as metadata.name / secret handle
	Id        string     `json:"id" yaml:"id"`
	UpdatedAt *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`
}

type ServerInterface interface {
	// List all custom certificates
	// (GET /certificates)
	ListCertificates(c *gin.Context)
	// Upload a new certificate
	// (POST /certificates)
	UploadCertificate(c *gin.Context)
	// Manually reload certificates
	// (POST /certificates/reload)
	ReloadCertificates(c *gin.Context)
	// Delete a certificate
	// (DELETE /certificates/{id})
	DeleteCertificate(c *gin.Context, id string)
	// List all LLM provider templates
	// (GET /llm-provider-templates)
	ListLLMProviderTemplates(c *gin.Context, params ListLLMProviderTemplatesParams)
	// Create a new LLM provider template
	// (POST /llm-provider-templates)
	CreateLLMProviderTemplate(c *gin.Context)
	// Delete an LLM provider template
	// (DELETE /llm-provider-templates/{id})
	DeleteLLMProviderTemplate(c *gin.Context, id string)
	// Get LLM provider template by id
	// (GET /llm-provider-templates/{id})
	GetLLMProviderTemplateById(c *gin.Context, id string)
	// Update an existing LLM provider template
	// (PUT /llm-provider-templates/{id})
	UpdateLLMProviderTemplate(c *gin.Context, id string)
	// List all LLM providers
	// (GET /llm-providers)
	ListLLMProviders(c *gin.Context, params ListLLMProvidersParams)
	// Create a new LLM provider
	// (POST /llm-providers)
	CreateLLMProvider(c *gin.Context)
	// Delete an LLM provider
	// (DELETE /llm-providers/{id})
	DeleteLLMProvider(c *gin.Context, id string)
	// Get LLM provider by identifier
	// (GET /llm-providers/{id})
	GetLLMProviderById(c *gin.Context, id string)
	// Update an existing LLM provider
	// (PUT /llm-providers/{id})
	UpdateLLMProvider(c *gin.Context, id string)
	// Get the list of API keys for an LLM provider
	// (GET /llm-providers/{id}/api-keys)
	ListLLMProviderAPIKeys(c *gin.Context, id string)
	// Create a new API key for an LLM provider
	// (POST /llm-providers/{id}/api-keys)
	CreateLLMProviderAPIKey(c *gin.Context, id string)
	// Revoke an API key for an LLM provider
	// (DELETE /llm-providers/{id}/api-keys/{apiKeyName})
	RevokeLLMProviderAPIKey(c *gin.Context, id string, apiKeyName string)
	// Update an API key for an LLM provider
	// (PUT /llm-providers/{id}/api-keys/{apiKeyName})
	UpdateLLMProviderAPIKey(c *gin.Context, id string, apiKeyName string)
	// Regenerate API key for an LLM provider
	// (POST /llm-providers/{id}/api-keys/{apiKeyName}/regenerate)
	RegenerateLLMProviderAPIKey(c *gin.Context, id string, apiKeyName string)
	// List all LLM proxies
	// (GET /llm-proxies)
	ListLLMProxies(c *gin.Context, params ListLLMProxiesParams)
	// Create a new LLM proxy
	// (POST /llm-proxies)
	CreateLLMProxy(c *gin.Context)
	// Delete an LLM proxy
	// (DELETE /llm-proxies/{id})
	DeleteLLMProxy(c *gin.Context, id string)
	// Get LLM proxy by unique identifier
	// (GET /llm-proxies/{id})
	GetLLMProxyById(c *gin.Context, id string)
	// Update an existing LLM proxy
	// (PUT /llm-proxies/{id})
	UpdateLLMProxy(c *gin.Context, id string)
	// Get the list of API keys for an LLM proxy
	// (GET /llm-proxies/{id}/api-keys)
	ListLLMProxyAPIKeys(c *gin.Context, id string)
	// Create a new API key for an LLM proxy
	// (POST /llm-proxies/{id}/api-keys)
	CreateLLMProxyAPIKey(c *gin.Context, id string)
	// Revoke an API key for an LLM proxy
	// (DELETE /llm-proxies/{id}/api-keys/{apiKeyName})
	RevokeLLMProxyAPIKey(c *gin.Context, id string, apiKeyName string)
	// Update an API key for an LLM proxy
	// (PUT /llm-proxies/{id}/api-keys/{apiKeyName})
	UpdateLLMProxyAPIKey(c *gin.Context, id string, apiKeyName string)
	// Regenerate API key for an LLM proxy
	// (POST /llm-proxies/{id}/api-keys/{apiKeyName}/regenerate)
	RegenerateLLMProxyAPIKey(c *gin.Context, id string, apiKeyName string)
	// List all MCPProxies
	// (GET /mcp-proxies)
	ListMCPProxies(c *gin.Context, params ListMCPProxiesParams)
	// Create a new MCPProxy
	// (POST /mcp-proxies)
	CreateMCPProxy(c *gin.Context)
	// Delete a MCPProxy
	// (DELETE /mcp-proxies/{id})
	DeleteMCPProxy(c *gin.Context, id string)
	// Get MCPProxy by id
	// (GET /mcp-proxies/{id})
	GetMCPProxyById(c *gin.Context, id string)
	// Update an existing MCPProxy
	// (PUT /mcp-proxies/{id})
	UpdateMCPProxy(c *gin.Context, id string)
	// List all RestAPIs
	// (GET /rest-apis)
	ListRestAPIs(c *gin.Context, params ListRestAPIsParams)
	// Create a new RestAPI
	// (POST /rest-apis)
	CreateRestAPI(c *gin.Context)
	// Delete a RestAPI
	// (DELETE /rest-apis/{id})
	DeleteRestAPI(c *gin.Context, id string)
	// Get RestAPI by id
	// (GET /rest-apis/{id})
	GetRestAPIById(c *gin.Context, id string)
	// Update an existing RestAPI
	// (PUT /rest-apis/{id})
	UpdateRestAPI(c *gin.Context, id string)
	// Get the list of API keys for an API
	// (GET /rest-apis/{id}/api-keys)
	ListAPIKeys(c *gin.Context, id string)
	// Create a new API key for an API
	// (POST /rest-apis/{id}/api-keys)
	CreateAPIKey(c *gin.Context, id string)
	// Revoke an API key
	// (DELETE /rest-apis/{id}/api-keys/{apiKeyName})
	RevokeAPIKey(c *gin.Context, id string, apiKeyName string)
	// Update an API key with a new regenerated value
	// (PUT /rest-apis/{id}/api-keys/{apiKeyName})
	UpdateAPIKey(c *gin.Context, id string, apiKeyName string)
	// Regenerate API key for an API
	// (POST /rest-apis/{id}/api-keys/{apiKeyName}/regenerate)
	RegenerateAPIKey(c *gin.Context, id string, apiKeyName string)
	// List all secrets
	// (GET /secrets)
	ListSecrets(c *gin.Context)
	// Create a new secret
	// (POST /secrets)
	CreateSecret(c *gin.Context)
	// Delete a secret
	// (DELETE /secrets/{id})
	DeleteSecret(c *gin.Context, id string)
	// Retrieve a secret
	// (GET /secrets/{id})
	GetSecret(c *gin.Context, id string)
	// Update a secret
	// (PUT /secrets/{id})
	UpdateSecret(c *gin.Context, id string)
	// List subscription plans
	// (GET /subscription-plans)
	ListSubscriptionPlans(c *gin.Context)
	// Create a subscription plan
	// (POST /subscription-plans)
	CreateSubscriptionPlan(c *gin.Context)
	// Delete a subscription plan
	// (DELETE /subscription-plans/{planId})
	DeleteSubscriptionPlan(c *gin.Context, planId string)
	// Get a subscription plan by ID
	// (GET /subscription-plans/{planId})
	GetSubscriptionPlan(c *gin.Context, planId string)
	// Update a subscription plan
	// (PUT /subscription-plans/{planId})
	UpdateSubscriptionPlan(c *gin.Context, planId string)
	// List subscriptions
	// (GET /subscriptions)
	ListSubscriptions(c *gin.Context, params ListSubscriptionsParams)
	// Create a subscription
	// (POST /subscriptions)
	CreateSubscription(c *gin.Context)
	// Delete a subscription
	// (DELETE /subscriptions/{subscriptionId})
	DeleteSubscription(c *gin.Context, subscriptionId string)
	// Get a subscription by ID
	// (GET /subscriptions/{subscriptionId})
	GetSubscription(c *gin.Context, subscriptionId string)
	// Update a subscription
	// (PUT /subscriptions/{subscriptionId})
	UpdateSubscription(c *gin.Context, subscriptionId string)
	// List all WebBrokerAPIs
	// (GET /webbroker-apis)
	ListWebBrokerApis(c *gin.Context, params ListWebBrokerApisParams)
	// Create a new WebBrokerAPI
	// (POST /webbroker-apis)
	CreateWebBrokerApi(c *gin.Context)
	// Delete a WebBrokerAPI
	// (DELETE /webbroker-apis/{id})
	DeleteWebBrokerApiById(c *gin.Context, id string)
	// Get WebBrokerAPI by id
	// (GET /webbroker-apis/{id})
	GetWebBrokerApiById(c *gin.Context, id string)
	// Get the list of API keys for a WebBroker API
	// (GET /webbroker-apis/{id}/api-keys)
	ListWebBrokerAPIKeys(c *gin.Context, id string)
	// Create a new API key for a WebBroker API
	// (POST /webbroker-apis/{id}/api-keys)
	CreateWebBrokerAPIKey(c *gin.Context, id string)
	// Revoke an API key for a WebBroker API
	// (DELETE /webbroker-apis/{id}/api-keys/{apiKeyName})
	RevokeWebBrokerAPIKey(c *gin.Context, id string, apiKeyName string)
	// Update an API key for a WebBroker API
	// (PUT /webbroker-apis/{id}/api-keys/{apiKeyName})
	UpdateWebBrokerAPIKey(c *gin.Context, id string, apiKeyName string)
	// Regenerate API key for a WebBroker API
	// (POST /webbroker-apis/{id}/api-keys/{apiKeyName}/regenerate)
	RegenerateWebBrokerAPIKey(c *gin.Context, id string, apiKeyName string)
	// List all WebSubAPIs
	// (GET /websub-apis)
	ListWebSubAPIs(c *gin.Context, params ListWebSubAPIsParams)
	// Create a new WebSubAPI
	// (POST /websub-apis)
	CreateWebSubAPI(c *gin.Context)
	// Delete a WebSubAPI
	// (DELETE /websub-apis/{id})
	DeleteWebSubAPI(c *gin.Context, id string)
	// Get WebSubAPI by id
	// (GET /websub-apis/{id})
	GetWebSubAPIById(c *gin.Context, id string)
	// Update an existing WebSubAPI
	// (PUT /websub-apis/{id})
	UpdateWebSubAPI(c *gin.Context, id string)
	// Get the list of API keys for a WebSub API
	// (GET /websub-apis/{id}/api-keys)
	ListWebSubAPIKeys(c *gin.Context, id string)
	// Create a new API key for a WebSub API
	// (POST /websub-apis/{id}/api-keys)
	CreateWebSubAPIKey(c *gin.Context, id string)
	// Revoke an API key for a WebSub API
	// (DELETE /websub-apis/{id}/api-keys/{apiKeyName})
	RevokeWebSubAPIKey(c *gin.Context, id string, apiKeyName string)
	// Update an API key for a WebSub API
	// (PUT /websub-apis/{id}/api-keys/{apiKeyName})
	UpdateWebSubAPIKey(c *gin.Context, id string, apiKeyName string)
	// Regenerate API key for a WebSub API
	// (POST /websub-apis/{id}/api-keys/{apiKeyName}/regenerate)
	RegenerateWebSubAPIKey(c *gin.Context, id string, apiKeyName string)
}

type ServerInterfaceWrapper struct {
	Handler            ServerInterface
	HandlerMiddlewares []MiddlewareFunc
	ErrorHandler       func(*gin.Context, error, int)
}

type SubscriptionCreateRequest struct {
	// ApiId API identifier (deployment ID or handle)
	ApiId string `json:"apiId" yaml:"apiId"`

	// ApplicationId Application identifier (from DevPortal/STS). Optional for token-based subscriptions.
	ApplicationId *string `json:"applicationId,omitempty" yaml:"applicationId,omitempty"`

	// BillingCustomerId Billing customer identifier (optional, for analytics tracking).
	BillingCustomerId *string `json:"billingCustomerId,omitempty" yaml:"billingCustomerId,omitempty"`

	// BillingSubscriptionId Billing subscription identifier (optional, for analytics tracking).
	BillingSubscriptionId *string                          `json:"billingSubscriptionId,omitempty" yaml:"billingSubscriptionId,omitempty"`
	Status                *SubscriptionCreateRequestStatus `json:"status,omitempty" yaml:"status,omitempty"`

	// SubscriptionPlanId Subscription plan UUID for rate limit and billing configuration.
	SubscriptionPlanId *string `json:"subscriptionPlanId,omitempty" yaml:"subscriptionPlanId,omitempty"`

	// SubscriptionToken Opaque subscription token for API invocation (required; stored as hash only)
	SubscriptionToken string `json:"subscriptionToken" yaml:"subscriptionToken"`
}

type SubscriptionCreateRequestStatus string

type SubscriptionListResponse struct {
	Count         *int                    `json:"count,omitempty" yaml:"count,omitempty"`
	Subscriptions *[]SubscriptionResponse `json:"subscriptions,omitempty" yaml:"subscriptions,omitempty"`
}

type SubscriptionPlanCreateRequest struct {
	BillingPlan        *string                                         `json:"billingPlan,omitempty" yaml:"billingPlan,omitempty"`
	ExpiryTime         *time.Time                                      `json:"expiryTime,omitempty" yaml:"expiryTime,omitempty"`
	PlanName           string                                          `json:"planName" yaml:"planName"`
	Status             *SubscriptionPlanCreateRequestStatus            `json:"status,omitempty" yaml:"status,omitempty"`
	StopOnQuotaReach   *bool                                           `json:"stopOnQuotaReach,omitempty" yaml:"stopOnQuotaReach,omitempty"`
	ThrottleLimitCount *int                                            `json:"throttleLimitCount,omitempty" yaml:"throttleLimitCount,omitempty"`
	ThrottleLimitUnit  *SubscriptionPlanCreateRequestThrottleLimitUnit `json:"throttleLimitUnit,omitempty" yaml:"throttleLimitUnit,omitempty"`
}

type SubscriptionPlanCreateRequestStatus string

type SubscriptionPlanCreateRequestThrottleLimitUnit string

type SubscriptionPlanListResponse struct {
	Count             *int                        `json:"count,omitempty" yaml:"count,omitempty"`
	SubscriptionPlans *[]SubscriptionPlanResponse `json:"subscriptionPlans,omitempty" yaml:"subscriptionPlans,omitempty"`
}

type SubscriptionPlanResponse struct {
	BillingPlan        *string                         `json:"billingPlan,omitempty" yaml:"billingPlan,omitempty"`
	CreatedAt          *time.Time                      `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`
	ExpiryTime         *time.Time                      `json:"expiryTime,omitempty" yaml:"expiryTime,omitempty"`
	GatewayId          *string                         `json:"gatewayId,omitempty" yaml:"gatewayId,omitempty"`
	Id                 *string                         `json:"id,omitempty" yaml:"id,omitempty"`
	PlanName           *string                         `json:"planName,omitempty" yaml:"planName,omitempty"`
	Status             *SubscriptionPlanResponseStatus `json:"status,omitempty" yaml:"status,omitempty"`
	StopOnQuotaReach   *bool                           `json:"stopOnQuotaReach,omitempty" yaml:"stopOnQuotaReach,omitempty"`
	ThrottleLimitCount *int                            `json:"throttleLimitCount,omitempty" yaml:"throttleLimitCount,omitempty"`
	ThrottleLimitUnit  *string                         `json:"throttleLimitUnit,omitempty" yaml:"throttleLimitUnit,omitempty"`
	UpdatedAt          *time.Time                      `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`
}

type SubscriptionPlanResponseStatus string

type SubscriptionPlanUpdateRequest struct {
	BillingPlan        *string                                         `json:"billingPlan,omitempty" yaml:"billingPlan,omitempty"`
	ExpiryTime         *time.Time                                      `json:"expiryTime,omitempty" yaml:"expiryTime,omitempty"`
	PlanName           *string                                         `json:"planName,omitempty" yaml:"planName,omitempty"`
	Status             *SubscriptionPlanUpdateRequestStatus            `json:"status,omitempty" yaml:"status,omitempty"`
	StopOnQuotaReach   *bool                                           `json:"stopOnQuotaReach,omitempty" yaml:"stopOnQuotaReach,omitempty"`
	ThrottleLimitCount *int                                            `json:"throttleLimitCount,omitempty" yaml:"throttleLimitCount,omitempty"`
	ThrottleLimitUnit  *SubscriptionPlanUpdateRequestThrottleLimitUnit `json:"throttleLimitUnit,omitempty" yaml:"throttleLimitUnit,omitempty"`
}

type SubscriptionPlanUpdateRequestStatus string

type SubscriptionPlanUpdateRequestThrottleLimitUnit string

type SubscriptionResponse struct {
	ApiId         *string `json:"apiId,omitempty" yaml:"apiId,omitempty"`
	ApplicationId *string `json:"applicationId,omitempty" yaml:"applicationId,omitempty"`

	// BillingCustomerId Billing customer identifier
	BillingCustomerId *string `json:"billingCustomerId,omitempty" yaml:"billingCustomerId,omitempty"`

	// BillingSubscriptionId Billing subscription identifier
	BillingSubscriptionId *string                     `json:"billingSubscriptionId,omitempty" yaml:"billingSubscriptionId,omitempty"`
	CreatedAt             *time.Time                  `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`
	GatewayId             *string                     `json:"gatewayId,omitempty" yaml:"gatewayId,omitempty"`
	Id                    *string                     `json:"id,omitempty" yaml:"id,omitempty"`
	Status                *SubscriptionResponseStatus `json:"status,omitempty" yaml:"status,omitempty"`

	// SubscriptionPlanId Subscription plan UUID
	SubscriptionPlanId *string `json:"subscriptionPlanId,omitempty" yaml:"subscriptionPlanId,omitempty"`

	// SubscriptionToken Opaque subscription token (returned only on create; use Platform-API to retrieve for existing subscriptions)
	SubscriptionToken *string    `json:"subscriptionToken,omitempty" yaml:"subscriptionToken,omitempty"`
	UpdatedAt         *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`
}

type SubscriptionResponseStatus string

type SubscriptionUpdateRequest struct {
	Status *SubscriptionUpdateRequestStatus `json:"status,omitempty" yaml:"status,omitempty"`
}

type SubscriptionUpdateRequestStatus string

type UpdateAPIKeyJSONRequestBody = APIKeyUpdateRequest

type UpdateLLMProviderAPIKeyJSONRequestBody = APIKeyUpdateRequest

type UpdateLLMProviderJSONRequestBody = LLMProviderConfigurationRequest

type UpdateLLMProviderTemplateJSONRequestBody = LLMProviderTemplateRequest

type UpdateLLMProxyAPIKeyJSONRequestBody = APIKeyUpdateRequest

type UpdateLLMProxyJSONRequestBody = LLMProxyConfigurationRequest

type UpdateMCPProxyJSONRequestBody = MCPProxyConfigurationRequest

type UpdateRestAPIJSONRequestBody = RestAPIRequest

type UpdateSecretJSONRequestBody = SecretConfigurationRequest

type UpdateSubscriptionJSONRequestBody = SubscriptionUpdateRequest

type UpdateSubscriptionPlanJSONRequestBody = SubscriptionPlanUpdateRequest

type UpdateWebBrokerAPIKeyJSONRequestBody = APIKeyUpdateRequest

type UpdateWebSubAPIJSONRequestBody = WebSubAPIRequest

type UpdateWebSubAPIKeyJSONRequestBody = APIKeyUpdateRequest

type UploadCertificateJSONRequestBody = CertificateUploadRequest

type Upstream struct {
	// HostRewrite Controls how the Host header is handled when routing to the upstream. `auto` delegates host rewriting to Envoy, which rewrites the Host header using the upstream cluster host. `manual` disables automatic rewriting and expects explicit configuration.
	HostRewrite *UpstreamHostRewrite `json:"hostRewrite,omitempty" yaml:"hostRewrite,omitempty"`

	// Ref Reference to a predefined upstreamDefinition
	Ref *string `json:"ref,omitempty" yaml:"ref,omitempty"`

	// Url Direct backend URL to route traffic to
	Url *string `json:"url,omitempty" yaml:"url,omitempty"`
	// contains filtered or unexported fields
}

type Upstream0 = interface{}

type Upstream1 = interface{}

type UpstreamAuth struct {
	Auth *struct {
		Header *string              `json:"header,omitempty" yaml:"header,omitempty"`
		Type   UpstreamAuthAuthType `json:"type" yaml:"type"`
		Value  *string              `json:"value,omitempty" yaml:"value,omitempty"`
	} `json:"auth,omitempty" yaml:"auth,omitempty"`
}

type UpstreamAuthAuthType string

type UpstreamDefinition struct {
	// BasePath Base path prefix for all endpoints in this upstream (e.g., /api/v2). All requests to this upstream will have this path prepended.
	BasePath *string `json:"basePath,omitempty" yaml:"basePath,omitempty"`

	// Name Unique identifier for this upstream definition
	Name string `json:"name" yaml:"name"`

	// Timeout Timeout configuration for upstream requests
	Timeout *UpstreamTimeout `json:"timeout,omitempty" yaml:"timeout,omitempty"`

	// Upstreams List of backend targets with optional weights for load balancing
	Upstreams []struct {
		// Url Backend URL (host and port only, path comes from basePath)
		Url string `json:"url" yaml:"url"`

		// Weight Weight for load balancing (optional, default 100)
		Weight *int `json:"weight,omitempty" yaml:"weight,omitempty"`
	} `json:"upstreams" yaml:"upstreams"`
}

type UpstreamHostRewrite string

type UpstreamTimeout struct {
	// Connect Connection timeout duration (e.g., "5s", "500ms")
	Connect *string `json:"connect,omitempty" yaml:"connect,omitempty"`
}

type ValidationError struct {
	// Field Field that failed validation
	Field *string `json:"field,omitempty" yaml:"field,omitempty"`

	// Message Human-readable error message
	Message *string `json:"message,omitempty" yaml:"message,omitempty"`
}

type WebBrokerApi struct {
	// ApiVersion API specification version
	ApiVersion WebBrokerApiApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind API type
	Kind     WebBrokerApiKind `json:"kind" yaml:"kind"`
	Metadata Metadata         `json:"metadata" yaml:"metadata"`
	Spec     WebBrokerApiData `json:"spec" yaml:"spec"`

	// Status Server-managed lifecycle fields. Populated on responses.
	Status *ResourceStatus `json:"status,omitempty" yaml:"status,omitempty"`
}

type WebBrokerApiAllChannelPolicies struct {
	// OnConnectionInit Group of policies
	OnConnectionInit *WebBrokerApiPolicyGroup `json:"on_connection_init,omitempty" yaml:"on_connection_init,omitempty"`

	// OnConsume Group of policies
	OnConsume *WebBrokerApiPolicyGroup `json:"on_consume,omitempty" yaml:"on_consume,omitempty"`

	// OnProduce Group of policies
	OnProduce *WebBrokerApiPolicyGroup `json:"on_produce,omitempty" yaml:"on_produce,omitempty"`
}

type WebBrokerApiApiVersion string

type WebBrokerApiBroker struct {
	// Name Broker driver name
	Name string `json:"name" yaml:"name"`

	// Properties Broker driver properties (e.g., bootstrap servers)
	Properties map[string]interface{} `json:"properties" yaml:"properties"`

	// Type Broker driver type
	Type string `json:"type" yaml:"type"`
}

type WebBrokerApiChannel struct {
	// ConsumeFrom Configuration for consuming messages from Kafka to WebSocket
	ConsumeFrom *WebBrokerApiConsumeConfig `json:"consumeFrom,omitempty" yaml:"consumeFrom,omitempty"`

	// OnConnectionInit Group of policies
	OnConnectionInit *WebBrokerApiPolicyGroup `json:"on_connection_init,omitempty" yaml:"on_connection_init,omitempty"`

	// OnConsume Group of policies
	OnConsume *WebBrokerApiPolicyGroup `json:"on_consume,omitempty" yaml:"on_consume,omitempty"`

	// OnProduce Group of policies
	OnProduce *WebBrokerApiPolicyGroup `json:"on_produce,omitempty" yaml:"on_produce,omitempty"`

	// ProduceTo Configuration for producing messages from WebSocket to Kafka
	ProduceTo *WebBrokerApiProduceConfig `json:"produceTo,omitempty" yaml:"produceTo,omitempty"`
}

type WebBrokerApiConsumeConfig struct {
	// Topic Kafka topic to consume messages from
	Topic string `json:"topic" yaml:"topic"`
}

type WebBrokerApiData struct {
	// AllChannels Protocol mediation policies applied to all channels
	AllChannels *WebBrokerApiAllChannelPolicies `json:"allChannels,omitempty" yaml:"allChannels,omitempty"`

	// Broker Message broker driver configuration
	Broker WebBrokerApiBroker `json:"broker" yaml:"broker"`

	// Channels Map of WebSocket channels for bidirectional streaming with Kafka (key is channel name)
	Channels map[string]WebBrokerApiChannel `json:"channels" yaml:"channels"`

	// Context Base path for all API routes (must start with /, no trailing slash)
	Context string `json:"context" yaml:"context"`

	// DeploymentState Desired deployment state - 'deployed' (default) or 'undeployed'. When set to 'undeployed', the API is removed from router traffic but configuration and policies are preserved for potential redeployment.
	DeploymentState *WebBrokerApiDataDeploymentState `json:"deploymentState,omitempty" yaml:"deploymentState,omitempty"`

	// DisplayName Human-readable API name (must be URL-friendly - only letters, numbers, spaces, hyphens, underscores, and dots allowed)
	DisplayName string `json:"displayName" yaml:"displayName"`

	// Receiver WebSocket receiver configuration
	Receiver WebBrokerApiReceiver `json:"receiver" yaml:"receiver"`

	// Version Semantic version of the API
	Version string `json:"version" yaml:"version"`

	// Vhosts Custom virtual hosts/domains for the API
	Vhosts *struct {
		// Main Custom virtual host/domain for production traffic
		Main string `json:"main" yaml:"main"`

		// Sandbox Custom virtual host/domain for sandbox traffic
		Sandbox *string `json:"sandbox,omitempty" yaml:"sandbox,omitempty"`
	} `json:"vhosts,omitempty" yaml:"vhosts,omitempty"`
}

type WebBrokerApiDataDeploymentState string

type WebBrokerApiKind string

type WebBrokerApiPolicyGroup struct {
	// Policies List of policies to apply
	Policies *[]Policy `json:"policies,omitempty" yaml:"policies,omitempty"`
}

type WebBrokerApiProduceConfig struct {
	// Topic Kafka topic to produce messages to
	Topic string `json:"topic" yaml:"topic"`
}

type WebBrokerApiReceiver struct {
	// Name Receiver name
	Name string `json:"name" yaml:"name"`

	// Properties Additional receiver properties
	Properties *map[string]interface{} `json:"properties,omitempty" yaml:"properties,omitempty"`

	// Type Receiver type
	Type string `json:"type" yaml:"type"`
}

type WebBrokerApiRequest struct {
	// ApiVersion API specification version
	ApiVersion WebBrokerApiRequestApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind API type
	Kind     WebBrokerApiRequestKind `json:"kind" yaml:"kind"`
	Metadata Metadata                `json:"metadata" yaml:"metadata"`
	Spec     WebBrokerApiData        `json:"spec" yaml:"spec"`
}

type WebBrokerApiRequestApiVersion string

type WebBrokerApiRequestKind string

type WebSubAPI struct {
	// ApiVersion API specification version
	ApiVersion WebSubAPIApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind API type
	Kind     WebSubAPIKind  `json:"kind" yaml:"kind"`
	Metadata Metadata       `json:"metadata" yaml:"metadata"`
	Spec     WebhookAPIData `json:"spec" yaml:"spec"`

	// Status Server-managed lifecycle fields. Populated on responses.
	Status *ResourceStatus `json:"status,omitempty" yaml:"status,omitempty"`
}

type WebSubAPIApiVersion string

type WebSubAPIKind string

type WebSubAPIRequest struct {
	// ApiVersion API specification version
	ApiVersion WebSubAPIRequestApiVersion `json:"apiVersion" yaml:"apiVersion"`

	// Kind API type
	Kind     WebSubAPIRequestKind `json:"kind" yaml:"kind"`
	Metadata Metadata             `json:"metadata" yaml:"metadata"`
	Spec     WebhookAPIData       `json:"spec" yaml:"spec"`
}

type WebSubAPIRequestApiVersion string

type WebSubAPIRequestKind string

type WebSubAllChannelPolicies struct {
	// OnMessageDelivery Policies for a single event type.
	OnMessageDelivery *WebSubEventPolicies `json:"on_message_delivery,omitempty" yaml:"on_message_delivery,omitempty"`

	// OnMessageReceived Policies for a single event type.
	OnMessageReceived *WebSubEventPolicies `json:"on_message_received,omitempty" yaml:"on_message_received,omitempty"`

	// OnSubscription Policies for a single event type.
	OnSubscription *WebSubEventPolicies `json:"on_subscription,omitempty" yaml:"on_subscription,omitempty"`

	// OnUnsubscription Policies for a single event type.
	OnUnsubscription *WebSubEventPolicies `json:"on_unsubscription,omitempty" yaml:"on_unsubscription,omitempty"`
}

type WebSubChannel struct {
	// OnMessageDelivery Policies for a single event type.
	OnMessageDelivery *WebSubEventPolicies `json:"on_message_delivery,omitempty" yaml:"on_message_delivery,omitempty"`

	// OnMessageReceived Policies for a single event type.
	OnMessageReceived *WebSubEventPolicies `json:"on_message_received,omitempty" yaml:"on_message_received,omitempty"`

	// OnSubscription Policies for a single event type.
	OnSubscription *WebSubEventPolicies `json:"on_subscription,omitempty" yaml:"on_subscription,omitempty"`

	// OnUnsubscription Policies for a single event type.
	OnUnsubscription *WebSubEventPolicies `json:"on_unsubscription,omitempty" yaml:"on_unsubscription,omitempty"`
}

type WebSubEventPolicies struct {
	// Policies List of policies applied for this event type.
	Policies *[]Policy `json:"policies,omitempty" yaml:"policies,omitempty"`
}

type WebhookAPIData struct {
	// AllChannels Policies applied to all channels, organized by event type.
	AllChannels *WebSubAllChannelPolicies `json:"allChannels,omitempty" yaml:"allChannels,omitempty"`

	// Channels Per-channel configuration keyed by channel name. Each key is a channel name and defines policies applied only to that channel.
	Channels *map[string]WebSubChannel `json:"channels,omitempty" yaml:"channels,omitempty"`

	// Context Base path for all API routes (must start with /, no trailing slash)
	Context string `json:"context" yaml:"context"`

	// DeploymentState Desired deployment state - 'deployed' (default) or 'undeployed'. When set to 'undeployed', the API is removed from router traffic but configuration, API keys, and policies are preserved for potential redeployment.
	DeploymentState *WebhookAPIDataDeploymentState `json:"deploymentState,omitempty" yaml:"deploymentState,omitempty"`

	// DisplayName Human-readable API name (must be URL-friendly - only letters, numbers, spaces, hyphens, underscores, and dots allowed)
	DisplayName string `json:"displayName" yaml:"displayName"`

	// Version Semantic version of the API
	Version string `json:"version" yaml:"version"`

	// Vhosts Custom virtual hosts/domains for the API
	Vhosts *struct {
		// Main Custom virtual host/domain for production traffic
		Main string `json:"main" yaml:"main"`

		// Sandbox Custom virtual host/domain for sandbox traffic
		Sandbox *string `json:"sandbox,omitempty" yaml:"sandbox,omitempty"`
	} `json:"vhosts,omitempty" yaml:"vhosts,omitempty"`
}

type WebhookAPIDataDeploymentState string