api

type APIKeyItem struct {
	// AllowedTargets Comma-separated list of allowed gateways; 'ALL' means unrestricted
	AllowedTargets string `binding:"required" json:"allowedTargets" yaml:"allowedTargets"`

	// CreatedAt Timestamp when the key was created
	CreatedAt time.Time `binding:"required" json:"createdAt" yaml:"createdAt"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `binding:"required" json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// DisplayName Human-readable display name of the API key
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// ExpiresAt Optional expiration timestamp
	ExpiresAt *time.Time `json:"expiresAt,omitempty" yaml:"expiresAt,omitempty"`

	// Id URL-safe handle (identifier) of the API key (generated from displayName when not supplied)
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Issuer Optional identifier of the developer portal that provisioned this key
	Issuer *string `json:"issuer,omitempty" yaml:"issuer,omitempty"`

	// MaskedApiKey Masked representation of the API key for display purposes
	MaskedApiKey string `binding:"required" json:"maskedApiKey" yaml:"maskedApiKey"`

	// Status Current status of the key
	Status APIKeyItemStatus `binding:"required" json:"status" yaml:"status"`

	// UpdatedAt Timestamp when the key was last updated
	UpdatedAt time.Time `binding:"required" json:"updatedAt" yaml:"updatedAt"`
}

type APIKeyItemStatus string

type APIKeyMappingAssociatedEntity struct {
	// Id ID of the entity that owns the API key
	Id string `binding:"required" json:"id" yaml:"id"`
}

type APIKeyMappingSelector struct {
	AssociatedEntity APIKeyMappingAssociatedEntity `json:"associatedEntity" yaml:"associatedEntity"`

	// KeyId API key name
	KeyId string `binding:"required" json:"keyId" yaml:"keyId"`
}

type APIKeySecurity struct {
	// Enabled Whether API key authentication is enabled
	Enabled *bool `json:"enabled,omitempty" yaml:"enabled,omitempty"`

	// In Location of the API key (header or query)
	In *APIKeySecurityIn `json:"in,omitempty" yaml:"in,omitempty"`

	// Key Name of the header or query parameter to be used for the API key
	Key *string `json:"key,omitempty" yaml:"key,omitempty"`
}

type APIKeySecurityIn string

type AddApplicationAPIKeysJSONRequestBody = AddApplicationAPIKeysRequest

type AddApplicationAPIKeysRequest struct {
	// ApiKeys List of API key selectors to add to the application mappings
	ApiKeys []APIKeyMappingSelector `binding:"required" json:"apiKeys" yaml:"apiKeys"`
}

type AddApplicationAssociationsJSONRequestBody = AddApplicationAssociationsRequest

type AddApplicationAssociationsRequest struct {
	// Associations List of association selectors to add to the application
	Associations []ApplicationAssociationSelector `binding:"required" json:"associations" yaml:"associations"`
}

type AddGatewayToRESTAPIRequest struct {
	// GatewayId Handle (URL-friendly slug) of the gateway to associate with the REST API
	GatewayId string `binding:"required" json:"gatewayId" yaml:"gatewayId"`
}

type AddGatewaysToAPIJSONBody = []AddGatewayToRESTAPIRequest

type AddGatewaysToAPIJSONRequestBody = AddGatewaysToAPIJSONBody

type ApiId = string

type AppId = string

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

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// Description Description of the application
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable name for the application
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Id Application handle/identifier
	Id string `binding:"required" json:"id" yaml:"id"`

	// ProjectId Handle (URL-friendly slug) of the project this application belongs to
	ProjectId string `binding:"required" json:"projectId" yaml:"projectId"`

	// Type Type of the application
	Type      ApplicationType `json:"type" yaml:"type"`
	UpdatedAt *time.Time      `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// UpdatedBy User identifier of the user who last updated this resource. Only present in the detail response (GET /applications/{appId}), omitted from list responses.
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`
}

type ApplicationAssociation struct {
	// CreatedAt Timestamp when the association was created
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// DisplayName Human-readable name for the associated target
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Id Handle/ID of the associated target
	Id string `binding:"required" json:"id" yaml:"id"`

	// Kind Type of associated target
	Kind string `binding:"required" json:"kind" yaml:"kind"`

	// UpdatedAt Timestamp when the association was updated
	UpdatedAt *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// Version Version of the associated target
	Version string `binding:"required" json:"version" yaml:"version"`
}

type ApplicationAssociationListResponse struct {
	// Count Number of items in current response
	Count      int                      `binding:"required" json:"count" yaml:"count"`
	List       []ApplicationAssociation `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination               `json:"pagination" yaml:"pagination"`
}

type ApplicationAssociationSelector struct {
	// Id ID or handle of the association target
	Id string `binding:"required" json:"id" yaml:"id"`

	// Kind Type of the association target
	Kind ApplicationAssociationSelectorKind `binding:"required" json:"kind" yaml:"kind"`
}

type ApplicationAssociationSelectorKind string

type ApplicationListResponse struct {
	// Count Number of items in current response
	Count      int           `binding:"required" json:"count" yaml:"count"`
	List       []Application `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination    `json:"pagination" yaml:"pagination"`
}

type ApplicationType string

type AssociatedEntity struct {
	// Id ID of the associated entity
	Id string `binding:"required" json:"id" yaml:"id"`

	// Kind Type of the associated entity
	Kind string `binding:"required" json:"kind" yaml:"kind"`
}

type AssociatedGateway struct {
	// Configurations Per-gateway configuration overrides for this artifact. This is a free-form object; the supported keys depend on the deployed artifact type.
	Configurations *map[string]interface{} `json:"configurations,omitempty" yaml:"configurations,omitempty"`

	// Id Handle of the gateway this artifact can be deployed to
	Id string `binding:"required" json:"id" yaml:"id"`
}

type AssociationId = string

type BadRequest = Error

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

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

	// Request Request details for a channel within the Async API
	Request ChannelRequest `json:"request" yaml:"request"`
}

type ChannelRequest struct {
	// Method Async method for the channel
	Method ChannelRequestMethod `binding:"required" json:"method" yaml:"method"`

	// Name Channel name for the event
	Name string `binding:"required" json:"name" yaml:"name"`

	// Policies List of policies to be applied on the operation
	Policies *[]Policy `json:"policies,omitempty" yaml:"policies,omitempty"`
}

type ChannelRequestMethod string

type Conflict = Error

type CopyLLMProviderTemplateVersionJSONRequestBody = CreateLLMProviderTemplateVersionRequest

type CopyLLMProviderTemplateVersionParams struct {
	// FromTemplateId Handle (id) of the source version to copy from.
	FromTemplateId string `form:"fromTemplateId" json:"fromTemplateId" yaml:"fromTemplateId"`

	// ToTemplateId Expected handle of the new version. Must equal the handle derived from the source family and toVersion; used to validate the target.
	ToTemplateId *string `form:"toTemplateId,omitempty" json:"toTemplateId,omitempty" yaml:"toTemplateId,omitempty"`

	// ToVersion New version identifier, e.g. v4.0. Must match v<major>.<minor> with a major of at least 1, and be unique within the family.
	ToVersion string `form:"toVersion" json:"toVersion" yaml:"toVersion"`
}

type CostRateLimitDimension struct {
	// Amount Maximum cost in the reset window.
	Amount *float32 `json:"amount,omitempty" yaml:"amount,omitempty"`

	// Enabled Enable cost-based limiting.
	Enabled *bool                 `json:"enabled,omitempty" yaml:"enabled,omitempty"`
	Reset   *RateLimitResetWindow `json:"reset,omitempty" yaml:"reset,omitempty"`
}

type CreateAPIKeyJSONRequestBody = CreateAPIKeyRequest

type CreateAPIKeyRequest struct {
	// ApiKey The plain text API key value that will be hashed before storage
	ApiKey string `binding:"required" json:"apiKey" yaml:"apiKey"`

	// DisplayName Human-readable name for the API key
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// ExpiresAt Optional expiration time in ISO 8601 format
	ExpiresAt *time.Time          `json:"expiresAt" yaml:"expiresAt"`
	ExpiresIn *ExpirationDuration `json:"expiresIn,omitempty" yaml:"expiresIn,omitempty"`

	// ExternalRefId Optional reference ID for tracing purposes (from external platforms)
	ExternalRefId *string `json:"externalRefId" yaml:"externalRefId"`

	// Id Unique identifier for this API key within the API (optional; if omitted,
	// generated from displayName)
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Issuer Identifier of the developer portal that provisioned this API key. Null if not provided.
	Issuer *string `json:"issuer" yaml:"issuer"`
}

type CreateAPIKeyResponse struct {
	// KeyId The internal ID generated for tracking
	KeyId *string `json:"keyId,omitempty" yaml:"keyId,omitempty"`

	// Message Additional details about the operation result
	Message string `binding:"required" json:"message" yaml:"message"`

	// Status Status of the operation
	Status CreateAPIKeyResponseStatus `binding:"required" json:"status" yaml:"status"`
}

type CreateAPIKeyResponseStatus string

type CreateApplicationJSONRequestBody = CreateApplicationRequest

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

	// DisplayName Human-readable name for the application
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Id Unique handle/identifier for the application. Can be provided during creation or auto-generated.
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// ProjectId Handle (URL-friendly slug) of the project this application belongs to.
	ProjectId string `binding:"required" json:"projectId" yaml:"projectId"`

	// Type Type of the application
	Type ApplicationType `json:"type" yaml:"type"`
}

type CreateGatewayJSONRequestBody = CreateGatewayRequest

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

	// DisplayName Human-readable gateway name
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Endpoints Network endpoints exposed by this gateway, each as a full URL string
	Endpoints []string `binding:"required" json:"endpoints" yaml:"endpoints"`

	// FunctionalityType Type of gateway functionality
	FunctionalityType CreateGatewayRequestFunctionalityType `binding:"required" json:"functionalityType" yaml:"functionalityType"`

	// Id Handle (URL-friendly slug) for the gateway. Immutable after creation.
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// IsCritical Whether the gateway is critical for production
	IsCritical *bool `json:"isCritical,omitempty" yaml:"isCritical,omitempty"`

	// Properties Custom key-value properties for the gateway
	Properties *map[string]interface{} `json:"properties,omitempty" yaml:"properties,omitempty"`

	// Version Gateway version in `major.minor` format (e.g. `1.0`) or CalVer `YYYY.MM.DD` format (e.g. `2026.05.13`). Defaults to `1.0` if not provided.
	Version *string `json:"version,omitempty" yaml:"version,omitempty"`
}

type CreateGatewayRequestFunctionalityType string

type CreateLLMProviderAPIKeyJSONRequestBody = CreateLLMProviderAPIKeyRequest

type CreateLLMProviderAPIKeyRequest struct {
	// AllowedTargets Comma-separated list of gateways this key is valid for.
	// Use 'ALL' to allow all targets (default).
	AllowedTargets *string `json:"allowedTargets" yaml:"allowedTargets"`

	// DisplayName Human-readable name for the API key
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// ExpiresAt Optional expiration time in ISO 8601 format
	ExpiresAt *time.Time `json:"expiresAt,omitempty" yaml:"expiresAt,omitempty"`

	// Id Unique identifier for the API key within the LLM provider. If not provided, generated from displayName.
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Issuer Identifier of the developer portal that provisioned this API key. Null if not provided.
	Issuer *string `json:"issuer" yaml:"issuer"`
}

type CreateLLMProviderAPIKeyResponse struct {
	// ApiKey The generated API key value (shown only once, 64 hexadecimal characters)
	ApiKey string `binding:"required" json:"apiKey" yaml:"apiKey"`

	// Id Unique identifier of the generated key
	Id string `binding:"required" json:"id" yaml:"id"`

	// Message Detailed message about the operation result
	Message string `binding:"required" json:"message" yaml:"message"`

	// Status Status of the operation
	Status string `binding:"required" json:"status" yaml:"status"`
}

type CreateLLMProviderJSONRequestBody = LLMProvider

type CreateLLMProviderTemplateJSONRequestBody = LLMProviderTemplate

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

	// Description Description of the LLM provider template
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable LLM Template name. Optional — when omitted, the new
	// version inherits the family's existing name. Supplying a different
	// value renames the template family.
	DisplayName *string `json:"displayName,omitempty" yaml:"displayName,omitempty"`

	// ManagedBy Identifies who manages the template. Custom templates default to 'organization'.
	ManagedBy *string                      `json:"managedBy,omitempty" yaml:"managedBy,omitempty"`
	Metadata  *LLMProviderTemplateMetadata `json:"metadata,omitempty" yaml:"metadata,omitempty"`

	// Openapi OpenAPI specification content (JSON or YAML) for the provider, when
	// uploaded/pasted. Use metadata.openapiSpecUrl instead to reference the
	// spec by URL.
	Openapi          *string                              `json:"openapi,omitempty" yaml:"openapi,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"`
	ResourceMappings *LLMProviderTemplateResourceMappings `json:"resourceMappings,omitempty" yaml:"resourceMappings,omitempty"`
	ResponseModel    *ExtractionIdentifier                `json:"responseModel,omitempty" yaml:"responseModel,omitempty"`
	TotalTokens      *ExtractionIdentifier                `json:"totalTokens,omitempty" yaml:"totalTokens,omitempty"`

	// Version New version identifier, e.g. v2.0. Must be unique for this template.
	Version string `binding:"required" json:"version" yaml:"version"`
}

type CreateLLMProxyAPIKeyJSONRequestBody = CreateLLMProxyAPIKeyRequest

type CreateLLMProxyAPIKeyRequest struct {
	// AllowedTargets Comma-separated list of gateways this key is valid for.
	// Use 'ALL' to allow all targets (default).
	AllowedTargets *string `json:"allowedTargets" yaml:"allowedTargets"`

	// DisplayName Human-readable name for the API key
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// ExpiresAt Optional expiration time in ISO 8601 format
	ExpiresAt *time.Time `json:"expiresAt,omitempty" yaml:"expiresAt,omitempty"`

	// Id Unique identifier for the API key within the LLM proxy. If not provided, generated from displayName.
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Issuer Identifier of the developer portal that provisioned this API key. Null if not provided.
	Issuer *string `json:"issuer" yaml:"issuer"`
}

type CreateLLMProxyAPIKeyResponse struct {
	// ApiKey The generated API key value (shown only once, 64 hexadecimal characters)
	ApiKey string `binding:"required" json:"apiKey" yaml:"apiKey"`

	// Id Unique identifier of the generated key
	Id string `binding:"required" json:"id" yaml:"id"`

	// Message Detailed message about the operation result
	Message string `binding:"required" json:"message" yaml:"message"`

	// Status Status of the operation
	Status string `binding:"required" json:"status" yaml:"status"`
}

type CreateLLMProxyJSONRequestBody = LLMProxy

type CreateMCPProxyJSONRequestBody = MCPProxy

type CreateProjectJSONRequestBody = CreateProjectRequest

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

	// DisplayName Human-readable name for the project
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Id Handle (URL-friendly slug) for the project. Auto-generated from displayName if not provided.
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`
}

type CreateRESTAPIJSONRequestBody = CreateRESTAPIRequest

type CreateRESTAPIRequest struct {
	// Channels List of channels exposed by this API
	Channels *[]Channel `json:"channels,omitempty" yaml:"channels,omitempty"`
	Context  string     `binding:"required" json:"context" yaml:"context"`

	// CreatedAt Timestamp when the api was created
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy   *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable name for the API
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Id Unique handle/identifier for the API. Can be provided during creation or auto-generated. On update (PUT), if provided must match the path parameter — returns 400 if they differ.
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Kind Kind of the API based on its communication protocol or architectural style
	Kind *string `json:"kind,omitempty" yaml:"kind,omitempty"`

	// LifeCycleStatus Current lifecycle status of the API
	LifeCycleStatus *CreateRESTAPIRequestLifeCycleStatus `json:"lifeCycleStatus,omitempty" yaml:"lifeCycleStatus,omitempty"`

	// Operations List of operations exposed by this API
	Operations *[]Operation `json:"operations,omitempty" yaml:"operations,omitempty"`

	// Policies List of policies to be applied on the API
	Policies *[]Policy `json:"policies,omitempty" yaml:"policies,omitempty"`

	// ProjectId Handle (URL-friendly slug) of the project this API belongs to
	ProjectId string `binding:"required" json:"projectId" yaml:"projectId"`

	// ReadOnly True if the artifact originated from a data-plane gateway (origin gateway_api) and is read-only in the control plane; false for control-plane created artifacts.
	ReadOnly *bool `json:"readOnly,omitempty" yaml:"readOnly,omitempty"`

	// SubscriptionPlans List of subscription plan names enabled for this API (e.g. Gold, Silver).
	// When set, only these plans can be used when subscribing to the API.
	SubscriptionPlans *[]string `json:"subscriptionPlans,omitempty" yaml:"subscriptionPlans,omitempty"`

	// Transport Supported transports for the API (http and/or https)
	Transport *[]string `json:"transport,omitempty" yaml:"transport,omitempty"`

	// UpdatedAt Timestamp when the api was last updated
	UpdatedAt *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// UpdatedBy User identifier of the user who last updated this resource. Only present in the detail response (GET /rest-apis/{apiId}), omitted from list responses.
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`

	// Upstream Upstream backend configuration with main and sandbox endpoints
	Upstream Upstream `json:"upstream" yaml:"upstream"`
	Version  string   `binding:"required" json:"version" yaml:"version"`
}

type CreateRESTAPIRequestLifeCycleStatus string

type CreateSecretMultipartRequestBody = SecretCreateRequest

type CreateSubscriptionJSONRequestBody = CreateSubscriptionRequest

type CreateSubscriptionPlanJSONRequestBody = CreateSubscriptionPlanRequest

type CreateSubscriptionPlanRequest struct {
	// DisplayName Human-readable name for the subscription plan
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// ExpiryTime Optional plan expiry time (RFC3339)
	ExpiryTime *time.Time `json:"expiryTime,omitempty" yaml:"expiryTime,omitempty"`

	// Id Handle (URL-friendly slug) for the plan. Immutable after creation.
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Limits Throttling limits for the plan (e.g. requests per hour, requests per month). The table backing this API already supports multiple limits per plan, but the platform-api currently only persists and enforces the first entry in this array; any additional entries are accepted but ignored.
	Limits *[]SubscriptionPlanLimit             `json:"limits,omitempty" yaml:"limits,omitempty"`
	Status *CreateSubscriptionPlanRequestStatus `json:"status,omitempty" yaml:"status,omitempty"`
}

type CreateSubscriptionPlanRequestStatus string

type CreateSubscriptionRequest struct {
	// ApiId Handle (ID) of the artifact to subscribe to. Resolved against the table for the given kind.
	ApiId string `binding:"required" json:"apiId" yaml:"apiId"`

	// ApplicationId Handle (ID) of the application this subscription belongs to. Optional in token-based subscriptions.
	ApplicationId *string `json:"applicationId,omitempty" yaml:"applicationId,omitempty"`

	// Kind Type of the artifact identified by apiId. Determines which artifact table apiId is resolved against.
	Kind CreateSubscriptionRequestKind `binding:"required" json:"kind" yaml:"kind"`

	// Status Subscription status (default ACTIVE)
	Status *CreateSubscriptionRequestStatus `json:"status,omitempty" yaml:"status,omitempty"`

	// SubscriberId Unique subscriber identifier for the subscription (required)
	SubscriberId string `binding:"required" json:"subscriberId" yaml:"subscriberId"`

	// SubscriptionPlanId Handle (slug) of the subscription plan. Links the subscription to rate limit and billing configuration.
	SubscriptionPlanId *string `json:"subscriptionPlanId,omitempty" yaml:"subscriptionPlanId,omitempty"`
}

type CreateSubscriptionRequestKind string

type CreateSubscriptionRequestStatus string

type CustomPolicyListResponse struct {
	// Count Number of custom policies in current response
	Count int `binding:"required" json:"count" yaml:"count"`

	// List List of custom policies
	List       []CustomPolicyResponse `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination             `json:"pagination" yaml:"pagination"`
}

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

	// Description Human-readable description of the policy
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// Name Policy name
	Name string `binding:"required" json:"name" yaml:"name"`

	// OrganizationUuid Organization this policy belongs to
	OrganizationUuid openapi_types.UUID `binding:"required" json:"organizationUuid" yaml:"organizationUuid"`

	// PolicyDefinition The full policy schema as declared in the policy's policy-definition.yaml.
	// Contains `parameters` and `systemParameters` JSON Schema documents.
	PolicyDefinition map[string]interface{} `binding:"required" json:"policyDefinition" yaml:"policyDefinition"`
	UpdatedAt        *time.Time             `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// Uuid Unique identifier of the custom policy record
	Uuid openapi_types.UUID `binding:"required" json:"uuid" yaml:"uuid"`

	// Version Policy version
	Version string `binding:"required" json:"version" yaml:"version"`
}

type DeleteSubscriptionParams struct {
	// SubscriberId Subscriber ID; must match the subscription's subscriberId.
	SubscriberId string `form:"subscriberId" json:"subscriberId" yaml:"subscriberId"`
}

type DeployAPIJSONRequestBody = DeployRequest

type DeployLLMProviderJSONRequestBody = DeployRequest

type DeployLLMProxyJSONRequestBody = DeployRequest

type DeployMCPProxyJSONRequestBody = DeployRequest

type DeployRequest struct {
	// Base The source for the API definition. Can be "current" (latest working copy) or a deploymentId (existing deployment)
	Base string `binding:"required" json:"base" yaml:"base"`

	// GatewayId Handle (URL-friendly slug) of the target gateway for this deployment
	GatewayId string `binding:"required" json:"gatewayId" yaml:"gatewayId"`

	// Metadata Optional metadata for the deployment. Supported keys include `endpointUrl`, `vhostMain`, and `vhostSandbox`.
	Metadata *map[string]interface{} `json:"metadata,omitempty" yaml:"metadata,omitempty"`

	// Name Name/label for this deployment (e.g., "v1.0-prod", "hotfix-2024-01-15")
	Name string `binding:"required" json:"name" yaml:"name"`
}

type DeploymentId = openapi_types.UUID

type DeploymentListResponse struct {
	// Count Number of deployments in current response
	Count int `binding:"required" json:"count" yaml:"count"`

	// List List of deployments
	List       []DeploymentResponse `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination           `json:"pagination" yaml:"pagination"`
}

type DeploymentResponse struct {
	// BaseDeploymentId UUID of the base deployment this was created from
	BaseDeploymentId *openapi_types.UUID `json:"baseDeploymentId" yaml:"baseDeploymentId"`

	// CreatedAt Timestamp when the deployment artifact was created
	CreatedAt time.Time `binding:"required" json:"createdAt" yaml:"createdAt"`

	// DeploymentId Unique identifier for the deployment
	DeploymentId openapi_types.UUID `binding:"required" json:"deploymentId" yaml:"deploymentId"`

	// GatewayId Handle (URL-friendly slug) of the gateway
	GatewayId string `binding:"required" json:"gatewayId" yaml:"gatewayId"`

	// Metadata Metadata associated with the deployment
	Metadata *map[string]interface{} `json:"metadata,omitempty" yaml:"metadata,omitempty"`

	// Name Name/label for this deployment
	Name string `binding:"required" json:"name" yaml:"name"`

	// Status Current deployment lifecycle state:
	// - DEPLOYED: Currently active on the gateway
	// - UNDEPLOYED: Suspended but can be rolled back
	// - DEPLOYING: Deployment in progress, waiting for gateway acknowledgement
	// - UNDEPLOYING: Undeployment in progress, waiting for gateway acknowledgement
	// - FAILED: Deployment or undeployment failed (see statusReason for error code)
	// - ARCHIVED: Historical deployment, can be rolled back
	Status DeploymentResponseStatus `binding:"required" json:"status" yaml:"status"`

	// StatusReason Error code explaining the failure reason. Null unless status is FAILED (e.g. DEPLOYMENT_TIMEOUT, GATEWAY_PROCESSING_ERROR)
	StatusReason *string `json:"statusReason" yaml:"statusReason"`

	// UpdatedAt Timestamp when the deployment status last changed (null for ARCHIVED deployments)
	UpdatedAt *time.Time `json:"updatedAt" yaml:"updatedAt"`
}

type DeploymentResponseStatus string

type DeploymentStatusQ string

type EntityIDQ = string

type Error struct {
	// Code Stable, machine-readable error code from the error catalog, in the form `<DOMAIN>_<REASON>` (e.g. `REST_API_NOT_FOUND`). Clients and agents should branch on this, not on the HTTP status.
	Code string `binding:"required" json:"code" yaml:"code"`

	// Details Optional structured metadata specific to this error condition (e.g. the resources referencing a secret that blocked its deletion). Shape varies by `code`; absent when not applicable.
	Details *map[string]interface{} `json:"details,omitempty" yaml:"details,omitempty"`

	// Errors Per-field validation failures. Present when the error is a validation failure.
	Errors *[]FieldError `json:"errors,omitempty" yaml:"errors,omitempty"`

	// Message Human-readable description of the error.
	Message string `binding:"required" json:"message" yaml:"message"`

	// Status Always the literal "error".
	Status ErrorStatus `binding:"required" json:"status" yaml:"status"`

	// TrackingId Correlation ID for server-side failures. Present only on 5xx responses; quote it when reporting the error so operators can find the corresponding server log entry.
	TrackingId *openapi_types.UUID `json:"trackingId,omitempty" yaml:"trackingId,omitempty"`
}

type ErrorStatus string

type ExpirationDuration struct {
	// Duration Duration value (must be positive)
	Duration int `binding:"required" json:"duration" yaml:"duration"`

	// Unit Time unit for API key expiration duration
	Unit TimeUnit `json:"unit" yaml:"unit"`
}

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

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

type ExtractionIdentifierLocation string

type FetchMCPProxyServerInfoJSONRequestBody = MCPServerInfoFetchRequest

type FieldError struct {
	// Field Path of the offending field.
	Field string `binding:"required" json:"field" yaml:"field"`

	// Message Why the field failed validation.
	Message string `binding:"required" json:"message" yaml:"message"`
}

type Forbidden = Error

type GatewayConnectionUnavailable = Error

type GatewayId = string

type GatewayIdQ = string

type GatewayListResponse struct {
	// Count Number of items in current response
	Count      int               `binding:"required" json:"count" yaml:"count"`
	List       []GatewayResponse `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination        `json:"pagination" yaml:"pagination"`
}

type GatewayPolicyDefinition struct {
	// Description Human-readable description of the policy
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// IsCustomPolicy Whether this is a user-installed custom policy.
	IsCustomPolicy bool `binding:"required" json:"isCustomPolicy" yaml:"isCustomPolicy"`

	// Name Unique policy name
	Name string `binding:"required" json:"name" yaml:"name"`

	// PolicyDefinition The full policy schema as declared in the policy's policy-definition.yaml.
	// Contains `parameters` and `systemParameters` JSON Schema documents.
	// Only present for custom policies.
	PolicyDefinition *map[string]interface{} `json:"policyDefinition,omitempty" yaml:"policyDefinition,omitempty"`

	// Version Semantic version of the policy
	Version string `binding:"required" json:"version" yaml:"version"`
}

type GatewayResponse struct {
	// CreatedAt Timestamp when gateway was registered
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// Description Description of the gateway
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable gateway name
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Endpoints Network endpoints exposed by this gateway, each as a full URL string
	Endpoints *[]string `json:"endpoints,omitempty" yaml:"endpoints,omitempty"`

	// FunctionalityType Type of gateway functionality
	FunctionalityType *GatewayResponseFunctionalityType `json:"functionalityType,omitempty" yaml:"functionalityType,omitempty"`

	// Id Handle (URL-friendly slug) for the gateway
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// IsActive Indicates if the gateway is currently connected to the platform via WebSocket
	IsActive *bool `json:"isActive,omitempty" yaml:"isActive,omitempty"`

	// IsCritical Whether the gateway is critical for production
	IsCritical *bool `json:"isCritical,omitempty" yaml:"isCritical,omitempty"`

	// OrganizationId Handle (URL-friendly slug) of the organization this gateway belongs to
	OrganizationId *string `json:"organizationId,omitempty" yaml:"organizationId,omitempty"`

	// Properties Custom key-value properties for the gateway
	Properties *map[string]interface{} `json:"properties,omitempty" yaml:"properties,omitempty"`

	// UpdatedAt Timestamp when gateway was last updated
	UpdatedAt *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// UpdatedBy User identifier of the user who last updated this resource. Only present in the detail response (GET /gateways/{gatewayId}), omitted from list responses.
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`

	// Version Gateway version in `major.minor` format (e.g. `1.0`) or CalVer `YYYY.MM.DD` format (e.g. `2026.05.13`)
	Version *string `json:"version,omitempty" yaml:"version,omitempty"`
}

type GatewayResponseFunctionalityType string

type GatewayStatusListResponse struct {
	// Count Number of items in current response
	Count      int                     `binding:"required" json:"count" yaml:"count"`
	List       []GatewayStatusResponse `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination              `json:"pagination" yaml:"pagination"`
}

type GatewayStatusResponse struct {
	// Id Handle (URL-friendly slug) for the gateway
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// IsActive Indicates if the gateway is currently connected to the platform via WebSocket
	IsActive *bool `json:"isActive,omitempty" yaml:"isActive,omitempty"`

	// IsCritical Whether the gateway is critical for production
	IsCritical *bool `json:"isCritical,omitempty" yaml:"isCritical,omitempty"`
}

type GatewayTokenListResponse struct {
	// Count Number of tokens in current response
	Count int `binding:"required" json:"count" yaml:"count"`

	// List List of active tokens
	List       []TokenInfoResponse `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination          `json:"pagination" yaml:"pagination"`
}

type GetDeploymentsParams struct {
	// GatewayId **Gateway ID** consisting of the **UUID** of the Gateway to filter status by.
	GatewayId *GatewayIdQ `form:"gatewayId,omitempty" json:"gatewayId,omitempty" yaml:"gatewayId,omitempty"`

	// Status Filter deployments by status (DEPLOYED, UNDEPLOYED, DEPLOYING, UNDEPLOYING, FAILED, or ARCHIVED)
	Status *GetDeploymentsParamsStatus `form:"status,omitempty" json:"status,omitempty" yaml:"status,omitempty"`

	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type GetDeploymentsParamsStatus string

type GetLLMProviderDeploymentsParams struct {
	// GatewayId **Gateway ID** consisting of the **UUID** of the Gateway to filter status by.
	GatewayId *GatewayIdQ `form:"gatewayId,omitempty" json:"gatewayId,omitempty" yaml:"gatewayId,omitempty"`

	// Status Filter deployments by status (DEPLOYED, UNDEPLOYED, DEPLOYING, UNDEPLOYING, FAILED, or ARCHIVED)
	Status *GetLLMProviderDeploymentsParamsStatus `form:"status,omitempty" json:"status,omitempty" yaml:"status,omitempty"`

	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type GetLLMProviderDeploymentsParamsStatus string

type GetLLMProxyDeploymentsParams struct {
	// GatewayId **Gateway ID** consisting of the **UUID** of the Gateway to filter status by.
	GatewayId *GatewayIdQ `form:"gatewayId,omitempty" json:"gatewayId,omitempty" yaml:"gatewayId,omitempty"`

	// Status Filter deployments by status (DEPLOYED, UNDEPLOYED, DEPLOYING, UNDEPLOYING, FAILED, or ARCHIVED)
	Status *GetLLMProxyDeploymentsParamsStatus `form:"status,omitempty" json:"status,omitempty" yaml:"status,omitempty"`

	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type GetLLMProxyDeploymentsParamsStatus string

type GetMCPProxyDeploymentsParams struct {
	// GatewayId **Gateway ID** consisting of the **UUID** of the Gateway to filter status by.
	GatewayId *GatewayIdQ `form:"gatewayId,omitempty" json:"gatewayId,omitempty" yaml:"gatewayId,omitempty"`

	// Status Filter deployments by status (DEPLOYED, UNDEPLOYED, DEPLOYING, UNDEPLOYING, FAILED, or ARCHIVED)
	Status *GetMCPProxyDeploymentsParamsStatus `form:"status,omitempty" json:"status,omitempty" yaml:"status,omitempty"`

	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type GetMCPProxyDeploymentsParamsStatus string

type GetRESTAPIGatewaysParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type InternalServerError = Error

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 `binding:"required" json:"mode" yaml:"mode"`
}

type LLMAccessControlMode string

type LLMModel struct {
	// Description Model description
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable model name
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Id Unique model identifier
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`
}

type LLMModelProvider struct {
	// DisplayName Human-readable model provider name
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Id Unique model provider identifier
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Models Models under this model provider
	Models *[]LLMModel `json:"models,omitempty" yaml:"models,omitempty"`
}

type LLMPolicy struct {
	Name  string          `binding:"required" json:"name" yaml:"name"`
	Paths []LLMPolicyPath `binding:"required" json:"paths" yaml:"paths"`

	// 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.
	Version string `binding:"required" json:"version" yaml:"version"`
}

type LLMPolicyPath struct {
	Methods []LLMPolicyPathMethods `binding:"required" 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{} `binding:"required" json:"params" yaml:"params"`
	Path   string                 `binding:"required" json:"path" yaml:"path"`
}

type LLMPolicyPathMethods string

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

	// AssociatedGateways Optional list of gateways this LLM provider can be deployed to, along with per-gateway configuration overrides. This field is optional; omitting it does not change existing behaviour.
	AssociatedGateways *[]AssociatedGateway `json:"associatedGateways,omitempty" yaml:"associatedGateways,omitempty"`

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

	// CreatedAt Timestamp when the resource was created
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// Description Description of the LLM provider
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

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

	// GlobalPolicies Global (api-level) policies applied across ALL operations as one shared scope, evaluated before operation-level policies.
	GlobalPolicies *[]Policy `json:"globalPolicies,omitempty" yaml:"globalPolicies,omitempty"`

	// Id Unique handle for the provider
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// ModelProviders List of model providers and their models supported by this provider. For non-aggregator templates, only a single model provider is allowed (aggregator templates: awsbedrock, azureaifoundry).
	ModelProviders *[]LLMModelProvider `json:"modelProviders,omitempty" yaml:"modelProviders,omitempty"`

	// Openapi OpenAPI specification (JSON or YAML) for the provider endpoint
	Openapi *string `json:"openapi,omitempty" yaml:"openapi,omitempty"`

	// OperationPolicies Operation-level policies scoped to specific paths/methods, evaluated after global policies.
	OperationPolicies *[]OperationPolicy `json:"operationPolicies,omitempty" yaml:"operationPolicies,omitempty"`

	// Policies DEPRECATED - use operationPolicies. Still honoured (treated identically to operationPolicies).
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	Policies *[]LLMPolicy `json:"policies,omitempty" yaml:"policies,omitempty"`

	// RateLimiting Rate limiting configuration for an LLM provider at provider and consumer levels.
	RateLimiting *LLMRateLimitingConfig `json:"rateLimiting,omitempty" yaml:"rateLimiting,omitempty"`

	// ReadOnly True if the artifact originated from a data-plane gateway (origin gateway_api) and is read-only in the control plane; false for control-plane created artifacts.
	ReadOnly *bool `json:"readOnly,omitempty" yaml:"readOnly,omitempty"`

	// Security Defines security mechanisms (API key, OAuth2) applicable to the API
	Security *SecurityConfig `json:"security,omitempty" yaml:"security,omitempty"`

	// Template Template name to use for this LLM Provider
	Template string `binding:"required" json:"template" yaml:"template"`

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

	// UpdatedBy User identifier of the user who last updated this resource. Only present in the detail response (GET /llm-providers/{id}), omitted from list responses.
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`

	// Upstream Upstream backend configuration with main and sandbox endpoints
	Upstream Upstream `json:"upstream" yaml:"upstream"`

	// Version Semantic version of the LLM Provider
	Version string `binding:"required" 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 LLMProviderAPIKeyListResponse struct {
	// Count Number of API keys in current response
	Count int `binding:"required" json:"count" yaml:"count"`

	// List List of API keys
	List       []APIKeyItem `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination   `json:"pagination" yaml:"pagination"`
}

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

	// CreatedBy User identifier of the user who created this resource
	CreatedBy   *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable name for the LLM provider
	DisplayName string  `binding:"required" json:"displayName" yaml:"displayName"`
	Id          *string `json:"id,omitempty" yaml:"id,omitempty"`

	// ReadOnly True when the artifact originated from a data-plane gateway (origin gateway_api) and is read-only in the control plane.
	ReadOnly  *bool                      `json:"readOnly,omitempty" yaml:"readOnly,omitempty"`
	Status    *LLMProviderListItemStatus `json:"status,omitempty" yaml:"status,omitempty"`
	Template  *string                    `json:"template,omitempty" yaml:"template,omitempty"`
	UpdatedAt *time.Time                 `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`
	Version   *string                    `json:"version,omitempty" yaml:"version,omitempty"`
}

type LLMProviderListItemStatus string

type LLMProviderListResponse struct {
	Count      int                   `binding:"required" json:"count" yaml:"count"`
	List       []LLMProviderListItem `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination            `json:"pagination" yaml:"pagination"`
}

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

	// CreatedAt Timestamp when the resource was created
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// Description Description of the LLM provider template
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable LLM Template name
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Enabled Whether this version is offered when creating providers. If false, the
	// template version is hidden from the provider creation UI and API.
	Enabled *bool `json:"enabled,omitempty" yaml:"enabled,omitempty"`

	// GroupId Stable identifier shared by every version of a template family.
	GroupId *string `json:"groupId,omitempty" yaml:"groupId,omitempty"`

	// Id Unique handle for the template
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// IsLatest Whether this is the latest version of the template.
	IsLatest *bool `json:"isLatest,omitempty" yaml:"isLatest,omitempty"`

	// ManagedBy Identifies who manages the template. Built-in templates use 'wso2';
	// custom templates default to 'organization' and may be set to any value.
	ManagedBy *string                      `json:"managedBy,omitempty" yaml:"managedBy,omitempty"`
	Metadata  *LLMProviderTemplateMetadata `json:"metadata,omitempty" yaml:"metadata,omitempty"`

	// Openapi OpenAPI specification content (JSON or YAML) for the provider, when
	// uploaded/pasted. Use metadata.openapiSpecUrl instead to reference the
	// spec by URL.
	Openapi      *string               `json:"openapi,omitempty" yaml:"openapi,omitempty"`
	PromptTokens *ExtractionIdentifier `json:"promptTokens,omitempty" yaml:"promptTokens,omitempty"`

	// ReadOnly True if the artifact originated from a data-plane gateway (origin gateway_api) and is read-only in the control plane; false for control-plane created artifacts.
	ReadOnly         *bool                                `json:"readOnly,omitempty" yaml:"readOnly,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"`

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

	// UpdatedBy User identifier of the user who last updated this resource
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`

	// Version Content version, matching the v<major>.<minor> pattern (e.g. v1.0, v2.0).
	// Must be unique for this template.
	Version string `binding:"required" json:"version" yaml:"version"`
}

type LLMProviderTemplateAuth struct {
	// Header Header name to send the auth value
	Header *string `json:"header,omitempty" yaml:"header,omitempty"`

	// Type Authentication type used by the LLM provider template
	Type *string `json:"type,omitempty" yaml:"type,omitempty"`

	// ValuePrefix Prefix to attach before the auth value
	ValuePrefix *string `json:"valuePrefix,omitempty" yaml:"valuePrefix,omitempty"`
}

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

	// CreatedBy User identifier of the user who created this resource
	CreatedBy   *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable name for the LLM provider template
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Enabled Whether this version is offered when creating providers.
	Enabled *bool `json:"enabled,omitempty" yaml:"enabled,omitempty"`

	// GroupId Stable identifier shared by every version of a template family
	// (defaults to the first version's handle). Read-only.
	GroupId *string `json:"groupId,omitempty" yaml:"groupId,omitempty"`

	// Id Unique handle for this specific template version.
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// IsLatest Whether this is the latest version of the template.
	IsLatest *bool `json:"isLatest,omitempty" yaml:"isLatest,omitempty"`

	// LogoUrl URL of the provider logo
	LogoUrl *string `json:"logoUrl,omitempty" yaml:"logoUrl,omitempty"`

	// ManagedBy Who manages the template ('wso2' for built-in, otherwise custom-defined).
	ManagedBy *string `json:"managedBy,omitempty" yaml:"managedBy,omitempty"`

	// ReadOnly True when the artifact originated from a data-plane gateway (origin gateway_api) and is read-only in the control plane.
	ReadOnly  *bool      `json:"readOnly,omitempty" yaml:"readOnly,omitempty"`
	UpdatedAt *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// Version Content version, matching the v<major>.<minor> pattern (e.g. v1.0, v2.0).
	Version *string `json:"version,omitempty" yaml:"version,omitempty"`
}

type LLMProviderTemplateListResponse struct {
	Count      int                           `binding:"required" json:"count" yaml:"count"`
	List       []LLMProviderTemplateListItem `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination                    `json:"pagination" yaml:"pagination"`
}

type LLMProviderTemplateMetadata struct {
	Auth *LLMProviderTemplateAuth `json:"auth,omitempty" yaml:"auth,omitempty"`

	// EndpointUrl Default endpoint URL for the template
	EndpointUrl *string `json:"endpointUrl,omitempty" yaml:"endpointUrl,omitempty"`

	// LogoUrl URL of the provider logo
	LogoUrl *string `json:"logoUrl,omitempty" yaml:"logoUrl,omitempty"`

	// OpenapiSpecUrl URL to the OpenAPI specification for the provider
	OpenapiSpecUrl *string `json:"openapiSpecUrl,omitempty" yaml:"openapiSpecUrl,omitempty"`
}

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 this mapping applies to (for example /responses or /chat/*)
	Resource      string                `binding:"required" 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 LLMProxy struct {
	// AssociatedGateways Optional list of gateways this LLM proxy can be deployed to, along with per-gateway configuration overrides. This field is optional; omitting it does not change existing behaviour.
	AssociatedGateways *[]AssociatedGateway `json:"associatedGateways,omitempty" yaml:"associatedGateways,omitempty"`

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

	// CreatedAt Timestamp when the resource was created
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// Description Description of the LLM proxy
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable LLM proxy name
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// GlobalPolicies Global (api-level) policies applied across ALL operations as one shared scope, evaluated before operation-level policies.
	GlobalPolicies *[]Policy `json:"globalPolicies,omitempty" yaml:"globalPolicies,omitempty"`

	// Id Unique handle for the proxy
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Openapi OpenAPI specification (JSON or YAML) for the proxy endpoint
	Openapi *string `json:"openapi,omitempty" yaml:"openapi,omitempty"`

	// OperationPolicies Operation-level policies scoped to specific paths/methods, evaluated after global policies.
	OperationPolicies *[]OperationPolicy `json:"operationPolicies,omitempty" yaml:"operationPolicies,omitempty"`

	// Policies DEPRECATED - use operationPolicies. Still honoured (treated identically to operationPolicies).
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	Policies *[]LLMPolicy `json:"policies,omitempty" yaml:"policies,omitempty"`

	// ProjectId UUID of the project this proxy belongs to
	ProjectId string           `binding:"required" json:"projectId" yaml:"projectId"`
	Provider  LLMProxyProvider `json:"provider" yaml:"provider"`

	// ReadOnly True if the artifact originated from a data-plane gateway (origin gateway_api) and is read-only in the control plane; false for control-plane created artifacts.
	ReadOnly *bool `json:"readOnly,omitempty" yaml:"readOnly,omitempty"`

	// Security Defines security mechanisms (API key, OAuth2) applicable to the API
	Security *SecurityConfig `json:"security,omitempty" yaml:"security,omitempty"`

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

	// UpdatedBy User identifier of the user who last updated this resource. Only present in the detail response (GET /llm-proxies/{id}), omitted from list responses.
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`

	// Version Semantic version of the LLM proxy
	Version string `binding:"required" 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 LLMProxyAPIKeyListResponse struct {
	// Count Number of API keys in current response
	Count int `binding:"required" json:"count" yaml:"count"`

	// List List of API keys
	List       []APIKeyItem `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination   `json:"pagination" yaml:"pagination"`
}

type LLMProxyListItem struct {
	// Context Context path where the proxy is exposed
	Context   *string    `json:"context,omitempty" yaml:"context,omitempty"`
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy   *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable name for the LLM proxy
	DisplayName string  `binding:"required" json:"displayName" yaml:"displayName"`
	Id          *string `json:"id,omitempty" yaml:"id,omitempty"`

	// ProjectId UUID of the project this proxy belongs to
	ProjectId *string `json:"projectId,omitempty" yaml:"projectId,omitempty"`

	// Provider Unique id of a deployed llm provider
	Provider *string `json:"provider,omitempty" yaml:"provider,omitempty"`

	// ReadOnly True when the artifact originated from a data-plane gateway (origin gateway_api) and is read-only in the control plane.
	ReadOnly  *bool                   `json:"readOnly,omitempty" yaml:"readOnly,omitempty"`
	Status    *LLMProxyListItemStatus `json:"status,omitempty" yaml:"status,omitempty"`
	UpdatedAt *time.Time              `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`
	Version   *string                 `json:"version,omitempty" yaml:"version,omitempty"`
}

type LLMProxyListItemStatus string

type LLMProxyListResponse struct {
	Count      int                `binding:"required" json:"count" yaml:"count"`
	List       []LLMProxyListItem `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination         `json:"pagination" yaml:"pagination"`
}

type LLMProxyProvider struct {
	// Auth Authentication configuration for upstream endpoints
	Auth *UpstreamAuth `json:"auth,omitempty" yaml:"auth,omitempty"`

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

type LLMRateLimitingConfig struct {
	// ConsumerLevel Rate limiting configuration for a scope (provider or consumer). Either global or resource-wise limits can be defined.
	ConsumerLevel *RateLimitingScopeConfig `json:"consumerLevel,omitempty" yaml:"consumerLevel,omitempty"`

	// ProviderLevel Rate limiting configuration for a scope (provider or consumer). Either global or resource-wise limits can be defined.
	ProviderLevel *RateLimitingScopeConfig `json:"providerLevel,omitempty" yaml:"providerLevel,omitempty"`
}

type LimitQ = int

type ListApplicationAPIKeysParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListApplicationAssociationAPIKeysParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListApplicationAssociationsParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListApplicationsParams struct {
	// ProjectId **Project ID** consisting of the **handle** (unique slug identifier) of the Project to filter APIs by.
	ProjectId ProjectIdQ `form:"projectId" json:"projectId" yaml:"projectId"`

	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`

	// SortBy Field to sort the collection by. An unrecognized value falls back to the default sort (createdAt).
	SortBy *ListApplicationsParamsSortBy `form:"sortBy,omitempty" json:"sortBy,omitempty" yaml:"sortBy,omitempty"`

	// SortOrder Sort direction applied to `sortBy`.
	SortOrder *ListApplicationsParamsSortOrder `form:"sortOrder,omitempty" json:"sortOrder,omitempty" yaml:"sortOrder,omitempty"`

	// Query Case-insensitive substring filter matched against the resource id (handle).
	Query *QueryQ `form:"query,omitempty" json:"query,omitempty" yaml:"query,omitempty"`
}

type ListApplicationsParamsSortBy string

type ListApplicationsParamsSortOrder string

type ListGatewayCustomPoliciesParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListGatewayTokensParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListGatewaysParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`

	// SortBy Field to sort the collection by. An unrecognized value falls back to the default sort (createdAt).
	SortBy *ListGatewaysParamsSortBy `form:"sortBy,omitempty" json:"sortBy,omitempty" yaml:"sortBy,omitempty"`

	// SortOrder Sort direction applied to `sortBy`.
	SortOrder *ListGatewaysParamsSortOrder `form:"sortOrder,omitempty" json:"sortOrder,omitempty" yaml:"sortOrder,omitempty"`

	// Query Case-insensitive substring filter matched against the resource id (handle).
	Query *QueryQ `form:"query,omitempty" json:"query,omitempty" yaml:"query,omitempty"`
}

type ListGatewaysParamsSortBy string

type ListGatewaysParamsSortOrder string

type ListLLMProviderAPIKeysParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListLLMProviderTemplatesParams struct {
	// Query URL-encoded search DSL. `query=latest:true` lists only the latest version of each family; `query=groupId:<id>` lists that family's versions; adding `&version:<ver>` returns the single full template for that version. Terms are `&`-separated `key:value` pairs and the whole value is percent-encoded (e.g. groupId%3Aopenai%26version%3Av2.0).
	Query *string `form:"query,omitempty" json:"query,omitempty" yaml:"query,omitempty"`

	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListLLMProvidersParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListLLMProxiesByProviderParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListLLMProxiesParams struct {
	// ProjectId **Project ID** consisting of the **handle** (unique slug identifier) of the Project to filter APIs by.
	ProjectId ProjectIdQ `form:"projectId" json:"projectId" yaml:"projectId"`

	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListLLMProxyAPIKeysParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListMCPProxiesParams struct {
	// ProjectId **Project ID** consisting of the **handle** (unique slug identifier) of the Project to filter APIs by.
	ProjectId ProjectIdQ `form:"projectId" json:"projectId" yaml:"projectId"`

	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListOrganizationsParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListProjectsParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`

	// SortBy Field to sort the collection by. An unrecognized value falls back to the default sort (createdAt).
	SortBy *ListProjectsParamsSortBy `form:"sortBy,omitempty" json:"sortBy,omitempty" yaml:"sortBy,omitempty"`

	// SortOrder Sort direction applied to `sortBy`.
	SortOrder *ListProjectsParamsSortOrder `form:"sortOrder,omitempty" json:"sortOrder,omitempty" yaml:"sortOrder,omitempty"`

	// Query Case-insensitive substring filter matched against the resource id (handle).
	Query *QueryQ `form:"query,omitempty" json:"query,omitempty" yaml:"query,omitempty"`
}

type ListProjectsParamsSortBy string

type ListProjectsParamsSortOrder string

type ListRESTAPIsParams struct {
	// ProjectId **Project ID** consisting of the **handle** (unique slug identifier) of the Project to filter APIs by.
	ProjectId ProjectIdQ `form:"projectId" json:"projectId" yaml:"projectId"`

	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`

	// SortBy Field to sort the collection by. An unrecognized value falls back to the default sort (createdAt).
	SortBy *ListRESTAPIsParamsSortBy `form:"sortBy,omitempty" json:"sortBy,omitempty" yaml:"sortBy,omitempty"`

	// SortOrder Sort direction applied to `sortBy`.
	SortOrder *ListRESTAPIsParamsSortOrder `form:"sortOrder,omitempty" json:"sortOrder,omitempty" yaml:"sortOrder,omitempty"`

	// Query Case-insensitive substring filter matched against the resource id (handle).
	Query *QueryQ `form:"query,omitempty" json:"query,omitempty" yaml:"query,omitempty"`
}

type ListRESTAPIsParamsSortBy string

type ListRESTAPIsParamsSortOrder string

type ListSecretsParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`

	// UpdatedAfter RFC3339 timestamp — return only secrets updated after this time. Used by GW controller for incremental polling.
	UpdatedAfter *time.Time `form:"updatedAfter,omitempty" json:"updatedAfter,omitempty" yaml:"updatedAfter,omitempty"`
}

type ListSubscriptionPlansParams struct {
	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListSubscriptionsParams struct {
	// ApiId Filter by API ID (UUID or handle)
	ApiId *string `form:"apiId,omitempty" json:"apiId,omitempty" yaml:"apiId,omitempty"`

	// SubscriberId Filter by subscriber ID
	SubscriberId *string `form:"subscriberId,omitempty" json:"subscriberId,omitempty" yaml:"subscriberId,omitempty"`

	// ApplicationId Filter by application ID
	ApplicationId *string `form:"applicationId,omitempty" json:"applicationId,omitempty" yaml:"applicationId,omitempty"`

	// Status Filter by status (ACTIVE, INACTIVE, REVOKED)
	Status *ListSubscriptionsParamsStatus `form:"status,omitempty" json:"status,omitempty" yaml:"status,omitempty"`

	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListSubscriptionsParamsStatus string

type ListUserAPIKeysParams struct {
	// Type Comma-separated list of artifact types to filter by.
	// If omitted, all types are returned.
	Type *[]ListUserAPIKeysParamsType `form:"type,omitempty" json:"type,omitempty" yaml:"type,omitempty"`

	// Limit Maximum number of items to return per page.
	Limit *LimitQ `form:"limit,omitempty" json:"limit,omitempty" yaml:"limit,omitempty"`

	// Offset Zero-based index of the first item to return.
	Offset *OffsetQ `form:"offset,omitempty" json:"offset,omitempty" yaml:"offset,omitempty"`
}

type ListUserAPIKeysParamsType string

type MCPProxy struct {
	// AssociatedGateways Optional list of gateways this MCP proxy can be deployed to, along with per-gateway configuration overrides. This field is optional; omitting it does not change existing behaviour.
	AssociatedGateways *[]AssociatedGateway  `json:"associatedGateways,omitempty" yaml:"associatedGateways,omitempty"`
	Capabilities       *MCPProxyCapabilities `json:"capabilities,omitempty" yaml:"capabilities,omitempty"`

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

	// CreatedAt Timestamp when the resource was created
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// Description Description of the MCP proxy
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable MCP proxy name
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Id Unique handle for the proxy
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Kind Kind of the API based on its communication protocol or architectural style
	Kind *string `json:"kind,omitempty" yaml:"kind,omitempty"`

	// McpSpecVersion MCP specification version supported by this proxy
	McpSpecVersion *MCPProxyMcpSpecVersion `json:"mcpSpecVersion,omitempty" yaml:"mcpSpecVersion,omitempty"`

	// Policies List of policies to be applied
	Policies *[]Policy `json:"policies,omitempty" yaml:"policies,omitempty"`

	// ProjectId UUID of the project this proxy belongs to
	ProjectId *string `json:"projectId,omitempty" yaml:"projectId,omitempty"`

	// ReadOnly True if the artifact originated from a data-plane gateway (origin gateway_api) and is read-only in the control plane; false for control-plane created artifacts.
	ReadOnly *bool `json:"readOnly,omitempty" yaml:"readOnly,omitempty"`

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

	// UpdatedBy User identifier of the user who last updated this resource. Only present in the detail response (GET /mcp-proxies/{id}), omitted from list responses.
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`

	// Upstream Upstream backend configuration with main and sandbox endpoints
	Upstream Upstream `json:"upstream" yaml:"upstream"`

	// Version Semantic version of the MCP proxy
	Version string `binding:"required" 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 MCPProxyCapabilities struct {
	// Prompts List of prompt capabilities supported by this proxy
	Prompts *[]map[string]interface{} `json:"prompts,omitempty" yaml:"prompts,omitempty"`

	// Resources List of resource capabilities supported by this proxy
	Resources *[]map[string]interface{} `json:"resources,omitempty" yaml:"resources,omitempty"`

	// Tools List of tool capabilities supported by this proxy
	Tools *[]map[string]interface{} `json:"tools,omitempty" yaml:"tools,omitempty"`
}

type MCPProxyListItem struct {
	// Context Context path where the proxy is exposed
	Context   *string    `json:"context,omitempty" yaml:"context,omitempty"`
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy   *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable name for the MCP proxy
	DisplayName    string  `binding:"required" json:"displayName" yaml:"displayName"`
	Id             *string `json:"id,omitempty" yaml:"id,omitempty"`
	McpSpecVersion *string `json:"mcpSpecVersion,omitempty" yaml:"mcpSpecVersion,omitempty"`

	// ProjectId UUID of the project this proxy belongs to
	ProjectId *string `json:"projectId,omitempty" yaml:"projectId,omitempty"`

	// ReadOnly True when the artifact originated from a data-plane gateway (origin gateway_api) and is read-only in the control plane.
	ReadOnly  *bool                   `json:"readOnly,omitempty" yaml:"readOnly,omitempty"`
	Status    *MCPProxyListItemStatus `json:"status,omitempty" yaml:"status,omitempty"`
	UpdatedAt *time.Time              `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`
	Version   *string                 `json:"version,omitempty" yaml:"version,omitempty"`
}

type MCPProxyListItemStatus string

type MCPProxyListResponse struct {
	Count      int                `binding:"required" json:"count" yaml:"count"`
	List       []MCPProxyListItem `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination         `json:"pagination" yaml:"pagination"`
}

type MCPProxyMcpSpecVersion string

type MCPServerInfoFetchRequest struct {
	// Auth Authentication configuration for upstream endpoints
	Auth *UpstreamAuth `json:"auth,omitempty" yaml:"auth,omitempty"`

	// ProxyId MCP proxy handle (identifier) for refresh operations. When provided,
	// the server fetches URL and auth from the stored proxy configuration.
	// Auth override is not allowed in refetch mode.
	ProxyId *string `json:"proxyId,omitempty" yaml:"proxyId,omitempty"`

	// Url Endpoint URL of the MCP server to fetch information from.
	// Required when proxyId is not provided. When proxyId is provided,
	// the URL from the stored proxy configuration is used.
	Url *string `json:"url,omitempty" yaml:"url,omitempty"`
}

type MCPServerInfoFetchResponse struct {
	Prompts    *[]map[string]interface{} `json:"prompts,omitempty" yaml:"prompts,omitempty"`
	Resources  *[]map[string]interface{} `json:"resources,omitempty" yaml:"resources,omitempty"`
	ServerInfo *map[string]interface{}   `json:"serverInfo,omitempty" yaml:"serverInfo,omitempty"`
	Tools      *[]map[string]interface{} `json:"tools,omitempty" yaml:"tools,omitempty"`
}

type ManifestSyncResponse struct {
	// Policies All policies installed on the gateway. Each entry includes name, version, and isCustomPolicy.
	// Custom policies additionally include policyDefinition with their parameters and systemParameters schemas.
	Policies *[]GatewayPolicyDefinition `json:"policies,omitempty" yaml:"policies,omitempty"`
}

type MappedAPIKey struct {
	AssociatedEntity AssociatedEntity `json:"associatedEntity" yaml:"associatedEntity"`

	// CreatedAt Timestamp when the API key was created
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// ExpiresAt Expiration timestamp of the API key
	ExpiresAt *time.Time `json:"expiresAt,omitempty" yaml:"expiresAt,omitempty"`

	// KeyId Name of the API key
	KeyId string `binding:"required" json:"keyId" yaml:"keyId"`

	// Status Status of the API key
	Status *string `json:"status,omitempty" yaml:"status,omitempty"`

	// UpdatedAt Timestamp when the API key was updated
	UpdatedAt *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// UserId User identifier of the user who created this resource
	UserId *string `json:"userId,omitempty" yaml:"userId,omitempty"`
}

type MappedAPIKeyListResponse struct {
	// Count Number of items in current response
	Count      int            `binding:"required" json:"count" yaml:"count"`
	List       []MappedAPIKey `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination     `json:"pagination" yaml:"pagination"`
}

type MappedKeyId = string

type NotFound = Error

type OffsetQ = int

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

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

	// Request Request details for an API operation
	Request OperationRequest `json:"request" yaml:"request"`
}

type OperationPolicy struct {
	// ExecutionCondition Optional per-request CEL expression controlling whether the policy runs
	ExecutionCondition *string               `json:"executionCondition,omitempty" yaml:"executionCondition,omitempty"`
	Name               string                `binding:"required" json:"name" yaml:"name"`
	Paths              []OperationPolicyPath `binding:"required" json:"paths" yaml:"paths"`

	// 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.
	Version string `binding:"required" json:"version" yaml:"version"`
}

type OperationPolicyPath struct {
	Methods []OperationPolicyPathMethods `binding:"required" json:"methods" yaml:"methods"`

	// Params Policy parameters
	Params map[string]interface{} `binding:"required" json:"params" yaml:"params"`
	Path   string                 `binding:"required" json:"path" yaml:"path"`
}

type OperationPolicyPathMethods string

type OperationRequest struct {
	// Method HTTP method for the operation
	Method OperationRequestMethod `binding:"required" json:"method" yaml:"method"`

	// Path Resource path for the operation
	Path string `binding:"required" json:"path" yaml:"path"`

	// Policies List of policies to be applied on the operation
	Policies *[]Policy `json:"policies,omitempty" yaml:"policies,omitempty"`
}

type OperationRequestMethod string

type Organization struct {
	// CreatedAt Timestamp when the organization was created
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// DisplayName Human-readable name for the organization
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Id Handle (URL-friendly slug) for the organization
	Id *string `binding:"required" json:"id,omitempty" yaml:"id,omitempty"`

	// Region Geographic region where the organization operates
	Region string `binding:"required" json:"region" yaml:"region"`

	// UpdatedAt Timestamp when the organization was last updated
	UpdatedAt *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// UpdatedBy User identifier of the user who last updated this resource
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`
}

type OrganizationListResponse struct {
	// Count Number of items in current response
	Count      int            `binding:"required" json:"count" yaml:"count"`
	List       []Organization `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination     `json:"pagination" yaml:"pagination"`
}

type Pagination struct {
	// Limit Maximum number of items returned per page
	Limit int `binding:"required" json:"limit" yaml:"limit"`

	// Offset Zero-based index of first item in current response
	Offset int `binding:"required" json:"offset" yaml:"offset"`

	// Total Total number of items available across all pages
	Total int `binding:"required" json:"total" yaml:"total"`
}

type Policy struct {
	// ExecutionCondition Conditional expression that determines when this policy executes
	ExecutionCondition *string `json:"executionCondition,omitempty" yaml:"executionCondition,omitempty"`

	// Name Name of the policy to apply
	Name string `binding:"required" json:"name" yaml:"name"`

	// Params Key-value pairs of parameters for the policy
	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.
	Version string `binding:"required" json:"version" yaml:"version"`
}

type Project struct {
	// CreatedAt Timestamp when the project was created
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// Description Description of the project
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable name for the project
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Id Handle (URL-friendly slug) for the project
	Id *string `binding:"required" json:"id,omitempty" yaml:"id,omitempty"`

	// OrganizationId Handle (URL-friendly slug) of the organization this project belongs to
	OrganizationId *string `binding:"required" json:"organizationId,omitempty" yaml:"organizationId,omitempty"`

	// UpdatedAt Timestamp when the project was last updated
	UpdatedAt *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// UpdatedBy User identifier of the user who last updated this resource. Only present in the detail response (GET /projects/{projectId}), omitted from list responses.
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`
}

type ProjectId = string

type ProjectIdQ = string

type ProjectListResponse struct {
	// Count Number of items in current response
	Count      int        `binding:"required" json:"count" yaml:"count"`
	List       []Project  `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination `json:"pagination" yaml:"pagination"`
}

type QueryQ = string

type RESTAPI struct {
	// Channels List of channels exposed by this API
	Channels *[]Channel `json:"channels,omitempty" yaml:"channels,omitempty"`
	Context  string     `binding:"required" json:"context" yaml:"context"`

	// CreatedAt Timestamp when the api was created
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy   *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable name for the API
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Id Unique handle/identifier for the API. Can be provided during creation or auto-generated. On update (PUT), if provided must match the path parameter — returns 400 if they differ.
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Kind Kind of the API based on its communication protocol or architectural style
	Kind *string `json:"kind,omitempty" yaml:"kind,omitempty"`

	// LifeCycleStatus Current lifecycle status of the API
	LifeCycleStatus *RESTAPILifeCycleStatus `json:"lifeCycleStatus,omitempty" yaml:"lifeCycleStatus,omitempty"`

	// Operations List of operations exposed by this API
	Operations *[]Operation `json:"operations,omitempty" yaml:"operations,omitempty"`

	// Policies List of policies to be applied on the API
	Policies *[]Policy `json:"policies,omitempty" yaml:"policies,omitempty"`

	// ProjectId Handle (URL-friendly slug) of the project this API belongs to
	ProjectId string `binding:"required" json:"projectId" yaml:"projectId"`

	// ReadOnly True if the artifact originated from a data-plane gateway (origin gateway_api) and is read-only in the control plane; false for control-plane created artifacts.
	ReadOnly *bool `json:"readOnly,omitempty" yaml:"readOnly,omitempty"`

	// SubscriptionPlans List of subscription plan names enabled for this API (e.g. Gold, Silver).
	// When set, only these plans can be used when subscribing to the API.
	SubscriptionPlans *[]string `json:"subscriptionPlans,omitempty" yaml:"subscriptionPlans,omitempty"`

	// Transport Supported transports for the API (http and/or https)
	Transport *[]string `json:"transport,omitempty" yaml:"transport,omitempty"`

	// UpdatedAt Timestamp when the api was last updated
	UpdatedAt *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// UpdatedBy User identifier of the user who last updated this resource. Only present in the detail response (GET /rest-apis/{apiId}), omitted from list responses.
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`

	// Upstream Upstream backend configuration with main and sandbox endpoints
	Upstream Upstream `json:"upstream" yaml:"upstream"`
	Version  string   `binding:"required" json:"version" yaml:"version"`
}

type RESTAPIDeploymentDetails struct {
	// DeployedAt Timestamp when the API was deployed
	DeployedAt time.Time `binding:"required" json:"deployedAt" yaml:"deployedAt"`

	// Status Current deployment status
	Status RESTAPIDeploymentDetailsStatus `binding:"required" json:"status" yaml:"status"`
}

type RESTAPIDeploymentDetailsStatus string

type RESTAPIGatewayListResponse struct {
	// Count Number of gateways in current response
	Count int `binding:"required" json:"count" yaml:"count"`

	// List List of gateways associated with the API, including deployment details when deployed
	List       []RESTAPIGatewayResponse `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination               `json:"pagination" yaml:"pagination"`
}

type RESTAPIGatewayResponse struct {
	// AssociatedAt Timestamp when the gateway was associated with the API
	AssociatedAt time.Time `json:"associatedAt" yaml:"associatedAt"`

	// CreatedAt Timestamp when gateway was registered
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// Deployment Details about API deployment to a specific gateway
	Deployment *RESTAPIDeploymentDetails `json:"deployment,omitempty" yaml:"deployment,omitempty"`

	// Description Description of the gateway
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable gateway name
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Endpoints Network endpoints exposed by this gateway, each as a full URL string
	Endpoints *[]string `json:"endpoints,omitempty" yaml:"endpoints,omitempty"`

	// FunctionalityType Type of gateway functionality
	FunctionalityType *RESTAPIGatewayResponseFunctionalityType `json:"functionalityType,omitempty" yaml:"functionalityType,omitempty"`

	// Id Handle (URL-friendly slug) for the gateway
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// IsActive Indicates if the gateway is currently connected to the platform via WebSocket
	IsActive *bool `json:"isActive,omitempty" yaml:"isActive,omitempty"`

	// IsCritical Whether the gateway is critical for production
	IsCritical *bool `json:"isCritical,omitempty" yaml:"isCritical,omitempty"`

	// IsDeployed Whether the API is currently deployed to this gateway
	IsDeployed bool `json:"isDeployed" yaml:"isDeployed"`

	// OrganizationId Handle (URL-friendly slug) of the organization this gateway belongs to
	OrganizationId *string `json:"organizationId,omitempty" yaml:"organizationId,omitempty"`

	// Properties Custom key-value properties for the gateway
	Properties *map[string]interface{} `json:"properties,omitempty" yaml:"properties,omitempty"`

	// UpdatedAt Timestamp when gateway was last updated
	UpdatedAt *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// UpdatedBy User identifier of the user who last updated this resource. Only present in the detail response (GET /gateways/{gatewayId}), omitted from list responses.
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`

	// Version Gateway version in `major.minor` format (e.g. `1.0`) or CalVer `YYYY.MM.DD` format (e.g. `2026.05.13`)
	Version *string `json:"version,omitempty" yaml:"version,omitempty"`
}

type RESTAPIGatewayResponseFunctionalityType string

type RESTAPILifeCycleStatus string

type RESTAPIListResponse struct {
	// Count Number of items in current response
	Count      int        `binding:"required" json:"count" yaml:"count"`
	List       []RESTAPI  `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination `json:"pagination" yaml:"pagination"`
}

type RateLimitResetWindow struct {
	// Duration Reset duration for the limit window.
	Duration int `binding:"required" json:"duration" yaml:"duration"`

	// Unit Reset time unit for the limit window.
	Unit RateLimitResetWindowUnit `binding:"required" json:"unit" yaml:"unit"`
}

type RateLimitResetWindowUnit string

type RateLimitingLimitConfig struct {
	Cost    *CostRateLimitDimension    `json:"cost,omitempty" yaml:"cost,omitempty"`
	Request *RequestRateLimitDimension `json:"request,omitempty" yaml:"request,omitempty"`
	Token   *TokenRateLimitDimension   `json:"token,omitempty" yaml:"token,omitempty"`
}

type RateLimitingResourceLimit struct {
	// Limit Limit definition with independent request/token/cost dimensions. If all dimensions are disabled (or absent), rate limiting is off for that scope.
	Limit RateLimitingLimitConfig `json:"limit" yaml:"limit"`

	// Resource Explicit resource path to apply the limit to.
	Resource string `binding:"required" json:"resource" yaml:"resource"`
}

type RateLimitingScopeConfig struct {
	// Global Limit definition with independent request/token/cost dimensions. If all dimensions are disabled (or absent), rate limiting is off for that scope.
	Global *RateLimitingLimitConfig `json:"global,omitempty" yaml:"global,omitempty"`

	// ResourceWise Resource-specific limits with a required default limit.
	ResourceWise *ResourceWiseRateLimitingConfig `json:"resourceWise,omitempty" yaml:"resourceWise,omitempty"`
	// contains filtered or unexported fields
}

type RateLimitingScopeConfig0 = interface{}

type RateLimitingScopeConfig1 = interface{}

type RegisterOrganizationJSONRequestBody = Organization

type RemoveApplicationAPIKeyParams struct {
	// EntityID **Entity ID** of the artifact associated with the API key mapping.
	EntityID EntityIDQ `form:"entityID" json:"entityID" yaml:"entityID"`
}

type RequestRateLimitDimension struct {
	// Count Maximum number of requests in the reset window.
	Count *int `json:"count,omitempty" yaml:"count,omitempty"`

	// Enabled Enable request-count based limiting.
	Enabled *bool                 `json:"enabled,omitempty" yaml:"enabled,omitempty"`
	Reset   *RateLimitResetWindow `json:"reset,omitempty" yaml:"reset,omitempty"`
}

type ResourceWiseRateLimitingConfig struct {
	// Default Limit definition with independent request/token/cost dimensions. If all dimensions are disabled (or absent), rate limiting is off for that scope.
	Default RateLimitingLimitConfig `json:"default" yaml:"default"`

	// Resources Explicit resource limits that override the default limit.
	Resources []RateLimitingResourceLimit `binding:"required" json:"resources" yaml:"resources"`
}

type RestoreDeploymentParams struct {
	// GatewayId Handle (URL-friendly slug) of the gateway (validated against deployment's bound gateway)
	GatewayId string `form:"gatewayId" json:"gatewayId" yaml:"gatewayId"`
}

type RestoreLLMProviderDeploymentParams struct {
	// GatewayId UUID of the gateway (validated against deployment's bound gateway)
	GatewayId string `form:"gatewayId" json:"gatewayId" yaml:"gatewayId"`
}

type RestoreLLMProxyDeploymentParams struct {
	// GatewayId UUID of the gateway (validated against deployment's bound gateway)
	GatewayId string `form:"gatewayId" json:"gatewayId" yaml:"gatewayId"`
}

type RestoreMCPProxyDeploymentParams struct {
	// GatewayId Handle (URL-friendly slug) of the gateway (validated against deployment's bound gateway)
	GatewayId string `form:"gatewayId" json:"gatewayId" yaml:"gatewayId"`
}

type RotateSecretMultipartRequestBody = SecretUpdateRequest

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

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

type RouteExceptionMethods string

type SecretCreateRequest struct {
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable name for the secret
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Id Handle (slug) used in {{ secret "id" }} placeholders. Immutable after creation.
	Id   *string                  `json:"id,omitempty" yaml:"id,omitempty"`
	Type *SecretCreateRequestType `json:"type,omitempty" yaml:"type,omitempty"`

	// Value Plaintext secret value — encrypted at rest, never returned in any response
	Value string `binding:"required" json:"value" yaml:"value"`
}

type SecretCreateRequestType string

type SecretListResponse struct {
	// Count Number of secrets in current response
	Count      int             `binding:"required" json:"count" yaml:"count"`
	List       []SecretSummary `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination      `json:"pagination" yaml:"pagination"`
}

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

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// DisplayName Human-readable name for the secret
	DisplayName string     `binding:"required" json:"displayName" yaml:"displayName"`
	Id          *string    `json:"id,omitempty" yaml:"id,omitempty"`
	UpdatedAt   *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// UpdatedBy User identifier of the user who last updated this resource
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`
}

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

	// CreatedBy User identifier of the user who created this resource
	CreatedBy   *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable name for the secret
	DisplayName string                 `binding:"required" json:"displayName" yaml:"displayName"`
	Hash        *string                `json:"hash,omitempty" yaml:"hash,omitempty"`
	Id          *string                `json:"id,omitempty" yaml:"id,omitempty"`
	Provider    *SecretSummaryProvider `json:"provider,omitempty" yaml:"provider,omitempty"`
	Status      *SecretSummaryStatus   `json:"status,omitempty" yaml:"status,omitempty"`
	Type        *SecretSummaryType     `json:"type,omitempty" yaml:"type,omitempty"`
	UpdatedAt   *time.Time             `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`
}

type SecretSummaryProvider string

type SecretSummaryStatus string

type SecretSummaryType string

type SecretUpdateRequest struct {
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable name for the secret
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// Id Secret handle — if provided, must match the path parameter; returns 400 if they differ. The handle is immutable and cannot be changed via update.
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Value New plaintext secret value — re-encrypted at rest
	Value string `binding:"required" json:"value" yaml:"value"`
}

type SecurityConfig struct {
	// ApiKey Configuration for API key based authentication
	ApiKey *APIKeySecurity `json:"apiKey,omitempty" yaml:"apiKey,omitempty"`

	// Enabled Whether security is enabled
	Enabled *bool `json:"enabled,omitempty" yaml:"enabled,omitempty"`
}

type ServiceUnavailable = Error

type SetLLMProviderTemplateVersionEnabledJSONBody struct {
	Enabled bool `json:"enabled" yaml:"enabled"`
}

type SetLLMProviderTemplateVersionEnabledJSONRequestBody SetLLMProviderTemplateVersionEnabledJSONBody

type SortByQ string

type SortOrderQ string

type Subscription struct {
	// ApiId Handle (ID) of the subscribed artifact
	ApiId *string `json:"apiId,omitempty" yaml:"apiId,omitempty"`

	// ApplicationId Handle (ID) of the application this subscription belongs to (optional for token-based subscriptions)
	ApplicationId *string    `json:"applicationId,omitempty" yaml:"applicationId,omitempty"`
	CreatedAt     *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// Id Subscription ID
	Id *openapi_types.UUID `json:"id,omitempty" yaml:"id,omitempty"`

	// Kind Type of the subscribed artifact
	Kind *SubscriptionKind `json:"kind,omitempty" yaml:"kind,omitempty"`

	// OrganizationId Handle (URL-friendly slug) of the organization this subscription belongs to
	OrganizationId *string             `json:"organizationId,omitempty" yaml:"organizationId,omitempty"`
	Status         *SubscriptionStatus `json:"status,omitempty" yaml:"status,omitempty"`

	// SubscriberId Unique subscriber identifier for this API (required)
	SubscriberId *string `json:"subscriberId,omitempty" yaml:"subscriberId,omitempty"`

	// SubscriptionPlanId Handle (slug) of the subscription plan
	SubscriptionPlanId *string `json:"subscriptionPlanId,omitempty" yaml:"subscriptionPlanId,omitempty"`

	// SubscriptionPlanName Subscription plan display name (e.g. Bronze, Gold)
	SubscriptionPlanName *string `json:"subscriptionPlanName,omitempty" yaml:"subscriptionPlanName,omitempty"`

	// SubscriptionToken Opaque subscription token for API invocation via Subscription-Key header
	SubscriptionToken *string    `json:"subscriptionToken,omitempty" yaml:"subscriptionToken,omitempty"`
	UpdatedAt         *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// UpdatedBy User identifier of the user who last updated this resource. Only present in the detail response (GET /subscriptions/{subscriptionId}), omitted from list responses.
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`
}

type SubscriptionKind string

type SubscriptionListResponse struct {
	// Count Number of subscriptions in current response
	Count int `binding:"required" json:"count" yaml:"count"`

	// List List of subscriptions in current response
	List       []Subscription `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination     `json:"pagination" yaml:"pagination"`
}

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

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// DisplayName Human-readable name for the subscription plan
	DisplayName string     `binding:"required" json:"displayName" yaml:"displayName"`
	ExpiryTime  *time.Time `json:"expiryTime,omitempty" yaml:"expiryTime,omitempty"`

	// Id Handle (slug) for the subscription plan
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Limits Throttling limits configured for the plan. Only one entry is currently supported and returned, even though the underlying storage allows multiple.
	Limits *[]SubscriptionPlanLimit `json:"limits,omitempty" yaml:"limits,omitempty"`

	// OrganizationId Handle (URL-friendly slug) of the organization this plan belongs to
	OrganizationId *string                 `json:"organizationId,omitempty" yaml:"organizationId,omitempty"`
	Status         *SubscriptionPlanStatus `json:"status,omitempty" yaml:"status,omitempty"`
	UpdatedAt      *time.Time              `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// UpdatedBy User identifier of the user who last updated this resource. Only present in the detail response (GET /subscription-plans/{planId}), omitted from list responses.
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`
}

type SubscriptionPlanLimit struct {
	// LimitCount Number of requests (or units, for BANDWIDTH/TOTAL_TOKEN_COUNT) allowed in the throttle window
	LimitCount int `binding:"required" json:"limitCount" yaml:"limitCount"`

	// LimitCountUnit Unit for limitCount when limitType is BANDWIDTH (e.g. MB, GB)
	LimitCountUnit *string `json:"limitCountUnit,omitempty" yaml:"limitCountUnit,omitempty"`

	// LimitType Kind of quota this limit enforces. Only REQUEST_COUNT is currently enforced; other values are accepted by the schema for forward compatibility but are rejected by the API today.
	LimitType *SubscriptionPlanLimitLimitType `json:"limitType,omitempty" yaml:"limitType,omitempty"`

	// StopOnQuotaReach Whether to block requests when this limit's quota is exhausted
	StopOnQuotaReach *bool `json:"stopOnQuotaReach,omitempty" yaml:"stopOnQuotaReach,omitempty"`

	// TimeAmount Number of timeUnit windows the limit applies over (e.g. 2 with timeUnit=HOUR means "per 2 hours")
	TimeAmount *int `json:"timeAmount,omitempty" yaml:"timeAmount,omitempty"`

	// TimeUnit Throttle window unit
	TimeUnit SubscriptionPlanLimitTimeUnit `binding:"required" json:"timeUnit" yaml:"timeUnit"`
}

type SubscriptionPlanLimitLimitType string

type SubscriptionPlanLimitTimeUnit string

type SubscriptionPlanListResponse struct {
	// Count Number of subscription plans in current response
	Count int `binding:"required" json:"count" yaml:"count"`

	// List List of subscription plans in current response
	List       []SubscriptionPlan `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination         `json:"pagination" yaml:"pagination"`
}

type SubscriptionPlanStatus string

type SubscriptionStatus string

type SyncCustomPolicyParams struct {
	// GatewayId UUID of the gateway whose manifest contains the policy
	GatewayId openapi_types.UUID `form:"gatewayId" json:"gatewayId" yaml:"gatewayId"`

	// PolicyName Name of the custom policy (case-insensitive)
	PolicyName string `form:"policyName" json:"policyName" yaml:"policyName"`

	// PolicyVersion Version of the custom policy in MAJOR.MINOR.PATCH format
	PolicyVersion string `form:"policyVersion" json:"policyVersion" yaml:"policyVersion"`
}

type TimeUnit string

type TokenId = openapi_types.UUID

type TokenInfoResponse struct {
	// CreatedAt Timestamp when token was created
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// Id Token UUID
	Id *openapi_types.UUID `json:"id,omitempty" yaml:"id,omitempty"`

	// RevokedAt Timestamp when token was revoked (null if active)
	RevokedAt *time.Time `json:"revokedAt" yaml:"revokedAt"`

	// Status Current token status
	Status *TokenInfoResponseStatus `json:"status,omitempty" yaml:"status,omitempty"`
}

type TokenInfoResponseStatus string

type TokenRateLimitDimension struct {
	// Count Maximum number of tokens in the reset window.
	Count *int `json:"count,omitempty" yaml:"count,omitempty"`

	// Enabled Enable token-count based limiting.
	Enabled *bool                 `json:"enabled,omitempty" yaml:"enabled,omitempty"`
	Reset   *RateLimitResetWindow `json:"reset,omitempty" yaml:"reset,omitempty"`
}

type TokenRotationResponse struct {
	// CreatedAt Timestamp when new token was created
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// Id ID of the newly generated token
	Id *openapi_types.UUID `json:"id,omitempty" yaml:"id,omitempty"`

	// Message Informational message about token rotation
	Message *string `json:"message,omitempty" yaml:"message,omitempty"`

	// Token Plain-text new authentication token (only exposed once during rotation)
	Token *string `json:"token,omitempty" yaml:"token,omitempty"`
}

type Unauthorized = Error

type UndeployDeploymentParams struct {
	// GatewayId Handle (URL-friendly slug) of the gateway (validated against deployment's bound gateway)
	GatewayId string `form:"gatewayId" json:"gatewayId" yaml:"gatewayId"`
}

type UndeployLLMProviderDeploymentParams struct {
	// GatewayId UUID of the gateway (validated against deployment's bound gateway)
	GatewayId string `form:"gatewayId" json:"gatewayId" yaml:"gatewayId"`
}

type UndeployLLMProxyDeploymentParams struct {
	// GatewayId UUID of the gateway (validated against deployment's bound gateway)
	GatewayId string `form:"gatewayId" json:"gatewayId" yaml:"gatewayId"`
}

type UndeployMCPProxyDeploymentParams struct {
	// GatewayId Handle (URL-friendly slug) of the gateway (validated against deployment's bound gateway)
	GatewayId string `form:"gatewayId" json:"gatewayId" yaml:"gatewayId"`
}

type UnpublishFromDevPortalRequest struct {
	// DevPortalUuid UUID of the DevPortal to unpublish from
	DevPortalUuid openapi_types.UUID `binding:"required" json:"devPortalUuid" yaml:"devPortalUuid"`
}

type UnpublishRESTAPIFromDevPortalJSONRequestBody = UnpublishFromDevPortalRequest

type UnpublishWebBrokerAPIFromDevPortalJSONRequestBody = UnpublishFromDevPortalRequest

type UnpublishWebSubAPIFromDevPortalJSONRequestBody = UnpublishFromDevPortalRequest

type UpdateAPIKeyJSONRequestBody = UpdateAPIKeyRequest

type UpdateAPIKeyRequest struct {
	// ApiKey The new plain text API key value that will be hashed before storage
	ApiKey string `binding:"required" json:"apiKey" yaml:"apiKey"`

	// DisplayName Human-readable name for the API key
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// ExpiresAt Optional expiration time in ISO 8601 format
	ExpiresAt *time.Time          `json:"expiresAt" yaml:"expiresAt"`
	ExpiresIn *ExpirationDuration `json:"expiresIn,omitempty" yaml:"expiresIn,omitempty"`

	// ExternalRefId Optional reference ID for tracing purposes (from external platforms)
	ExternalRefId *string `json:"externalRefId" yaml:"externalRefId"`

	// Issuer Identifies the portal that created this key
	Issuer *string `json:"issuer,omitempty" yaml:"issuer,omitempty"`

	// Name Unique identifier for this API key within the API (optional; if omitted, generated from displayName)
	Name *string `json:"name,omitempty" yaml:"name,omitempty"`
}

type UpdateAPIKeyResponse struct {
	// KeyId The internal ID of the updated key
	KeyId *string `json:"keyId,omitempty" yaml:"keyId,omitempty"`

	// Message Additional details about the operation result
	Message string `binding:"required" json:"message" yaml:"message"`

	// Status Status of the operation
	Status UpdateAPIKeyResponseStatus `binding:"required" json:"status" yaml:"status"`
}

type UpdateAPIKeyResponseStatus string

type UpdateApplicationJSONRequestBody = Application

type UpdateGatewayJSONRequestBody = GatewayResponse

type UpdateLLMProviderJSONRequestBody = LLMProvider

type UpdateLLMProviderTemplateJSONRequestBody = LLMProviderTemplate

type UpdateLLMProxyJSONRequestBody = LLMProxy

type UpdateMCPProxyJSONRequestBody = MCPProxy

type UpdateProjectJSONRequestBody = Project

type UpdateRESTAPIJSONRequestBody = RESTAPI

type UpdateSubscriptionJSONRequestBody = Subscription

type UpdateSubscriptionParams struct {
	// SubscriberId Subscriber ID; must match the subscription's subscriberId.
	SubscriberId string `form:"subscriberId" json:"subscriberId" yaml:"subscriberId"`
}

type UpdateSubscriptionPlanJSONRequestBody = SubscriptionPlan

type Upstream struct {
	// Main Upstream endpoint configuration (single target or reference)
	Main UpstreamDefinition `json:"main" yaml:"main"`

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

type UpstreamAuth struct {
	// Header Header name for api-key authentication (e.g., 'Authorization' for bearer/basic, custom header for api-key)
	Header *string `json:"header,omitempty" yaml:"header,omitempty"`

	// Type Authentication type
	Type *UpstreamAuthType `json:"type,omitempty" yaml:"type,omitempty"`

	// Value Authentication value (API key, Bearer token, or Base64 encoded credentials for basic auth)
	Value *string `json:"value,omitempty" yaml:"value,omitempty"`
}

type UpstreamAuthType string

type UpstreamDefinition struct {
	// Auth Authentication configuration for upstream endpoints
	Auth *UpstreamAuth `json:"auth,omitempty" yaml:"auth,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 UpstreamDefinition0 = interface{}

type UpstreamDefinition1 = interface{}

type UserAPIKeyItem struct {
	// AllowedTargets Comma-separated list of allowed gateways; 'ALL' means unrestricted
	AllowedTargets string `binding:"required" json:"allowedTargets" yaml:"allowedTargets"`

	// ArtifactId Handle (ID) of the artifact this key belongs to
	ArtifactId string `json:"artifactId" yaml:"artifactId"`

	// ArtifactType Type of the artifact this key belongs to
	ArtifactType UserAPIKeyItemArtifactType `json:"artifactType" yaml:"artifactType"`

	// CreatedAt Timestamp when the key was created
	CreatedAt time.Time `binding:"required" json:"createdAt" yaml:"createdAt"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `binding:"required" json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// DisplayName Human-readable display name of the API key
	DisplayName string `binding:"required" json:"displayName" yaml:"displayName"`

	// ExpiresAt Optional expiration timestamp
	ExpiresAt *time.Time `json:"expiresAt,omitempty" yaml:"expiresAt,omitempty"`

	// Id URL-safe handle (identifier) of the API key (generated from displayName when not supplied)
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Issuer Optional identifier of the developer portal that provisioned this key
	Issuer *string `json:"issuer,omitempty" yaml:"issuer,omitempty"`

	// MaskedApiKey Masked representation of the API key for display purposes
	MaskedApiKey string `binding:"required" json:"maskedApiKey" yaml:"maskedApiKey"`

	// Status Current status of the key
	Status UserAPIKeyItemStatus `binding:"required" json:"status" yaml:"status"`

	// UpdatedAt Timestamp when the key was last updated
	UpdatedAt time.Time `binding:"required" json:"updatedAt" yaml:"updatedAt"`
}

type UserAPIKeyItemArtifactType string

type UserAPIKeyItemStatus string

type UserAPIKeyListResponse struct {
	// Count Number of API keys in current response
	Count int `binding:"required" json:"count" yaml:"count"`

	// List List of API keys
	List       []UserAPIKeyItem `binding:"required" json:"list" yaml:"list"`
	Pagination Pagination       `json:"pagination" yaml:"pagination"`
}

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

	// Broker Message broker configuration
	Broker struct {
		Name       string                  `json:"name" yaml:"name"`
		Properties *map[string]interface{} `json:"properties,omitempty" yaml:"properties,omitempty"`
		Type       WebBrokerAPIBrokerType  `json:"type" yaml:"type"`
	} `json:"broker" yaml:"broker"`

	// Channels Per-channel configuration keyed by channel name. Each key is a channel name and defines policies and topics for that channel.
	Channels map[string]WebBrokerChannel `json:"channels" yaml:"channels"`

	// Context Base path for the API (must start with /)
	Context   *string    `json:"context,omitempty" yaml:"context,omitempty"`
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy   *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable name for the WebBroker API
	DisplayName string `json:"displayName" yaml:"displayName"`

	// Id Unique handle for the WebBroker API
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Kind Kind of the WebBroker API
	Kind *string `json:"kind,omitempty" yaml:"kind,omitempty"`

	// LifeCycleStatus Lifecycle status of the WebBroker API
	LifeCycleStatus *WebBrokerAPILifeCycleStatus `json:"lifeCycleStatus,omitempty" yaml:"lifeCycleStatus,omitempty"`

	// ProjectId UUID of the project this API belongs to
	ProjectId string `json:"projectId" yaml:"projectId"`

	// ReadOnly True when the artifact originated from a data-plane gateway (origin gateway_api) and is read-only in the control plane.
	ReadOnly *bool `json:"readOnly,omitempty" yaml:"readOnly,omitempty"`

	// Receiver WebSocket receiver configuration
	Receiver struct {
		Name       string                   `json:"name" yaml:"name"`
		Properties *map[string]interface{}  `json:"properties,omitempty" yaml:"properties,omitempty"`
		Type       WebBrokerAPIReceiverType `json:"type" yaml:"type"`
	} `json:"receiver" yaml:"receiver"`

	// SubscriptionPlans List of subscription plan IDs
	SubscriptionPlans *[]string `json:"subscriptionPlans,omitempty" yaml:"subscriptionPlans,omitempty"`

	// Transport Supported transport protocols
	Transport *[]WebBrokerAPITransport `json:"transport,omitempty" yaml:"transport,omitempty"`
	UpdatedAt *time.Time               `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// UpdatedBy User identifier of the user who last updated this resource. Only present in the detail response (GET /webbroker-apis/{id}), omitted from list responses.
	UpdatedBy *string `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`

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

type WebBrokerAPIBrokerType string

type WebBrokerAPILifeCycleStatus string

type WebBrokerAPIListItem struct {
	Context   *string    `json:"context,omitempty" yaml:"context,omitempty"`
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// DisplayName Human-readable name for the WebBroker API
	DisplayName     string                               `json:"displayName" yaml:"displayName"`
	Id              *string                              `json:"id,omitempty" yaml:"id,omitempty"`
	LifeCycleStatus *WebBrokerAPIListItemLifeCycleStatus `json:"lifeCycleStatus,omitempty" yaml:"lifeCycleStatus,omitempty"`
	ProjectId       *string                              `json:"projectId,omitempty" yaml:"projectId,omitempty"`

	// ReadOnly True when the artifact originated from a data-plane gateway (origin gateway_api) and is read-only in the control plane.
	ReadOnly  *bool      `json:"readOnly,omitempty" yaml:"readOnly,omitempty"`
	UpdatedAt *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`
	Version   *string    `json:"version,omitempty" yaml:"version,omitempty"`
}

type WebBrokerAPIListItemLifeCycleStatus string

type WebBrokerAPIListResponse struct {
	Count      int                    `json:"count" yaml:"count"`
	List       []WebBrokerAPIListItem `json:"list" yaml:"list"`
	Pagination Pagination             `json:"pagination" yaml:"pagination"`
}

type WebBrokerAPIReceiverType string

type WebBrokerAPITransport string

type WebBrokerAllChannelPolicies struct {
	// OnConnectionInit Policies for a single event type.
	OnConnectionInit *WebBrokerEventPolicies `json:"on_connection_init,omitempty" yaml:"on_connection_init,omitempty"`

	// OnConsume Policies for a single event type.
	OnConsume *WebBrokerEventPolicies `json:"on_consume,omitempty" yaml:"on_consume,omitempty"`

	// OnProduce Policies for a single event type.
	OnProduce *WebBrokerEventPolicies `json:"on_produce,omitempty" yaml:"on_produce,omitempty"`
}

type WebBrokerChannel struct {
	// ConsumeFrom Kafka topic to consume messages from
	ConsumeFrom *struct {
		Topic *string `json:"topic,omitempty" yaml:"topic,omitempty"`
	} `json:"consumeFrom,omitempty" yaml:"consumeFrom,omitempty"`

	// OnConnectionInit Policies for a single event type.
	OnConnectionInit *WebBrokerEventPolicies `json:"on_connection_init,omitempty" yaml:"on_connection_init,omitempty"`

	// OnConsume Policies for a single event type.
	OnConsume *WebBrokerEventPolicies `json:"on_consume,omitempty" yaml:"on_consume,omitempty"`

	// OnProduce Policies for a single event type.
	OnProduce *WebBrokerEventPolicies `json:"on_produce,omitempty" yaml:"on_produce,omitempty"`

	// ProduceTo Kafka topic to produce messages to
	ProduceTo *struct {
		Topic *string `json:"topic,omitempty" yaml:"topic,omitempty"`
	} `json:"produceTo,omitempty" yaml:"produceTo,omitempty"`
}

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

type WebSubAPI 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" yaml:"channels"`

	// Context Base path for the API (must start with /)
	Context   *string    `json:"context,omitempty" yaml:"context,omitempty"`
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy   *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`
	Description *string `json:"description,omitempty" yaml:"description,omitempty"`

	// DisplayName Human-readable name for the WebSub API
	DisplayName string `json:"displayName" yaml:"displayName"`

	// Id Unique handle for the WebSub API
	Id *string `json:"id,omitempty" yaml:"id,omitempty"`

	// Kind Kind of the WebSub API
	Kind *string `json:"kind,omitempty" yaml:"kind,omitempty"`

	// LifeCycleStatus Lifecycle status of the WebSub API
	LifeCycleStatus *WebSubAPILifeCycleStatus `json:"lifeCycleStatus,omitempty" yaml:"lifeCycleStatus,omitempty"`

	// ProjectId UUID of the project this API belongs to
	ProjectId string `json:"projectId" yaml:"projectId"`

	// ReadOnly True when the artifact originated from a data-plane gateway (origin gateway_api) and is read-only in the control plane.
	ReadOnly *bool `json:"readOnly,omitempty" yaml:"readOnly,omitempty"`

	// SubscriptionPlans List of subscription plan IDs
	SubscriptionPlans *[]string `json:"subscriptionPlans,omitempty" yaml:"subscriptionPlans,omitempty"`

	// Transport Supported transport protocols
	Transport *[]WebSubAPITransport `json:"transport,omitempty" yaml:"transport,omitempty"`
	UpdatedAt *time.Time            `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`

	// UpdatedBy User identifier of the user who last updated this resource. Only present in the detail response (GET /websub-apis/{id}), omitted from list responses.
	UpdatedBy *string  `json:"updatedBy,omitempty" yaml:"updatedBy,omitempty"`
	Upstream  Upstream `json:"upstream" yaml:"upstream"`

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

type WebSubAPIHmacSecretCreationResponse struct {
	// Message Human-readable confirmation message.
	Message string `json:"message" yaml:"message"`

	// Secret The plaintext HMAC secret value. This is returned **once** at creation/regeneration time
	// and is never stored unencrypted — save it immediately.
	Secret        string                   `json:"secret" yaml:"secret"`
	WebhookSecret *WebSubAPIHmacSecretInfo `json:"webhookSecret,omitempty" yaml:"webhookSecret,omitempty"`
}

type WebSubAPIHmacSecretInfo struct {
	CreatedAt time.Time `json:"createdAt" yaml:"createdAt"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// DisplayName Human-readable name for the HMAC secret
	DisplayName string `json:"displayName" yaml:"displayName"`

	// Name URL-safe slug derived from the display name.
	Name string `json:"name" yaml:"name"`

	// Status Status of the HMAC secret.
	Status    string    `json:"status" yaml:"status"`
	UpdatedAt time.Time `json:"updatedAt" yaml:"updatedAt"`

	// Uuid Unique identifier for the HMAC secret.
	Uuid string `json:"uuid" yaml:"uuid"`
}

type WebSubAPIHmacSecretListResponse struct {
	Secrets []WebSubAPIHmacSecretInfo `json:"secrets" yaml:"secrets"`
}

type WebSubAPIHmacSecretRegenerateRequest struct {
	// Secret Optional. If provided, this value is used as the new HMAC secret instead of auto-generating one.
	// Must be at least 32 characters long.
	Secret *string `json:"secret,omitempty" yaml:"secret,omitempty"`
}

type WebSubAPIHmacSecretRequest struct {
	// DisplayName Human-readable label for the HMAC secret (used to derive the URL-safe name/slug).
	DisplayName string `json:"displayName" yaml:"displayName"`

	// Secret Optional. If provided, this value is used as the HMAC secret instead of auto-generating one.
	// Must be at least 32 characters long.
	Secret *string `json:"secret,omitempty" yaml:"secret,omitempty"`
}

type WebSubAPILifeCycleStatus string

type WebSubAPIListItem struct {
	Context   *string    `json:"context,omitempty" yaml:"context,omitempty"`
	CreatedAt *time.Time `json:"createdAt,omitempty" yaml:"createdAt,omitempty"`

	// CreatedBy User identifier of the user who created this resource
	CreatedBy *string `json:"createdBy,omitempty" yaml:"createdBy,omitempty"`

	// DisplayName Human-readable name for the WebSub API
	DisplayName     string                            `json:"displayName" yaml:"displayName"`
	Id              *string                           `json:"id,omitempty" yaml:"id,omitempty"`
	LifeCycleStatus *WebSubAPIListItemLifeCycleStatus `json:"lifeCycleStatus,omitempty" yaml:"lifeCycleStatus,omitempty"`
	ProjectId       *string                           `json:"projectId,omitempty" yaml:"projectId,omitempty"`

	// ReadOnly True when the artifact originated from a data-plane gateway (origin gateway_api) and is read-only in the control plane.
	ReadOnly  *bool      `json:"readOnly,omitempty" yaml:"readOnly,omitempty"`
	UpdatedAt *time.Time `json:"updatedAt,omitempty" yaml:"updatedAt,omitempty"`
	Version   *string    `json:"version,omitempty" yaml:"version,omitempty"`
}

type WebSubAPIListItemLifeCycleStatus string

type WebSubAPIListResponse struct {
	Count      int                 `json:"count" yaml:"count"`
	List       []WebSubAPIListItem `json:"list" yaml:"list"`
	Pagination Pagination          `json:"pagination" yaml:"pagination"`
}

type WebSubAPITransport 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"`
}