api

type AccessTokenFields model.AccessToken

type AccessTokenResponse struct {
	AccessTokenFields
	Token string `json:"token"` // Only populated on creation
}

type AvailableForgeResponse struct {
	ID        int64  `json:"id"`
	URL       string `json:"url"`
	Type      string `json:"type"`
	IsLinked  bool   `json:"is_linked"`
	IsPrimary bool   `json:"is_primary,omitempty"`
	LinkedAs  string `json:"linked_as,omitempty"`
}

type CancelPipelineInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Number int64 `path:"number" doc:"the number of the pipeline"`
}

type CancelWorkflowInput struct {
	RepoID     int64 `path:"repo_id" doc:"the repository id"`
	Number     int64 `path:"number" doc:"the number of the pipeline"`
	WorkflowID int64 `path:"workflow_id" doc:"the id of the workflow to cancel"`
}

type ChownRepoInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
}

type ChownRepoOutput struct {
	Body *model.Repo
}

type CreateAccessTokenRequest struct {
	Name      string   `json:"name" minLength:"1" doc:"token name"`
	Scopes    []string `json:"scopes" minItems:"1" doc:"token scopes"`
	OrgID     int64    `json:"org_id,omitempty" doc:"optional org scope"`
	RepoID    int64    `json:"repo_id,omitempty" doc:"optional repo scope"`
	ExpiresAt int64    `json:"expires_at,omitempty" doc:"optional expiry timestamp"`
}

type CreatePipelineBody struct {
	Branch    string            `json:"branch" doc:"branch to run pipeline on"`
	Variables map[string]string `json:"variables,omitempty" doc:"pipeline variables"`
	Workflows []string          `json:"workflows,omitempty" doc:"workflows to filter"`
}

type CreatePipelineInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Body   CreatePipelineBody
}

type CreatePipelineOutput struct {
	Body *model.Pipeline
}

type DeleteAccessTokenBatchInput struct {
	Body DeleteAccessTokenBatchRequest
}

type DeleteAccessTokenBatchRequest struct {
	IDs []int64 `json:"ids" minItems:"1" doc:"token IDs to delete"`
}

type DeleteAccessTokenInput struct {
	TokenID int64 `path:"token_id" doc:"the token's id"`
}

type DeleteAgentInput struct {
	AgentID int64 `path:"agent_id" doc:"the agent's id"`
}

type DeleteApprovalAlwaysInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Number int64 `path:"number" doc:"the number of the pipeline"`
}

type DeleteAutoscalerInput struct {
	AutoscalerID int64 `path:"autoscaler_id" doc:"the autoscaler's id"`
}

type DeleteCronInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Cron   int64 `path:"cron" doc:"the cron job id"`
}

type DeleteForgeInput struct {
	ForgeID int64 `path:"forgeId" doc:"the forge's id"`
}

type DeleteGlobalRegistryInput struct {
	Registry string `path:"registry" doc:"the registry's name"`
}

type DeleteGlobalSecretInput struct {
	Secret string `path:"secret" doc:"the secret's name"`
}

type DeleteIntegrationInput struct {
	IntegrationID int64 `path:"integration_id" doc:"the integration's id"`
}

type DeleteOrgAgentInput struct {
	OrgID   int64 `path:"org_id" doc:"the organization's id"`
	AgentID int64 `path:"agent_id" doc:"the agent's id"`
}

type DeleteOrgInput struct {
	OrgID int64 `path:"org_id" doc:"the org's id"`
}

type DeleteOrgRegistryInput struct {
	OrgID    int64  `path:"org_id" doc:"the org's id"`
	Registry string `path:"registry" doc:"the registry's name"`
}

type DeleteOrgSecretInput struct {
	OrgID  int64  `path:"org_id" doc:"the org's id"`
	Secret string `path:"secret" doc:"the secret's name"`
}

type DeletePipelineInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Number int64 `path:"number" doc:"the number of the pipeline"`
}

type DeletePipelineLogsInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Number int64 `path:"number" doc:"the number of the pipeline"`
}

type DeleteRegistryInput struct {
	RepoID   int64  `path:"repo_id" doc:"the repository id"`
	Registry string `path:"registry" doc:"the registry name"`
}

type DeleteRepoInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Remove bool  `query:"remove" doc:"permanently delete the repository"`
}

type DeleteRepoNotificationConfigInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
}

type DeleteRepoNotificationConfigOutput struct {
	Body struct{}
}

type DeleteRepoOutput struct {
	Body *model.Repo
}

type DeleteSecretInput struct {
	RepoID int64  `path:"repo_id" doc:"the repository id"`
	Secret string `path:"secret" doc:"the secret name"`
}

type DeleteSecretTargetInput struct {
	SecretID int64 `path:"secret_id" doc:"secret ID"`
	TargetID int64 `path:"target_id" doc:"target ID"`
}

type DeleteStepLogsInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Number int64 `path:"number" doc:"the number of the pipeline"`
	StepID int64 `path:"stepId" doc:"the step id"`
}

type DeleteTokenInput struct{}

type DeleteTokenOutput struct {
	Body string
}

type DeleteUserForgeInput struct {
	ForgeID int64 `path:"forge_id" doc:"the forge's id"`
}

type DeleteUserForgeOutput struct {
	Body UnlinkForgeResponse
}

type DeleteUserInput struct {
	Login string `path:"login" doc:"the user's login name"`
}

type ForgeBody struct {
	URL               string          `json:"url" doc:"forge URL"`
	Type              model.ForgeType `json:"type" doc:"forge type"`
	Client            string          `json:"client,omitempty" doc:"OAuth client ID"`
	ClientSecret      string          `json:"client_secret,omitempty" doc:"OAuth client secret"`
	OAuthHost         string          `json:"oauth_host,omitempty" doc:"OAuth host"`
	SkipVerify        bool            `json:"skip_verify,omitempty" doc:"skip TLS verification"`
	AdditionalOptions map[string]any  `json:"additional_options,omitempty" doc:"additional forge options"`
}

type GetAccessTokenInput struct {
	TokenID int64 `path:"token_id" doc:"the token's id"`
}

type GetAccessTokenListInput struct {
	PaginationParams
}

type GetAccessTokenListOutput struct {
	Body []*model.AccessToken
}

type GetAccessTokenOutput struct {
	Body *model.AccessToken
}

type GetAccessibleIntegrationsInput struct {
	PaginationParams
}

type GetAccessibleIntegrationsOutput struct {
	Body []*model.Integration
}

type GetActiveReposInput struct{}

type GetActiveReposOutput struct {
	Body []*model.RepoLastPipeline
}

type GetAdminSMTPStatusInput struct{}

type GetAdminSMTPStatusOutput struct {
	Body notification.SMTPStatus
}

type GetAgentInput struct {
	AgentID int64 `path:"agent_id" doc:"the agent's id"`
}

type GetAgentOutput struct {
	Body *model.AgentWithStats
}

type GetAgentTasksInput struct {
	AgentID int64 `path:"agent_id" doc:"the agent's id"`
}

type GetAgentTasksOutput struct {
	Body []model.QueueTask
}

type GetAgentWorkflowsInput struct {
	PaginationParams
	AgentID int64 `path:"agent_id" doc:"the agent's id"`
}

type GetAgentWorkflowsOutput struct {
	Body []*model.AgentWorkflow
}

type GetAgentsInput struct {
	PaginationParams
	Search   string `query:"search" doc:"search in name, platform, backend, custom labels, ID"`
	Platform string `query:"platform" doc:"filter by platform"`
	Backend  string `query:"backend" doc:"filter by backend"`
	Sort     string `query:"sort" default:"id" doc:"sort field: id, name, platform, backend, last_contact, capacity"`
	Order    string `query:"order" default:"asc" doc:"sort order: asc or desc"`
}

type GetAgentsOutput struct {
	Body []model.AgentWithStats
}

type GetAllReposInput struct {
	PaginationParams
	Active bool `query:"active" doc:"only list active repos"`
}

type GetAllReposOutput struct {
	Body []*model.Repo
}

type GetAutoscalerInput struct {
	AutoscalerID int64 `path:"autoscaler_id" doc:"the autoscaler's id"`
}

type GetAutoscalerOutput struct {
	Body *model.Autoscaler
}

type GetAutoscalerSelfInput struct{}

type GetAutoscalerSelfOutput struct {
	Body *model.Autoscaler
}

type GetAutoscalersInput struct {
	PaginationParams
	Search   string `query:"search" doc:"search in name, provider, region, ID"`
	Provider string `query:"provider" doc:"filter by provider"`
	Enabled  string `query:"enabled" doc:"filter by enabled status (true/false, empty=all)"`
	Sort     string `query:"sort" default:"id" doc:"sort field: id, name, provider, last_contact"`
	Order    string `query:"order" default:"asc" doc:"sort order: asc or desc"`
}

type GetAutoscalersOutput struct {
	Body []*model.Autoscaler
}

type GetAvailableForgesInput struct{}

type GetAvailableForgesOutput struct {
	Body []*AvailableForgeResponse
}

type GetAvailableReposInput struct {
	ForgeID       int64 `query:"forge_id"       doc:"only return repos from this forge id (0 = all linked forges)"`
	OnlyUnenabled bool  `query:"only_unenabled" doc:"omit repos already enabled in Crow"`
}

type GetAvailableReposOutput struct {
	Body []*model.Repo
}

type GetAvailableScopesInput struct{}

type GetAvailableScopesOutput struct {
	Body map[string][]model.AccessTokenScope
}

type GetBadgeByNameInput struct {
	Owner    string `path:"repo_id_or_owner" doc:"the repository owner"`
	RepoName string `path:"repo_name" doc:"the repository name"`
	Branch   string `query:"branch" doc:"the branch name"`
}

type GetBadgeInput struct {
	RepoID string `path:"repo_id_or_owner" doc:"the repository id"`
	Branch string `query:"branch" doc:"the branch name"`
}

type GetCCByNameInput struct {
	Owner    string `path:"repo_id_or_owner" doc:"the repository owner"`
	RepoName string `path:"repo_name" doc:"the repository name"`
}

type GetCCInput struct {
	RepoID string `path:"repo_id_or_owner" doc:"the repository id"`
}

type GetCronInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Cron   int64 `path:"cron" doc:"the cron job id"`
}

type GetCronListInput struct {
	PaginationParams
	RepoID int64 `path:"repo_id" doc:"the repository id"`
}

type GetCronListOutput struct {
	Body []*model.Cron
}

type GetCronOutput struct {
	Body *model.Cron
}

type GetEntitiesInput struct {
	Page       int    `query:"page" default:"1" minimum:"1" doc:"for response pagination, page offset number"`
	PerPage    int    `query:"perPage" default:"15" minimum:"1" maximum:"50" doc:"for response pagination, max items per page"`
	EntityType string `query:"entity_type" doc:"filter by entity type (user, org, or comma-separated)"`
	IsAdmin    string `query:"is_admin" doc:"filter by admin status (true, false, or empty for all)"`
	Search     string `query:"search" doc:"search term for name/login/email"`
}

type GetEntitiesOutput struct {
	Body []*model.Entity
}

type GetFeedInput struct {
	Latest bool `query:"latest" doc:"return only the latest pipeline per repo"`
}

type GetFeedOutput struct {
	Body any
}

type GetForgeInput struct {
	ForgeID int64 `path:"forgeId" doc:"the forge's id"`
}

type GetForgeOutput struct {
	Body *model.Forge
}

type GetForgesInput struct {
	PaginationParams
}

type GetForgesOutput struct {
	Body []*model.Forge
}

type GetGlobalRegistryInput struct {
	Registry string `path:"registry" doc:"the registry's name"`
}

type GetGlobalRegistryListInput struct {
	PaginationParams
}

type GetGlobalRegistryListOutput struct {
	Body []*model.Registry
}

type GetGlobalRegistryOutput struct {
	Body *model.Registry
}

type GetGlobalSecretAbbreviatedInput struct {
	Secret string `path:"secret" doc:"the secret's name"`
}

type GetGlobalSecretAbbreviatedOutput struct {
	Body *model.Secret
}

type GetGlobalSecretInput struct {
	Secret string `path:"secret" doc:"the secret's name"`
}

type GetGlobalSecretListInput struct {
	PaginationParams
}

type GetGlobalSecretListOutput struct {
	Body []*model.Secret
}

type GetGlobalSecretOutput struct {
	Body *model.Secret
}

type GetImportableReposInput struct {
	RepoID int64 `path:"repo_id" doc:"the target repository id"`
}

type GetImportableReposOutput struct {
	Body []*model.Repo
}

type GetIntegrationInput struct {
	IntegrationID int64 `path:"integration_id" doc:"the integration's id"`
}

type GetIntegrationListInput struct {
	PaginationParams
}

type GetIntegrationListOutput struct {
	Body []*model.Integration
}

type GetIntegrationOutput struct {
	Body *model.Integration
}

type GetIntegrationTypesInput struct{}

type GetIntegrationTypesOutput struct {
	Body []IntegrationTypeInfo
}

type GetMaintenanceConfigByActionInput struct {
	Action string `path:"action" doc:"Action type (vacuum, kubernetes_cleanup, stale_agent_cleanup, docker_cleanup, orphaned_data_cleanup)"`
}

type GetMaintenanceConfigByActionOutput struct {
	Body *model.MaintenanceConfig
}

type GetMaintenanceConfigInput struct{}

type GetMaintenanceConfigOutput struct {
	Body *model.MaintenanceConfig
}

type GetMaintenanceLogsInput struct {
	Limit int `query:"limit" default:"50" doc:"Number of logs to return"`
}

type GetMaintenanceLogsOutput struct {
	Body []*model.MaintenanceLog
}

type GetMaintenanceStatsInput struct{}

type GetMaintenanceStatsOutput struct {
	Body *model.MaintenanceStats
}

type GetMetricsInput struct {
	After  int64  `query:"after" doc:"Unix timestamp - filter metrics after this time"`
	Before int64  `query:"before" doc:"Unix timestamp - filter metrics before this time"`
	All    bool   `query:"all" doc:"Show all instance metrics (admin only)"`
	Repos  string `query:"repos" doc:"Comma-separated list of repo IDs to filter by"`
}

type GetMetricsOutput struct {
	Body *model.Metrics
}

type GetOrgAgentsInput struct {
	PaginationParams
	OrgID int64 `path:"org_id" doc:"the organization's id"`
}

type GetOrgInput struct {
	OrgID int64 `path:"org_id" doc:"the organization's id"`
}

type GetOrgOutput struct {
	Body *model.Org
}

type GetOrgPermissionsInput struct {
	OrgID int64 `path:"org_id" doc:"the organization's id"`
}

type GetOrgPermissionsOutput struct {
	Body *model.OrgPerm
}

type GetOrgRegistryInput struct {
	OrgID    int64  `path:"org_id" doc:"the org's id"`
	Registry string `path:"registry" doc:"the registry's address"`
}

type GetOrgRegistryListInput struct {
	PaginationParams
	OrgID int64 `path:"org_id" doc:"the org's id"`
}

type GetOrgRegistryListOutput struct {
	Body []*model.Registry
}

type GetOrgRegistryOutput struct {
	Body *model.Registry
}

type GetOrgSecretAbbreviatedInput struct {
	OrgID  int64  `path:"org_id" doc:"the org's id"`
	Secret string `path:"secret" doc:"the secret's name"`
}

type GetOrgSecretAbbreviatedOutput struct {
	Body *model.Secret
}

type GetOrgSecretInput struct {
	OrgID  int64  `path:"org_id" doc:"the org's id"`
	Secret string `path:"secret" doc:"the secret's name"`
}

type GetOrgSecretListInput struct {
	PaginationParams
	OrgID int64 `path:"org_id" doc:"the org's id"`
}

type GetOrgSecretListOutput struct {
	Body []*model.Secret
}

type GetOrgSecretOutput struct {
	Body *model.Secret
}

type GetOrgsInput struct {
	PaginationParams
}

type GetOrgsOutput struct {
	Body []*model.Org
}

type GetPipelineConfigInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Number int64 `path:"number" doc:"the number of the pipeline"`
}

type GetPipelineConfigOutput struct {
	Body []*model.Config
}

type GetPipelineInput struct {
	RepoID int64  `path:"repo_id" doc:"the repository id"`
	Number string `path:"number" doc:"the number of the pipeline, OR 'latest'"`
}

type GetPipelineMetadataInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Number int64 `path:"number" doc:"the number of the pipeline"`
}

type GetPipelineMetadataOutput struct {
	Body *metadata.Metadata
}

type GetPipelineOutput struct {
	Body *model.Pipeline
}

type GetPipelineQueueInput struct{}

type GetPipelineQueueOutput struct {
	Body []*model.Feed
}

type GetPipelinesInput struct {
	PaginationParams
	RepoID   int64  `path:"repo_id" doc:"the repository id"`
	Before   string `query:"before" doc:"only return pipelines before this RFC3339 date"`
	After    string `query:"after" doc:"only return pipelines after this RFC3339 date"`
	Branch   string `query:"branch" doc:"filter pipelines by branch"`
	Event    string `query:"event" doc:"filter pipelines by webhook events (comma separated)"`
	Ref      string `query:"ref" doc:"filter pipelines by strings contained in ref"`
	Status   string `query:"status" doc:"filter pipelines by status"`
	Search   string `query:"search" doc:"search pipelines by number, message, branch, or author"`
	Workflow string `query:"workflow" doc:"filter pipelines by workflow name"`
}

type GetPipelinesOutput struct {
	Body []*model.Pipeline
}

type GetPublicReposInput struct {
	PaginationParams
}

type GetPublicReposOutput struct {
	Body []*model.RepoLastPipeline
}

type GetRegistryInput struct {
	RepoID   int64  `path:"repo_id" doc:"the repository id"`
	Registry string `path:"registry" doc:"the registry name"`
}

type GetRegistryListInput struct {
	PaginationParams
	RepoID int64 `path:"repo_id" doc:"the repository id"`
}

type GetRegistryListOutput struct {
	Body []*model.Registry
}

type GetRegistryOutput struct {
	Body *model.Registry
}

type GetRepoBranchesInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	PaginationParams
}

type GetRepoBranchesOutput struct {
	Body []string
}

type GetRepoConfigsInput struct {
	RepoID int64  `path:"repo_id" doc:"the repository id"`
	Branch string `query:"branch" doc:"the branch to get configs from"`
	Filter string `query:"filter" doc:"filter workflows by event type (e.g., 'manual')"`
}

type GetRepoConfigsOutput struct {
	Body ManualWorkflowsResponse
}

type GetRepoForImportInput struct {
	RepoID       int64 `path:"repo_id" doc:"the target repository id"`
	SourceRepoID int64 `path:"source_repo_id" doc:"the source repository id"`
}

type GetRepoForImportOutput struct {
	Body ImportPreviewResponse
}

type GetRepoInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
}

type GetRepoNotificationConfigInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
}

type GetRepoNotificationConfigOutput struct {
	Body *model.NotificationConfig
}

type GetRepoOutput struct {
	Body *model.Repo
}

type GetRepoPermissionsInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
}

type GetRepoPermissionsOutput struct {
	Body *model.Perm
}

type GetRepoPullRequestsInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	PaginationParams
}

type GetRepoPullRequestsOutput struct {
	Body []*model.PullRequest
}

type GetReposInput struct {
	All bool `query:"all" doc:"query all repos, including inactive ones"`
}

type GetReposOutput struct {
	Body any
}

type GetSecretAbbreviatedInput struct {
	RepoID int64  `path:"repo_id" doc:"the repository id"`
	Secret string `path:"secret" doc:"the secret name"`
}

type GetSecretAbbreviatedOutput struct {
	CacheControl string `header:"Cache-Control"`
	Body         *model.Secret
}

type GetSecretInput struct {
	RepoID int64  `path:"repo_id" doc:"the repository id"`
	Secret string `path:"secret" doc:"the secret name"`
}

type GetSecretListInput struct {
	PaginationParams
	RepoID int64 `path:"repo_id" doc:"the repository id"`
}

type GetSecretListOutput struct {
	Body []*model.Secret
}

type GetSecretOutput struct {
	Body *model.Secret
}

type GetSecretTargetListInput struct {
	SecretID int64 `path:"secret_id" doc:"secret ID"`
}

type GetSecretTargetListOutput struct {
	Body []*model.SecretTarget
}

type GetSelfInput struct{}

type GetSelfOutput struct {
	Body *model.User
}

type GetSignaturePublicKeyInput struct{}

type GetStepLogsInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Number int64 `path:"number" doc:"the number of the pipeline"`
	StepID int64 `path:"stepId" doc:"the step id"`
}

type GetStepLogsOutput struct {
	Body []*model.LogEntry
}

type GetTimezonesInput struct{}

type GetTimezonesOutput struct {
	Body []string
}

type GetUnsubscribeInput struct {
	Token string `query:"token" required:"true" doc:"signed unsubscribe token"`
}

type GetUserCronListInput struct {
	PaginationParams
	Search string `query:"search" doc:"Search term for cron name"`
}

type GetUserCronListOutput struct {
	Body []*model.CronWithRepo
}

type GetUserForgeAffectedReposInput struct {
	ForgeID int64 `path:"forge_id" doc:"the forge's id"`
}

type GetUserForgeAffectedReposOutput struct {
	Body []*model.Repo
}

type GetUserForgeInput struct {
	ForgeID int64 `path:"forge_id" doc:"the forge's id"`
}

type GetUserForgeOutput struct {
	Body *UserForgeResponse
}

type GetUserForgesInput struct{}

type GetUserForgesOutput struct {
	Body []*UserForgeResponse
}

type GetUserInput struct {
	Login string `path:"login" doc:"the user's login name"`
}

type GetUserOrgListInput struct{}

type GetUserOrgListOutput struct {
	Body []*model.Org
}

type GetUserOutput struct {
	Body *model.User
}

type GetUserPendingApprovalsBody struct {
	Approvals []*PendingApprovalItem `json:"approvals"`
}

type GetUserPendingApprovalsOutput struct {
	Body GetUserPendingApprovalsBody
}

type GetUserRegistryListInput struct {
	PaginationParams
	Scope  string `query:"scope" default:"user,org,global" doc:"Comma-separated scopes: user,org,global"`
	Search string `query:"search" doc:"Search term for registry address"`
}

type GetUserRegistryListOutput struct {
	Body []*model.RegistryWithOrg
}

type GetUserSecretListInput struct {
	PaginationParams
	Scope  string `query:"scope" default:"user,org,global" doc:"Comma-separated scopes: user,org,global"`
	Search string `query:"search" doc:"Search term for secret name"`
}

type GetUserSecretListOutput struct {
	Body []*model.SecretWithOrg
}

type GetUsersInput struct {
	PaginationParams
}

type GetUsersOutput struct {
	Body []*model.User
}

type GetWorkflowApprovalBody struct {
	Workflow *model.Workflow                `json:"workflow"`
	Events   []*model.WorkflowApprovalEvent `json:"events"`
}

type GetWorkflowApprovalInput struct {
	RepoID         int64 `path:"repo_id"     doc:"the repository id"`
	PipelineNumber int64 `path:"number"      doc:"the pipeline number"`
	WorkflowID     int64 `path:"workflow_id" doc:"the workflow id"`
}

type GetWorkflowApprovalOutput struct {
	Body GetWorkflowApprovalBody
}

type GetWorkflowNamesInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
}

type GetWorkflowNamesOutput struct {
	Body []string
}

type HealthStatus struct {
	Status     string            `json:"status"`
	InstanceID string            `json:"instance_id"`
	Timestamp  int64             `json:"timestamp"`
	Checks     map[string]string `json:"checks"`
	Version    string            `json:"version"`
	Uptime     float64           `json:"uptime_seconds"`

} //	@name	HealthStatus

type HeartbeatBody struct {
	ActiveAgents      int32             `json:"active_agents"`
	PendingAgents     int32             `json:"pending_agents"`
	Version           string            `json:"version"`
	MinAgents         int32             `json:"min_agents"`
	MaxAgents         int32             `json:"max_agents"`
	WorkflowsPerAgent int32             `json:"workflows_per_agent"`
	Provider          string            `json:"provider"`
	InstanceType      string            `json:"instance_type"`
	Region            string            `json:"region"`
	AgentLabels       map[string]string `json:"agent_labels"`
	LimitCPUQuota     string            `json:"limit_cpu_quota"`
	LimitMem          string            `json:"limit_mem"`
}

type HeartbeatResponse struct {
	Success     bool  `json:"success"`
	LastContact int64 `json:"last_contact"`
}

type ImportPreviewResponse struct {
	Repo          *model.Repo `json:"repo"`
	SecretCount   int         `json:"secret_count"`
	RegistryCount int         `json:"registry_count"`
	CronCount     int         `json:"cron_count"`
	PipelineCount int         `json:"pipeline_count"`
	// Org-level assets that would be migrated from same-named orgs on other forges
	OrgSecretCount   int    `json:"org_secret_count"`
	OrgRegistryCount int    `json:"org_registry_count"`
	OrgName          string `json:"org_name,omitempty"`
	OrgSourceForge   string `json:"org_source_forge,omitempty"`
}

type ImportSettingsInput struct {
	RepoID int64 `path:"repo_id" doc:"the target repository id"`
	Body   ImportSettingsRequest
}

type ImportSettingsOutput struct {
	Body ImportSettingsResponse
}

type ImportSettingsRequest struct {
	SourceRepoID int64 `json:"source_repo_id"`
	Settings     bool  `json:"settings"`
	Secrets      bool  `json:"secrets"`
	Registries   bool  `json:"registries"`
	Crons        bool  `json:"crons"`
	Pipelines    bool  `json:"pipelines"`
	DeleteSource bool  `json:"delete_source"`
}

type ImportSettingsResponse struct {
	Message            string `json:"message"`
	SettingsImported   bool   `json:"settings_imported"`
	SecretsImported    int    `json:"secrets_imported"`
	RegistriesImported int    `json:"registries_imported"`
	CronsImported      int    `json:"crons_imported"`
	PipelinesImported  int    `json:"pipelines_imported"`
	SourceDeleted      bool   `json:"source_deleted"`
}

type IntegrationTypeInfo struct {
	Type string `json:"type"`
	Name string `json:"name"`
}

type LookupOrgInput struct {
	OrgFullName string `path:"org_full_name" doc:"the organization's full name / slug"`
}

type LookupOrgOutput struct {
	Body *model.Org
}

type LookupRepoInput struct {
	RepoFullName string `path:"repo_full_name" doc:"the repository full name / slug"`
}

type LookupRepoOutput struct {
	Body *model.Repo
}

type ManualWorkflow struct {
	Name         string   `json:"name"`
	PipelineName string   `json:"pipeline_name"`
	DependsOn    []string `json:"depends_on,omitempty"`
	HasManual    bool     `json:"has_manual"`
}

type ManualWorkflowsResponse struct {
	Workflows []ManualWorkflow `json:"workflows"`
	Warnings  []string         `json:"warnings,omitempty"`
}

type MoveRepoInput struct {
	RepoID int64  `path:"repo_id" doc:"the repository id"`
	To     string `query:"to" required:"true" doc:"the username to move the repository to"`
}

type PaginationParams struct {
	Page    int `query:"page" default:"1" minimum:"1" doc:"for response pagination, page offset number"`
	PerPage int `query:"perPage" default:"50" minimum:"1" maximum:"50" doc:"for response pagination, max items per page"`
}

type PatchAccessTokenInput struct {
	TokenID int64 `path:"token_id" doc:"the token's id"`
	Body    UpdateAccessTokenRequest
}

type PatchAccessTokenOutput struct {
	Body *model.AccessToken
}

type PatchAgentBody struct {
	Name       string `json:"name" doc:"name of the agent"`
	NoSchedule bool   `json:"no_schedule" doc:"disable scheduling for this agent"`
	Priority   int32  `json:"priority" doc:"agent priority"`
}

type PatchAgentInput struct {
	AgentID int64 `path:"agent_id" doc:"the agent's id"`
	Body    PatchAgentBody
}

type PatchAgentOutput struct {
	Body *model.Agent
}

type PatchAutoscalerBody struct {
	Enabled bool `json:"enabled" doc:"whether the autoscaler is enabled"`
}

type PatchAutoscalerInput struct {
	AutoscalerID int64 `path:"autoscaler_id" doc:"the autoscaler's id"`
	Body         PatchAutoscalerBody
}

type PatchAutoscalerOutput struct {
	Body *model.Autoscaler
}

type PatchCronBody struct {
	Name     string `json:"name,omitempty" doc:"cron job name"`
	Schedule string `json:"schedule,omitempty" doc:"cron schedule expression"`
	Branch   string `json:"branch,omitempty" doc:"branch to run cron on"`
}

type PatchCronInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Cron   int64 `path:"cron" doc:"the cron job id"`
	Body   PatchCronBody
}

type PatchCronOutput struct {
	Body *model.Cron
}

type PatchForgeInput struct {
	ForgeID int64 `path:"forgeId" doc:"the forge's id"`
	Body    ForgeBody
}

type PatchForgeOutput struct {
	Body *model.Forge
}

type PatchGlobalRegistryInput struct {
	Registry string `path:"registry" doc:"the registry's name"`
	Body     PatchRegistryBody
}

type PatchGlobalRegistryOutput struct {
	Body *model.Registry
}

type PatchGlobalSecretInput struct {
	Secret string `path:"secret" doc:"the secret's name"`
	Body   PatchSecretBody
}

type PatchGlobalSecretOutput struct {
	Body *model.Secret
}

type PatchIntegrationBody struct {
	Name           string  `json:"name,omitempty" doc:"integration name"`
	Description    string  `json:"description,omitempty" doc:"integration description"`
	Config         string  `json:"config,omitempty" doc:"integration configuration"`
	IsActive       bool    `json:"is_active" doc:"whether integration is active"`
	AllowedUserIDs []int64 `json:"allowed_user_ids,omitempty" doc:"allowed user IDs"`
	AllowedOrgIDs  []int64 `json:"allowed_org_ids,omitempty" doc:"allowed org IDs"`
	AllowedRepoIDs []int64 `json:"allowed_repo_ids,omitempty" doc:"allowed repo IDs"`
}

type PatchIntegrationInput struct {
	IntegrationID int64 `path:"integration_id" doc:"the integration's id"`
	Body          PatchIntegrationBody
}

type PatchIntegrationOutput struct {
	Body *model.Integration
}

type PatchOrgAgentInput struct {
	OrgID   int64 `path:"org_id" doc:"the organization's id"`
	AgentID int64 `path:"agent_id" doc:"the agent's id"`
	Body    PatchAgentBody
}

type PatchOrgRegistryInput struct {
	OrgID    int64  `path:"org_id" doc:"the org's id"`
	Registry string `path:"registry" doc:"the registry's name"`
	Body     PatchRegistryBody
}

type PatchOrgRegistryOutput struct {
	Body *model.Registry
}

type PatchOrgSecretInput struct {
	OrgID  int64  `path:"org_id" doc:"the org's id"`
	Secret string `path:"secret" doc:"the secret's name"`
	Body   PatchSecretBody
}

type PatchOrgSecretOutput struct {
	Body *model.Secret
}

type PatchRegistryBody struct {
	Address  string `json:"address,omitempty" doc:"registry address"`
	Username string `json:"username,omitempty" doc:"registry username"`
	Password string `json:"password,omitempty" doc:"registry password"`
}

type PatchRegistryInput struct {
	RepoID   int64  `path:"repo_id" doc:"the repository id"`
	Registry string `path:"registry" doc:"the registry name"`
	Body     PatchRegistryBody
}

type PatchRegistryOutput struct {
	Body *model.Registry
}

type PatchRepoInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Body   model.RepoPatch
}

type PatchRepoOutput struct {
	Body *model.Repo
}

type PatchSecretBody struct {
	Value  string               `json:"value,omitempty" doc:"secret value"`
	Events []model.WebhookEvent `json:"events,omitempty" doc:"events that trigger the secret"`
	Images []string             `json:"images,omitempty" doc:"container images allowed to use the secret"`
}

type PatchSecretInput struct {
	RepoID int64  `path:"repo_id" doc:"the repository id"`
	Secret string `path:"secret" doc:"the secret name"`
	Body   PatchSecretBody
}

type PatchSecretOutput struct {
	Body *model.Secret
}

type PatchSecretOwnerBody struct {
	OrgID        int64 `json:"org_id"         doc:"new owner org ID"`
	RepoID       int64 `json:"repo_id"        doc:"new owner repo ID"`
	KeepAsTarget bool  `json:"keep_as_target" doc:"keep old owner as a shared target"`
}

type PatchSecretOwnerInput struct {
	SecretID int64 `path:"secret_id" doc:"secret ID"`
	Body     PatchSecretOwnerBody
}

type PatchUserBody struct {
	Email       string `json:"email,omitempty" doc:"user email"`
	Avatar      string `json:"avatar_url,omitempty" doc:"user avatar URL"`
	Admin       bool   `json:"admin,omitempty" doc:"whether user is admin"`
	Description string `json:"description,omitempty" doc:"user description"`
	Timezone    string `json:"timezone,omitempty" doc:"user timezone"`
}

type PatchUserInput struct {
	Login string `path:"login" doc:"the user's login name"`
	Body  PatchUserBody
}

type PatchUserOutput struct {
	Body *model.User
}

type PendingApprovalItem struct {
	Workflow       *model.Workflow `json:"workflow"`
	PipelineNumber int64           `json:"pipeline_number"`
	RepoID         int64           `json:"repo_id"`
	RepoFullName   string          `json:"repo_full_name"`
}

type PostAccessTokenInput struct {
	Body CreateAccessTokenRequest
}

type PostAccessTokenOutput struct {
	Body AccessTokenResponse
}

type PostAdminTestSMTPInput struct{}

type PostAdminTestSMTPOutput struct {
	Body struct {
		Success bool   `json:"success"`
		Message string `json:"message"`
	}
}

type PostAgentBody struct {
	Name         string            `json:"name" minLength:"1" doc:"name of the agent"`
	NoSchedule   bool              `json:"no_schedule,omitempty" doc:"disable scheduling for this agent"`
	Priority     int32             `json:"priority,omitempty" doc:"agent priority"`
	CustomLabels map[string]string `json:"custom_labels,omitempty" doc:"custom labels for the agent"`
}

type PostAgentInput struct {
	Body PostAgentBody
}

type PostAgentOutput struct {
	Body *model.Agent
}

type PostApprovalAlwaysInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Number int64 `path:"number" doc:"the number of the pipeline"`
}

type PostApprovalAlwaysOutput struct {
	Body *model.Pipeline
}

type PostApprovalInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Number int64 `path:"number" doc:"the number of the pipeline"`
}

type PostApprovalOutput struct {
	Body *model.Pipeline
}

type PostAutoscalerBody struct {
	Name string `json:"name" minLength:"1" doc:"name of the autoscaler"`
}

type PostAutoscalerHeartbeatInput struct {
	AutoscalerID int64 `path:"autoscaler_id" doc:"the autoscaler's id"`
	Body         HeartbeatBody
}

type PostAutoscalerHeartbeatOutput struct {
	Body HeartbeatResponse
}

type PostAutoscalerInput struct {
	Body PostAutoscalerBody
}

type PostAutoscalerOutput struct {
	Body *model.AutoscalerWithToken
}

type PostAutoscalerTokenInput struct {
	AutoscalerID int64 `path:"autoscaler_id" doc:"the autoscaler's id"`
}

type PostAutoscalerTokenOutput struct {
	Body TokenResponse
}

type PostCronBody struct {
	Name     string `json:"name" minLength:"1" doc:"cron job name"`
	Schedule string `json:"schedule" minLength:"1" doc:"cron schedule expression"`
	Branch   string `json:"branch,omitempty" doc:"branch to run cron on"`
}

type PostCronInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Body   PostCronBody
}

type PostCronOutput struct {
	Body *model.Cron
}

type PostDeclineInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Number int64 `path:"number" doc:"the number of the pipeline"`
}

type PostDeclineOutput struct {
	Body *model.Pipeline
}

type PostForgeInput struct {
	Body ForgeBody
}

type PostForgeOutput struct {
	Body *model.Forge
}

type PostGlobalRegistryInput struct {
	Body PostRegistryBody
}

type PostGlobalRegistryOutput struct {
	Body *model.Registry
}

type PostGlobalSecretInput struct {
	Body PostSecretBody
}

type PostGlobalSecretOutput struct {
	Body *model.Secret
}

type PostIntegrationBody struct {
	Name           string                `json:"name" minLength:"1" doc:"integration name"`
	Type           model.IntegrationType `json:"type" doc:"integration type"`
	Description    string                `json:"description,omitempty" doc:"integration description"`
	Config         string                `json:"config,omitempty" doc:"integration configuration"`
	AllowedUserIDs []int64               `json:"allowed_user_ids,omitempty" doc:"allowed user IDs"`
	AllowedOrgIDs  []int64               `json:"allowed_org_ids,omitempty" doc:"allowed org IDs"`
	AllowedRepoIDs []int64               `json:"allowed_repo_ids,omitempty" doc:"allowed repo IDs"`
}

type PostIntegrationInput struct {
	Body PostIntegrationBody
}

type PostIntegrationOutput struct {
	Body *model.Integration
}

type PostOrgAgentInput struct {
	OrgID int64 `path:"org_id" doc:"the organization's id"`
	Body  PostAgentBody
}

type PostOrgRegistryInput struct {
	OrgID int64 `path:"org_id" doc:"the org's id"`
	Body  PostRegistryBody
}

type PostOrgRegistryOutput struct {
	Body *model.Registry
}

type PostOrgSecretInput struct {
	OrgID int64 `path:"org_id" doc:"the org's id"`
	Body  PostSecretBody
}

type PostOrgSecretOutput struct {
	Body *model.Secret
}

type PostPipelineInput struct {
	RepoID     int64  `path:"repo_id" doc:"the repository id"`
	Number     int64  `path:"number" doc:"the number of the pipeline"`
	Event      string `query:"event" doc:"override the event type"`
	DeployTo   string `query:"deploy_to" doc:"override the target deploy value"`
	DeployTask string `query:"deploy_task" doc:"override the deploy task"`
}

type PostPipelineOutput struct {
	Body *model.Pipeline
}

type PostRegistryBody struct {
	Address  string `json:"address" minLength:"1" doc:"registry address"`
	Username string `json:"username" minLength:"1" doc:"registry username"`
	Password string `json:"password" minLength:"1" doc:"registry password"`
}

type PostRegistryInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Body   PostRegistryBody
}

type PostRegistryOutput struct {
	Body *model.Registry
}

type PostRepoInput struct {
	ForgeRemoteID string `query:"forge_remote_id" doc:"the id of a repository at the forge"`
	ForgeID       int64  `query:"forge_id" doc:"the forge id (for multi-forge users)"`
}

type PostRepoOutput struct {
	Body *RepoResponse
}

type PostSecretBody struct {
	Name   string               `json:"name" minLength:"1" doc:"secret name"`
	Value  string               `json:"value" minLength:"1" doc:"secret value"`
	Events []model.WebhookEvent `json:"events" doc:"events that trigger the secret"`
	Images []string             `json:"images,omitempty" doc:"container images allowed to use the secret"`
}

type PostSecretInput struct {
	RepoID int64 `path:"repo_id" doc:"the repository id"`
	Body   PostSecretBody
}

type PostSecretOutput struct {
	Body *model.Secret
}