{"components":{"schemas":{"ArchiveSource":{"enum":["manual","cap","auto_prior","dist_watcher","catalog_admin"],"title":"ArchiveSource","type":"string"},"CapApprovalResolve":{"additionalProperties":false,"properties":{"kind":{"const":"cap_approval_resolve","title":"Kind","type":"string"}},"required":["kind"],"title":"CapApprovalResolve","type":"object"},"CatalogArtifact":{"additionalProperties":false,"properties":{"artifact_path":{"title":"Artifact Path","type":"string"},"artifact_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Artifact Url"},"checksum_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checksum Path"},"checksum_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checksum Url"},"classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Classification"},"dated":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Dated"},"downloadable":{"title":"Downloadable","type":"boolean"},"key_fingerprint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Fingerprint"},"managed":{"title":"Managed","type":"boolean"},"sbom_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sbom Path"},"sbom_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sbom Url"},"signature_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature Path"},"signature_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature Url"},"svn_revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Svn Revision"}},"required":["artifact_path","classification","signature_path","checksum_path","sbom_path","key_fingerprint","svn_revision","managed","dated","downloadable","artifact_url","signature_url","checksum_url","sbom_url"],"title":"CatalogArtifact","type":"object"},"CatalogCycle":{"additionalProperties":false,"properties":{"cycle":{"title":"Cycle","type":"string"},"lifecycle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lifecycle"},"versions":{"items":{"$ref":"#/components/schemas/CatalogVersion"},"title":"Versions","type":"array"}},"required":["cycle","lifecycle","versions"],"title":"CatalogCycle","type":"object"},"CatalogDistribution":{"additionalProperties":false,"properties":{"platform":{"title":"Platform","type":"string"},"purl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purl"},"web_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Web Url"}},"required":["platform","purl","web_url"],"title":"CatalogDistribution","type":"object"},"CatalogVersion":{"additionalProperties":false,"properties":{"artifacts":{"items":{"$ref":"#/components/schemas/CatalogArtifact"},"title":"Artifacts","type":"array"},"cle_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Cle Url"},"cycle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cycle"},"distributions":{"default":[],"items":{"$ref":"#/components/schemas/CatalogDistribution"},"title":"Distributions","type":"array"},"managed":{"title":"Managed","type":"boolean"},"purl":{"title":"Purl","type":"string"},"released":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Released"},"status":{"enum":["released","archived"],"title":"Status","type":"string"},"svn_revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Svn Revision"},"version":{"title":"Version","type":"string"},"vote_thread_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Vote Thread Url"}},"required":["version","purl","status","released","svn_revision","managed","cycle","artifacts"],"title":"CatalogVersion","type":"object"},"CheckResult":{"properties":{"cached":{"default":false,"examples":[false],"title":"Cached","type":"boolean"},"checker":{"examples":["atr.tasks.checks.license.files"],"title":"Checker","type":"string"},"checker_version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["2"],"title":"Checker Version"},"created":{"examples":["2025-05-01T01:02:03Z"],"format":"date-time","title":"Created","type":"string"},"data":{"examples":[{"expected":"...","found":"..."}],"title":"Data"},"id":{"default":null,"examples":[123],"title":"Id","type":"integer"},"inputs_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["blake3:7f83b1657ff1fc..."],"title":"Inputs Hash"},"member_rel_path":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["apache-example-0.0.1/pom.xml"],"title":"Member Rel Path"},"message":{"examples":["sha512 matches for apache-example-0.0.1/pom.xml"],"title":"Message","type":"string"},"primary_rel_path":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["apache-example-0.0.1-source.tar.gz"],"title":"Primary Rel Path"},"release_key":{"examples":["example-0.0.1"],"title":"Release Key","type":"string"},"revision_number":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["00005"],"title":"Revision Number"},"status":{"$ref":"#/components/schemas/CheckResultStatus","default":"note","examples":["note"]}},"required":["release_key","checker","created","message","data"],"title":"CheckResult","type":"object"},"CheckResultIgnore":{"properties":{"asf_uid":{"examples":["user"],"title":"Asf Uid","type":"string"},"checker_glob":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["atr.tasks.checks.license.files"],"title":"Checker Glob"},"created":{"examples":["2025-05-01T01:02:03Z"],"format":"date-time","title":"Created","type":"string"},"id":{"default":null,"examples":[123],"title":"Id","type":"integer"},"member_rel_path_glob":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["apache-example-0.0.1/*.xml"],"title":"Member Rel Path Glob"},"message_glob":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["sha512 matches for apache-example-0.0.1/*.xml"],"title":"Message Glob"},"primary_rel_path_glob":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["apache-example-0.0.1-*.tar.gz"],"title":"Primary Rel Path Glob"},"project_key":{"examples":["example"],"title":"Project Key","type":"string"},"release_glob":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["example-0.0.*"],"title":"Release Glob"},"revision_number":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["00001"],"title":"Revision Number"},"status":{"anyOf":[{"$ref":"#/components/schemas/CheckResultStatusIgnore"},{"type":"null"}],"default":null,"examples":["concern"]}},"required":["asf_uid","created","project_key","release_glob","revision_number","checker_glob","primary_rel_path_glob","member_rel_path_glob","message_glob"],"title":"CheckResultIgnore","type":"object"},"CheckResultStatus":{"enum":["blocker","concern","exception","note","suggestion"],"title":"CheckResultStatus","type":"string"},"CheckResultStatusIgnore":{"enum":["concern","exception","suggestion"],"title":"CheckResultStatusIgnore","type":"string"},"Committee":{"properties":{"archived":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"examples":["2026-01-15T01:02:03Z"],"title":"Archived"},"catalog_reviewed":{"default":false,"title":"Catalog Reviewed","type":"boolean"},"charter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["Example"],"title":"Charter"},"committee_members":{"examples":[["sbp","arm","wave"]],"items":{"type":"string"},"title":"Committee Members","type":"array"},"committers":{"examples":[["sbp","arm","wave"]],"items":{"type":"string"},"title":"Committers","type":"array"},"is_archived":{"default":false,"title":"Is Archived","type":"boolean"},"is_podling":{"default":false,"title":"Is Podling","type":"boolean"},"key":{"examples":["example"],"title":"Key","type":"string"},"keys_mode":{"$ref":"#/components/schemas/KeysMode","default":"reflect"},"mail_addresses":{"items":{"type":"string"},"title":"Mail Addresses","type":"array"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["Example"],"title":"Name"},"parent_committee_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Parent Committee Key"},"release_managers":{"examples":[["wave"]],"items":{"type":"string"},"title":"Release Managers","type":"array"},"update_type":{"$ref":"#/components/schemas/UpdateType","default":"manual","examples":["manual"]},"updated":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Updated"},"updated_by":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Updated By"}},"required":["key"],"title":"Committee","type":"object"},"DistributionListEntry":{"additionalProperties":false,"properties":{"api_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Api Url"},"owner_namespace":{"default":"","example":"example","title":"Owner Namespace","type":"string"},"package":{"example":"example","title":"Package","type":"string"},"pending":{"example":false,"title":"Pending","type":"boolean"},"platform":{"example":"ARTIFACT_HUB","title":"Platform","type":"string"},"staging":{"example":false,"title":"Staging","type":"boolean"},"upload_date":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Upload Date"},"version":{"example":"0.0.1","title":"Version","type":"string"},"web_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Web Url"}},"required":["platform","package","version","staging","pending"],"title":"DistributionListEntry","type":"object"},"DistributionPlatform":{"enum":[{"default_owner_namespace":null,"gh_slug":"artifacthub","name":"Artifact Hub","requires_owner_namespace":true,"template_staging_url":"https://staging.artifacthub.io/api/v1/packages/helm/{owner_namespace}/{package}/{version}","template_url":"https://artifacthub.io/api/v1/packages/helm/{owner_namespace}/{package}/{version}"},{"default_owner_namespace":"library","gh_slug":"dockerhub","name":"Docker Hub","requires_owner_namespace":false,"template_staging_url":null,"template_url":"https://hub.docker.com/v2/namespaces/{owner_namespace}/repositories/{package}/tags/{version}"},{"default_owner_namespace":null,"gh_slug":"mavencentral","name":"Maven Central","requires_owner_namespace":true,"template_staging_url":"https://repository.apache.org/content/groups/staging/{owner_namespace}/{package}/maven-metadata.xml","template_url":"https://repo1.maven.org/maven2/{owner_namespace}/{package}/maven-metadata.xml"},{"default_owner_namespace":null,"gh_slug":"npm","name":"npm","requires_owner_namespace":false,"template_staging_url":null,"template_url":"https://registry.npmjs.org/{package}"},{"default_owner_namespace":null,"gh_slug":"npm","name":"npm (scoped)","requires_owner_namespace":true,"template_staging_url":null,"template_url":"https://registry.npmjs.org/@{owner_namespace}/{package}"},{"default_owner_namespace":null,"gh_slug":"pypi","name":"PyPI","requires_owner_namespace":false,"template_staging_url":"https://test.pypi.org/pypi/{package}/{version}/json","template_url":"https://pypi.org/pypi/{package}/{version}/json"}],"title":"DistributionPlatform"},"DistributionStatusCheck":{"additionalProperties":false,"description":"Result of the task to check pending distribution statuses.","properties":{"kind":{"const":"distribution_status","title":"Kind","type":"string"}},"required":["kind"],"title":"DistributionStatusCheck","type":"object"},"DistributionWorkflow":{"additionalProperties":false,"description":"Result of the task to run a Github workflow.","properties":{"kind":{"const":"distribution_workflow","title":"Kind","type":"string"},"name":{"description":"The name of the action being performed","title":"Name","type":"string"},"run_id":{"description":"The ID of the workflow run","title":"Run Id","type":"integer"},"url":{"description":"The URL of the workflow run","title":"Url","type":"string"}},"required":["kind","name","run_id","url"],"title":"DistributionWorkflow","type":"object"},"DistributionWorkflowStatus":{"additionalProperties":false,"description":"Result of the task to update Github workflow statuses.","properties":{"kind":{"const":"distribution_workflow_status","title":"Kind","type":"string"}},"required":["kind"],"title":"DistributionWorkflowStatus","type":"object"},"DownloadsCheck":{"additionalProperties":false,"properties":{"available":{"default":false,"title":"Available","type":"boolean"},"cursor":{"default":0,"title":"Cursor","type":"integer"},"kind":{"const":"downloads_check","default":"downloads_check","title":"Kind","type":"string"},"message":{"default":"Waiting for downloads to become available.","title":"Message","type":"string"},"total":{"default":0,"title":"Total","type":"integer"},"waiting_for":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Waiting For"}},"title":"DownloadsCheck","type":"object"},"HashingCheck":{"additionalProperties":false,"description":"Result of the task to check the hash of a file.","properties":{"hash_algorithm":{"description":"The hash algorithm used","title":"Hash Algorithm","type":"string"},"hash_file_path":{"description":"The path to the hash file","title":"Hash File Path","type":"string"},"hash_value":{"description":"The hash value of the file","title":"Hash Value","type":"string"},"kind":{"const":"hashing_check","title":"Kind","type":"string"}},"required":["kind","hash_algorithm","hash_value","hash_file_path"],"title":"HashingCheck","type":"object"},"KeysMode":{"enum":["automatic","manual","reflect"],"title":"KeysMode","type":"string"},"KeysUploadException":{"additionalProperties":false,"properties":{"error":{"example":"Error message","title":"Error","type":"string"},"error_type":{"example":"KeysUploadError","title":"Error Type","type":"string"},"key":{"anyOf":[{"$ref":"#/components/schemas/SigningCertificate"},{"type":"null"}]},"status":{"const":"error","title":"Status","type":"string"}},"required":["status","key","error","error_type"],"title":"KeysUploadException","type":"object"},"KeysUploadResult":{"additionalProperties":false,"properties":{"key":{"$ref":"#/components/schemas/SigningCertificate"},"status":{"const":"success","title":"Status","type":"string"}},"required":["status","key"],"title":"KeysUploadResult","type":"object"},"LicenseCheckMode":{"enum":["Both","Lightweight","RAT"],"title":"LicenseCheckMode","type":"string"},"Maintenance":{"additionalProperties":false,"description":"Result of the task to run scheduled maintenance.","properties":{"kind":{"const":"maintenance","title":"Kind","type":"string"}},"required":["kind"],"title":"Maintenance","type":"object"},"MessageSend":{"additionalProperties":false,"description":"Result of the task to send an email.","properties":{"kind":{"const":"message_send","title":"Kind","type":"string"},"mail_send_warnings":{"description":"Warnings from the mail server","items":{"type":"string"},"title":"Mail Send Warnings","type":"array"},"mid":{"description":"The message ID of the email","title":"Mid","type":"string"}},"required":["kind","mid","mail_send_warnings"],"title":"MessageSend","type":"object"},"MetadataUpdate":{"additionalProperties":false,"description":"Result of the task to update metadata from Whimsy.","properties":{"added_count":{"description":"Number of committees and projects added","title":"Added Count","type":"integer"},"kind":{"const":"metadata_update","title":"Kind","type":"string"},"updated_count":{"description":"Number of committees and projects updated","title":"Updated Count","type":"integer"}},"required":["kind","added_count","updated_count"],"title":"MetadataUpdate","type":"object"},"OSVComponent":{"additionalProperties":false,"properties":{"purl":{"description":"Package URL","title":"Purl","type":"string"},"vulnerabilities":{"description":"Vulnerabilities found","items":{"$ref":"#/components/schemas/VulnerabilityDetails"},"title":"Vulnerabilities","type":"array"}},"required":["purl","vulnerabilities"],"title":"OSVComponent","type":"object"},"OptionalCommitHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"OptionalRelPath":{"anyOf":[{"type":"string"},{"type":"null"}]},"Project":{"properties":{"branch_template":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["release-{cycle}"],"title":"Branch Template"},"bug_database":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["https://issues.apache.org/jira/browse/EXAMPLE"],"title":"Bug Database"},"calver_format":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["(YY.MM).N"],"title":"Calver Format"},"categories":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["data,storage"],"title":"Categories"},"committee_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["example"],"title":"Committee Key"},"created":{"examples":["2025-05-01T01:02:03Z"],"format":"date-time","title":"Created","type":"string"},"created_by":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["user"],"title":"Created By"},"cycle_match":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["^(\\d+)\\.\\d+\\.\\d+$"],"title":"Cycle Match"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["Example is a simple example project"],"title":"Description"},"download_page":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["https://example.apache.org/download"],"title":"Download Page"},"homepage":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["https://example.apache.org/"],"title":"Homepage"},"key":{"examples":["example"],"title":"Key","type":"string"},"lifecycle_page":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["https://example.apache.org/lifecycle"],"title":"Lifecycle Page"},"mailing_lists":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["https://example.apache.org/community/mailing-lists"],"title":"Mailing Lists"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["Apache Example"],"title":"Name"},"programming_languages":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["c,python"],"title":"Programming Languages"},"quota_project_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"examples":[53687091200],"title":"Quota Project Bytes"},"quota_project_releases":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"examples":[20],"title":"Quota Project Releases"},"quota_release_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"examples":[53687091200],"title":"Quota Release Bytes"},"quota_release_files":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"examples":[10000],"title":"Quota Release Files"},"release_policy_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Release Policy Id"},"repositories":{"items":{"type":"string"},"title":"Repositories","type":"array"},"security_contact":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["security@example.apache.org"],"title":"Security Contact"},"short_description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["A simple example project"],"title":"Short Description"},"standards":{"items":{"type":"string"},"title":"Standards","type":"array"},"status":{"$ref":"#/components/schemas/ProjectStatus","default":"active","examples":["active"]},"super_project_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Super Project Key"},"threat_model_link":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["https://example.apache.org/security/threat-model"],"title":"Threat Model Link"},"threat_model_src_link":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["https://example.apache.org/security/threat-model.md"],"title":"Threat Model Src Link"},"update_type":{"$ref":"#/components/schemas/UpdateType","default":"manual","examples":["manual"]},"updated":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Updated"},"updated_by":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Updated By"},"version_method":{"$ref":"#/components/schemas/VersionMethod","default":"simple","examples":["simple"]},"version_pattern":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["^\\d+\\.\\d+\\.\\d+$"],"title":"Version Pattern"}},"required":["key"],"title":"Project","type":"object"},"ProjectConfigPolicyArgs":{"additionalProperties":false,"properties":{"announce_recipients":{"anyOf":[{"$ref":"#/components/schemas/RecipientDefaults"},{"type":"null"}],"default":null},"announce_release_subject":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Announce Release Subject"},"announce_release_template":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Announce Release Template"},"announce_release_template_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Announce Release Template Url"},"auto_archive_prior_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Auto Archive Prior Release"},"binary_artifact_paths":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Binary Artifact Paths"},"download_path_suffix":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Download Path Suffix"},"file_tag_mappings":{"anyOf":[{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object"},{"type":"null"}],"default":null,"title":"File Tag Mappings"},"finish_vote_template":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Finish Vote Template"},"finish_vote_template_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Finish Vote Template Url"},"license_check_mode":{"anyOf":[{"$ref":"#/components/schemas/LicenseCheckMode"},{"type":"null"}],"default":null},"min_hours":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Min Hours"},"rat_excludes_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Rat Excludes Url"},"release_checklist":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Release Checklist"},"require_version_in_filenames":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Require Version In Filenames"},"source_artifact_paths":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Source Artifact Paths"},"source_excludes_lightweight":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Source Excludes Lightweight"},"source_excludes_rat":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Source Excludes Rat"},"start_vote_subject":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Start Vote Subject"},"start_vote_template":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Start Vote Template"},"start_vote_template_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Start Vote Template Url"},"vote_comment_template":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Vote Comment Template"},"vote_comment_template_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Vote Comment Template Url"},"vote_mode":{"anyOf":[{"$ref":"#/components/schemas/VoteMode"},{"type":"null"}],"default":null},"vote_recipients":{"anyOf":[{"$ref":"#/components/schemas/RecipientDefaults"},{"type":"null"}],"default":null}},"title":"ProjectConfigPolicyArgs","type":"object"},"ProjectConfigProjectArgs":{"additionalProperties":false,"properties":{"branch_template":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Branch Template"},"bug_database":{"anyOf":[{"format":"uri","maxLength":2083,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Bug Database"},"calver_format":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Calver Format"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Categories"},"cycle_match":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Cycle Match"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Description"},"download_page":{"anyOf":[{"format":"uri","maxLength":2083,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Download Page"},"homepage":{"anyOf":[{"format":"uri","maxLength":2083,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Homepage"},"lifecycle_page":{"anyOf":[{"format":"uri","maxLength":2083,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Lifecycle Page"},"mailing_lists":{"anyOf":[{"format":"uri","maxLength":2083,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Mailing Lists"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Full project display name, including the 'Apache ' prefix. Required when creating a project; omit when updating to preserve the current name. The prefix is not added automatically.","example":"Apache Maven Filtering","title":"Name"},"programming_languages":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Programming Languages"},"repositories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Repositories"},"security_contact":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Security Contact"},"short_description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Short Description"},"standards":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Standards"},"threat_model_link":{"anyOf":[{"format":"uri","maxLength":2083,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Threat Model Link"},"threat_model_src_link":{"anyOf":[{"format":"uri","maxLength":2083,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Threat Model Src Link"},"version_method":{"anyOf":[{"$ref":"#/components/schemas/VersionMethod"},{"type":"null"}],"default":null},"version_pattern":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Version Pattern"}},"title":"ProjectConfigProjectArgs","type":"object"},"ProjectStatus":{"enum":["active","dormant","retired","standing"],"title":"ProjectStatus","type":"string"},"RecipientDefaults":{"additionalProperties":false,"properties":{"bcc":{"items":{"format":"email","type":"string"},"title":"Bcc","type":"array"},"cc":{"items":{"format":"email","type":"string"},"title":"Cc","type":"array"},"to":{"anyOf":[{"format":"email","type":"string"},{"type":"null"}],"default":null,"title":"To"}},"title":"RecipientDefaults","type":"object"},"Release":{"properties":{"activity_at":{"examples":["2025-05-01T01:02:03Z"],"format":"date-time","title":"Activity At","type":"string"},"archive_prior_release":{"default":false,"title":"Archive Prior Release","type":"boolean"},"archive_source":{"anyOf":[{"$ref":"#/components/schemas/ArchiveSource"},{"type":"null"}],"default":null},"archived":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"examples":["2026-01-15T01:02:03Z"],"title":"Archived"},"check_cache_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["ef0ccb0a-3514-4b65-abcd-879850349f74"],"title":"Check Cache Key"},"commit_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b"],"title":"Commit Hash"},"created":{"examples":["2025-05-01T01:02:03Z"],"format":"date-time","title":"Created","type":"string"},"current_vote_seq":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Current Vote Seq"},"cycle_key":{"default":"","examples":["example-default"],"title":"Cycle Key","type":"string"},"download_path_suffix":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["incubator/example/0.0.1"],"title":"Download Path Suffix"},"expedited":{"default":false,"title":"Expedited","type":"boolean"},"inactivity_notice_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Inactivity Notice Key"},"is_archived":{"default":false,"title":"Is Archived","type":"boolean"},"key":{"default":"","examples":["example-0.0.1"],"title":"Key","type":"string"},"latest_revision_number":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Get the latest revision number for the release.","readOnly":true,"title":"Latest Revision Number"},"package_managers":{"examples":[[]],"items":{"type":"string"},"title":"Package Managers","type":"array"},"phase":{"$ref":"#/components/schemas/ReleasePhase","examples":["release_candidate_draft"]},"podling_thread_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["hmk1lpwnnxn5zsbp8gwh7115h2qm7jrh"],"title":"Podling Thread Id"},"project_key":{"examples":["example"],"title":"Project Key","type":"string"},"release_policy_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Release Policy Id"},"released":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"examples":["2025-06-01T01:02:03Z"],"title":"Released"},"sboms":{"examples":[[]],"items":{"type":"string"},"title":"Sboms","type":"array"},"version":{"examples":["0.0.1"],"title":"Version","type":"string"},"vote_mode":{"anyOf":[{"$ref":"#/components/schemas/VoteMode"},{"type":"null"}],"default":null,"examples":["email"]},"vote_resolved":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"examples":["2025-05-07T01:02:03Z"],"title":"Vote Resolved"},"vote_started":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"examples":["2025-05-05T01:02:03Z"],"title":"Vote Started"},"vote_thread_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["https://lists.apache.org/thread/hmk1lpwnnxn5zsbp8gwh7115h2qm7jrh"],"title":"Vote Thread Url"},"voted_revision_number":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["00001"],"title":"Voted Revision Number"}},"required":["phase","created","project_key","version","latest_revision_number"],"title":"Release","type":"object"},"ReleaseFinalise":{"additionalProperties":false,"properties":{"audit_events":{"description":"The number of audit log events recorded for the release","title":"Audit Events","type":"integer"},"kind":{"const":"release_finalise","title":"Kind","type":"string"},"message":{"description":"A short status message describing the finalisation outcome","title":"Message","type":"string"}},"required":["kind","audit_events","message"],"title":"ReleaseFinalise","type":"object"},"ReleaseManifestFile":{"additionalProperties":false,"properties":{"digest":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"SHA3-256 digest prefixed with sha3-256:, or null when not recorded.","title":"Digest"},"path":{"title":"Path","type":"string"},"size":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"File size in bytes, or null when unavailable in the retained manifest.","title":"Size"},"swhid_dir_inner":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"SWHID of the archive's extracted inner directory, or null when not recorded.","title":"Swhid Dir Inner"}},"required":["path","size","digest","swhid_dir_inner"],"title":"ReleaseManifestFile","type":"object"},"ReleasePhase":{"enum":["release_candidate_draft","release_candidate","release_preview","release"],"title":"ReleasePhase","type":"string"},"Revision":{"properties":{"asfuid":{"examples":["user"],"title":"Asfuid","type":"string"},"created":{"examples":["2025-05-01T01:02:03Z"],"format":"date-time","title":"Created","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["This is a description"],"title":"Description"},"key":{"default":"","examples":["example-0.0.1 00002"],"title":"Key","type":"string"},"merge_base_revision_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["example-0.0.1 00001"],"title":"Merge Base Revision Key"},"number":{"default":"","examples":["00002"],"title":"Number","type":"string"},"parent_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["example-0.0.1 00001"],"title":"Parent Key"},"phase":{"$ref":"#/components/schemas/ReleasePhase","examples":["release_candidate_draft"]},"release_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["example-0.0.1"],"title":"Release Key"},"seq":{"default":0,"examples":[1],"title":"Seq","type":"integer"},"tag":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["rc1"],"title":"Tag"},"was_quarantined":{"default":false,"examples":[false],"title":"Was Quarantined","type":"boolean"}},"required":["asfuid","phase"],"title":"Revision","type":"object"},"SBOMAugment":{"additionalProperties":false,"properties":{"bom_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"BOM Version produced by the augment task, if any augmentations were applied","title":"Bom Version"},"kind":{"const":"sbom_augment","title":"Kind","type":"string"},"path":{"description":"The path to the augmented SBOM file","title":"Path","type":"string"}},"required":["kind","path"],"title":"SBOMAugment","type":"object"},"SBOMConvert":{"additionalProperties":false,"properties":{"bom_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"BOM Version produced by the convert task","title":"Bom Version"},"kind":{"const":"sbom_convert","title":"Kind","type":"string"},"path":{"description":"The path to the converted SBOM file","title":"Path","type":"string"}},"required":["kind","path"],"title":"SBOMConvert","type":"object"},"SBOMGenerate":{"additionalProperties":false,"properties":{"bom_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"BOM Version produced by the augmentation, if any augmentations were applied","title":"Bom Version"},"kind":{"const":"sbom_generate","title":"Kind","type":"string"},"path":{"description":"The path to the generated SBOM file, relative to the release directory","title":"Path","type":"string"},"revision_number":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The number of the new revision containing the generated SBOM file","title":"Revision Number"}},"required":["kind","path"],"title":"SBOMGenerate","type":"object"},"SBOMGenerateCycloneDX":{"additionalProperties":false,"description":"Result of the task to generate a CycloneDX SBOM.","properties":{"kind":{"const":"sbom_generate_cyclonedx","title":"Kind","type":"string"},"msg":{"description":"The message from the SBOM generation","title":"Msg","type":"string"}},"required":["kind","msg"],"title":"SBOMGenerateCycloneDX","type":"object"},"SBOMHeatmap":{"additionalProperties":false,"properties":{"analysis_version":{"title":"Analysis Version","type":"integer"},"attribution":{"title":"Attribution","type":"string"},"generated_at":{"title":"Generated At","type":"string"},"kind":{"const":"sbom_heatmap","default":"sbom_heatmap","title":"Kind","type":"string"},"rows":{"items":{"$ref":"#/components/schemas/SBOMHeatmapRow"},"title":"Rows","type":"array"},"sboms":{"items":{"$ref":"#/components/schemas/SBOMHeatmapSbom"},"title":"Sboms","type":"array"},"sources":{"additionalProperties":{"type":"string"},"title":"Sources","type":"object"}},"required":["analysis_version","generated_at","sboms","rows","sources","attribution"],"title":"SBOMHeatmap","type":"object"},"SBOMHeatmapRow":{"additionalProperties":false,"properties":{"active_maintainers":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Active Maintainers"},"advisories":{"items":{"type":"string"},"title":"Advisories","type":"array"},"advisory_status":{"enum":["found","none","version_unknown","unsupported","not_found","failed"],"title":"Advisory Status","type":"string"},"archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Archived"},"artifacts":{"items":{"type":"string"},"title":"Artifacts","type":"array"},"criticality":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Criticality"},"dds":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Dds"},"ecosystem":{"title":"Ecosystem","type":"string"},"governance_files":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Governance Files"},"health":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Health"},"health_inputs":{"default":0,"title":"Health Inputs","type":"integer"},"key":{"title":"Key","type":"string"},"latest_release_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Latest Release At"},"latest_release_version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Latest Release Version"},"maintained":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Maintained"},"name":{"title":"Name","type":"string"},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Published At"},"purl":{"title":"Purl","type":"string"},"rankings_average":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Rankings Average"},"repository_source":{"anyOf":[{"enum":["deps.dev","ecosyste.ms","gitbox_mirror"],"type":"string"},{"type":"null"}],"default":null,"title":"Repository Source"},"repository_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Repository Url"},"risk":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Risk"},"scorecard_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Scorecard Date"},"source_purls":{"items":{"type":"string"},"title":"Source Purls","type":"array"},"source_repo":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Repo"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"}},"required":["key","purl","source_purls","name","ecosystem","version","artifacts","advisory_status"],"title":"SBOMHeatmapRow","type":"object"},"SBOMHeatmapSbom":{"additionalProperties":false,"properties":{"artifact_path":{"title":"Artifact Path","type":"string"},"components":{"default":0,"title":"Components","type":"integer"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error"},"files":{"default":0,"title":"Files","type":"integer"},"packages":{"default":0,"title":"Packages","type":"integer"},"retrieved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Retrieved At"},"sbom_url":{"title":"Sbom Url","type":"string"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Sha256"}},"required":["artifact_path","sbom_url"],"title":"SBOMHeatmapSbom","type":"object"},"SBOMOSVScan":{"additionalProperties":false,"properties":{"bom_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"BOM Version produced with scan results","title":"Bom Version"},"components":{"description":"Components with vulnerabilities","items":{"$ref":"#/components/schemas/OSVComponent"},"title":"Components","type":"array"},"file_path":{"description":"Absolute path to the scanned SBOM file","title":"File Path","type":"string"},"ignored":{"description":"Components ignored","items":{"type":"string"},"title":"Ignored","type":"array"},"kind":{"const":"sbom_osv_scan","title":"Kind","type":"string"},"new_file_path":{"default":"","description":"Absolute path to the updated SBOM file","title":"New File Path","type":"string"},"project_key":{"description":"Project name","title":"Project Key","type":"string"},"revision_number":{"description":"Revision number","title":"Revision Number","type":"string"},"version_key":{"description":"Version name","title":"Version Key","type":"string"}},"required":["kind","project_key","version_key","revision_number","file_path","components","ignored"],"title":"SBOMOSVScan","type":"object"},"SBOMQsScore":{"additionalProperties":false,"properties":{"file_path":{"description":"Relative path to the scored SBOM file","title":"File Path","type":"string"},"kind":{"const":"sbom_qs_score","title":"Kind","type":"string"},"project_key":{"description":"Project name","title":"Project Key","type":"string"},"report":{"$ref":"#/components/schemas/SbomQsReport"},"revision_number":{"description":"Revision number","title":"Revision Number","type":"string"},"version_key":{"description":"Version name","title":"Version Key","type":"string"}},"required":["kind","project_key","version_key","revision_number","file_path","report"],"title":"SBOMQsScore","type":"object"},"SBOMToolScore":{"additionalProperties":false,"properties":{"atr_props":{"anyOf":[{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array"},{"type":"null"}],"default":null,"description":"ATR properties found in the SBOM","title":"Atr Props"},"bom_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"BOM Version scanned","title":"Bom Version"},"cli_errors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Errors from the CycloneDX CLI","title":"Cli Errors"},"errors":{"description":"Errors from the SBOM tool","items":{"type":"string"},"title":"Errors","type":"array"},"file_path":{"description":"Relative path to the scored SBOM file","title":"File Path","type":"string"},"kind":{"const":"sbom_tool_score","title":"Kind","type":"string"},"license_errors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":[],"description":"License errors found in the SBOM","title":"License Errors"},"license_warnings":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":[],"description":"License warnings found in the SBOM","title":"License Warnings"},"outdated":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"description":"Outdated tool(s) from the SBOM tool","title":"Outdated"},"prev_bom_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"BOM Version from previous release","title":"Prev Bom Version"},"prev_licenses":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Licenses from previous release","title":"Prev Licenses"},"prev_vulnerabilities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Vulnerabilities from previous release","title":"Prev Vulnerabilities"},"project_key":{"description":"Project name","title":"Project Key","type":"string"},"revision_number":{"description":"Revision number","title":"Revision Number","type":"string"},"version_key":{"description":"Version name","title":"Version Key","type":"string"},"vulnerabilities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Vulnerabilities found in the SBOM","title":"Vulnerabilities"},"warnings":{"description":"Warnings from the SBOM tool","items":{"type":"string"},"title":"Warnings","type":"array"}},"required":["kind","project_key","version_key","revision_number","file_path","warnings","errors","outdated","cli_errors"],"title":"SBOMToolScore","type":"object"},"SbomQsCreationInfo":{"additionalProperties":false,"properties":{"name":{"title":"Name","type":"string"},"scoring_engine_version":{"title":"Scoring Engine Version","type":"string"},"vendor":{"title":"Vendor","type":"string"},"version":{"title":"Version","type":"string"}},"required":["name","version","scoring_engine_version","vendor"],"title":"SbomQsCreationInfo","type":"object"},"SbomQsFile":{"additionalProperties":false,"properties":{"avg_score":{"anyOf":[{"type":"number"},{"type":"integer"}],"title":"Avg Score"},"creation_time":{"title":"Creation Time","type":"string"},"file_format":{"title":"File Format","type":"string"},"file_name":{"title":"File Name","type":"string"},"gen_tool_name":{"title":"Gen Tool Name","type":"string"},"gen_tool_version":{"title":"Gen Tool Version","type":"string"},"num_components":{"title":"Num Components","type":"integer"},"scores":{"items":{"$ref":"#/components/schemas/SbomQsScore"},"title":"Scores","type":"array"},"spec":{"title":"Spec","type":"string"},"spec_version":{"title":"Spec Version","type":"string"}},"required":["file_name","spec","spec_version","file_format","avg_score","num_components","creation_time","gen_tool_name","gen_tool_version","scores"],"title":"SbomQsFile","type":"object"},"SbomQsReport":{"additionalProperties":false,"properties":{"creation_info":{"$ref":"#/components/schemas/SbomQsCreationInfo"},"files":{"items":{"$ref":"#/components/schemas/SbomQsFile"},"title":"Files","type":"array"},"run_id":{"title":"Run Id","type":"string"},"timestamp":{"title":"Timestamp","type":"string"}},"required":["run_id","timestamp","creation_info","files"],"title":"SbomQsReport","type":"object"},"SbomQsScore":{"additionalProperties":false,"properties":{"category":{"title":"Category","type":"string"},"description":{"title":"Description","type":"string"},"feature":{"title":"Feature","type":"string"},"ignored":{"title":"Ignored","type":"boolean"},"max_score":{"anyOf":[{"type":"number"},{"type":"integer"}],"title":"Max Score"},"score":{"anyOf":[{"type":"number"},{"type":"integer"}],"title":"Score"}},"required":["category","feature","score","max_score","description","ignored"],"title":"SbomQsScore","type":"object"},"SignatureProvenanceKey":{"additionalProperties":false,"properties":{"committee":{"example":"example","title":"Committee","type":"string"}},"required":["committee"],"title":"SignatureProvenanceKey","type":"object"},"SigningCertificate":{"properties":{"apache_uid":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["user"],"title":"Apache Uid"},"ascii_armored_key":{"examples":["-----BEGIN PGP PUBLIC KEY BLOCK-----\n\n...\n-----END PGP PUBLIC KEY BLOCK-----\n"],"title":"Ascii Armored Key","type":"string"},"deleted":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Deleted"},"fingerprint":{"examples":["0123456789abcdef0123456789abcdef01234567"],"title":"Fingerprint","type":"string"},"historic_use":{"default":false,"title":"Historic Use","type":"boolean"},"latest_self_signature":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Latest Self Signature"},"primary_declared_uid":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["User <user@example.org>"],"title":"Primary Declared Uid"},"secondary_declared_uids":{"examples":[["User <user@example.net>"]],"items":{"type":"string"},"title":"Secondary Declared Uids","type":"array"}},"required":["fingerprint","primary_declared_uid","apache_uid","ascii_armored_key"],"title":"SigningCertificate","type":"object"},"SourceDeclaration":{"additionalProperties":false,"properties":{"commit":{"example":"0123456789abcdef0123456789abcdef01234567","title":"Commit","type":"string"},"relpath":{"example":"example-0.0.1-src.tar.gz","title":"Relpath","type":"string"},"repository":{"example":"apache/example","title":"Repository","type":"string"}},"required":["relpath","repository","commit"],"title":"SourceDeclaration","type":"object"},"SvnImportFiles":{"additionalProperties":false,"description":"Result of the task to import files from SVN.","properties":{"kind":{"const":"svn_import","title":"Kind","type":"string"},"msg":{"description":"The message from the SVN import","title":"Msg","type":"string"}},"required":["kind","msg"],"title":"SvnImportFiles","type":"object"},"SvnPublish":{"additionalProperties":false,"description":"Result of the task to publish a release preview to SVN.","properties":{"kind":{"const":"svn_publish","title":"Kind","type":"string"},"message":{"description":"A short status message describing the publish outcome","title":"Message","type":"string"},"svn_revision":{"description":"The SVN revision number that the publish landed in","title":"Svn Revision","type":"integer"}},"required":["kind","svn_revision","message"],"title":"SvnPublish","type":"object"},"SvnUnpublish":{"additionalProperties":false,"description":"Result of the task to remove an archived release from the SVN dist area.","properties":{"kind":{"const":"svn_unpublish","title":"Kind","type":"string"},"leftover":{"items":{"type":"string"},"title":"Leftover","type":"array"},"message":{"description":"A short status message describing the removal outcome","title":"Message","type":"string"},"svn_revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The SVN revision the removal landed in, or None if nothing remained","title":"Svn Revision"}},"required":["kind","svn_revision","message"],"title":"SvnUnpublish","type":"object"},"Task":{"description":"A task in the task queue.","properties":{"added":{"format":"date-time","title":"Added","type":"string"},"asf_uid":{"title":"Asf Uid","type":"string"},"completed":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error"},"id":{"default":null,"title":"Id","type":"integer"},"inputs_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["blake3:7f83b1657ff1fc..."],"title":"Inputs Hash"},"pid":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Pid"},"pid_created":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Pid Created"},"primary_rel_path":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Primary Rel Path"},"project_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Project Key"},"result":{"anyOf":[{"discriminator":{"mapping":{"cap_approval_resolve":"#/components/schemas/CapApprovalResolve","distribution_status":"#/components/schemas/DistributionStatusCheck","distribution_workflow":"#/components/schemas/DistributionWorkflow","distribution_workflow_status":"#/components/schemas/DistributionWorkflowStatus","downloads_check":"#/components/schemas/DownloadsCheck","hashing_check":"#/components/schemas/HashingCheck","maintenance":"#/components/schemas/Maintenance","message_send":"#/components/schemas/MessageSend","metadata_update":"#/components/schemas/MetadataUpdate","release_finalise":"#/components/schemas/ReleaseFinalise","sbom_augment":"#/components/schemas/SBOMAugment","sbom_convert":"#/components/schemas/SBOMConvert","sbom_generate":"#/components/schemas/SBOMGenerate","sbom_generate_cyclonedx":"#/components/schemas/SBOMGenerateCycloneDX","sbom_heatmap":"#/components/schemas/SBOMHeatmap","sbom_osv_scan":"#/components/schemas/SBOMOSVScan","sbom_qs_score":"#/components/schemas/SBOMQsScore","sbom_tool_score":"#/components/schemas/SBOMToolScore","svn_import":"#/components/schemas/SvnImportFiles","svn_publish":"#/components/schemas/SvnPublish","svn_unpublish":"#/components/schemas/SvnUnpublish","vote_auto_resolve":"#/components/schemas/VoteAutoResolve","vote_end_notify":"#/components/schemas/VoteEndNotify","vote_initiate":"#/components/schemas/VoteInitiate"},"propertyName":"kind"},"oneOf":[{"$ref":"#/components/schemas/CapApprovalResolve"},{"$ref":"#/components/schemas/DistributionStatusCheck"},{"$ref":"#/components/schemas/DistributionWorkflow"},{"$ref":"#/components/schemas/DistributionWorkflowStatus"},{"$ref":"#/components/schemas/DownloadsCheck"},{"$ref":"#/components/schemas/HashingCheck"},{"$ref":"#/components/schemas/Maintenance"},{"$ref":"#/components/schemas/MessageSend"},{"$ref":"#/components/schemas/MetadataUpdate"},{"$ref":"#/components/schemas/ReleaseFinalise"},{"$ref":"#/components/schemas/SBOMAugment"},{"$ref":"#/components/schemas/SBOMConvert"},{"$ref":"#/components/schemas/SBOMGenerate"},{"$ref":"#/components/schemas/SBOMGenerateCycloneDX"},{"$ref":"#/components/schemas/SBOMHeatmap"},{"$ref":"#/components/schemas/SBOMOSVScan"},{"$ref":"#/components/schemas/SBOMQsScore"},{"$ref":"#/components/schemas/SBOMToolScore"},{"$ref":"#/components/schemas/SvnImportFiles"},{"$ref":"#/components/schemas/SvnPublish"},{"$ref":"#/components/schemas/SvnUnpublish"},{"$ref":"#/components/schemas/VoteAutoResolve"},{"$ref":"#/components/schemas/VoteEndNotify"},{"$ref":"#/components/schemas/VoteInitiate"}]},{"type":"null"}],"default":null,"title":"Result"},"revision_number":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Revision Number"},"scheduled":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Scheduled"},"started":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Started"},"status":{"$ref":"#/components/schemas/TaskStatus","default":"queued"},"task_args":{"title":"Task Args"},"task_type":{"$ref":"#/components/schemas/TaskType"},"version_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Version Key"}},"required":["task_type","task_args","asf_uid"],"title":"Task","type":"object"},"TaskStatus":{"description":"Status of a task in the task queue.","enum":["queued","active","completed","failed","broken"],"title":"TaskStatus","type":"string"},"TaskType":{"enum":["archive_comparison","audit_seal","cap_approval_resolve","catalog_site_generate","compare_source_trees","distribution_status","distribution_workflow","downloads_check","gate_decision","has_sbom","hashing_check","integrity_check","keys_import_file","license_files","license_headers","maintenance","message_send","metadata_update","paths_check","protection_check","quarantine_validate","rat_check","release_finalise","sbom_augment","sbom_convert","sbom_generate","sbom_generate_cyclonedx","sbom_heatmap","sbom_osv_scan","sbom_qs_score","sbom_review","sbom_tool_score","signature_check","svn_import_files","svn_publish","svn_unpublish","sync_keys_from_svn","targz_integrity","targz_structure","vote_auto_resolve","vote_end_notify","vote_initiate","workflow_status","zipformat_integrity","zipformat_structure"],"title":"TaskType","type":"string"},"TrustedBallotEntry":{"additionalProperties":false,"properties":{"cast_at":{"example":"2025-05-01T12:00:00Z","format":"date-time","title":"Cast At","type":"string"},"choice":{"$ref":"#/components/schemas/VoteChoice","example":"+1"},"comment":{"default":"","example":"Looks good to me","title":"Comment","type":"string"},"is_binding":{"example":true,"title":"Is Binding","type":"boolean"},"is_carried":{"default":false,"example":false,"title":"Is Carried","type":"boolean"},"receipt_message_id":{"example":"102ed8a-503db792-79bc789-b8ca87ce@apache.org","title":"Receipt Message Id","type":"string"},"revision_number_at_cast":{"example":"00005","title":"Revision Number At Cast","type":"string"},"vote_round":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"example":1,"title":"Vote Round"},"voter_asf_uid":{"example":"user","title":"Voter Asf Uid","type":"string"},"voter_fullname":{"example":"Example User","title":"Voter Fullname","type":"string"}},"required":["voter_asf_uid","voter_fullname","choice","is_binding","revision_number_at_cast","receipt_message_id","cast_at"],"title":"TrustedBallotEntry","type":"object"},"TrustedVoteSummary":{"additionalProperties":false,"properties":{"binding_votes_abstain":{"example":0,"title":"Binding Votes Abstain","type":"integer"},"binding_votes_no":{"example":0,"title":"Binding Votes No","type":"integer"},"binding_votes_yes":{"example":3,"title":"Binding Votes Yes","type":"integer"},"non_binding_votes_abstain":{"example":0,"title":"Non Binding Votes Abstain","type":"integer"},"non_binding_votes_no":{"example":0,"title":"Non Binding Votes No","type":"integer"},"non_binding_votes_yes":{"example":1,"title":"Non Binding Votes Yes","type":"integer"}},"required":["binding_votes_yes","binding_votes_no","binding_votes_abstain","non_binding_votes_yes","non_binding_votes_no","non_binding_votes_abstain"],"title":"TrustedVoteSummary","type":"object"},"TrustedWorkflowPhase":{"enum":["compose","vote","finish"],"type":"string"},"UpdateType":{"enum":["manual","bootstrap","asfyaml","asfyaml_full"],"title":"UpdateType","type":"string"},"VersionMethod":{"enum":["simple","semver","calver"],"title":"VersionMethod","type":"string"},"Vote":{"enum":["Yes","No","-","?"],"title":"Vote","type":"string"},"VoteAutoResolve":{"additionalProperties":false,"description":"Result of the task to automatically resolve a vote.","properties":{"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Writer error message","title":"Error Message"},"kind":{"const":"vote_auto_resolve","title":"Kind","type":"string"},"resolved":{"description":"Whether the vote was actually resolved by this task","title":"Resolved","type":"boolean"},"skip_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The reason why the resolution was skipped","title":"Skip Reason"},"success_message":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Writer success message","title":"Success Message"},"vote_result":{"anyOf":[{"enum":["passed","failed"],"type":"string"},{"type":"null"}],"description":"The decision posted","title":"Vote Result"}},"required":["kind","resolved","vote_result","skip_reason","success_message","error_message"],"title":"VoteAutoResolve","type":"object"},"VoteChoice":{"enum":["+1","0","-1"],"title":"VoteChoice","type":"string"},"VoteDetails":{"additionalProperties":false,"properties":{"outcome":{"example":"The vote passed.","title":"Outcome","type":"string"},"passed":{"example":true,"title":"Passed","type":"boolean"},"start_unixtime":{"anyOf":[{"type":"integer"},{"type":"null"}],"example":1714435200,"title":"Start Unixtime"},"summary":{"additionalProperties":{"type":"integer"},"example":{"user":1},"title":"Summary","type":"object"},"votes":{"additionalProperties":{"$ref":"#/components/schemas/VoteEmail"},"example":{"user":{"asf_eid":"102ed8a-503db792-79bc789-b8ca87ce@apache.org","asf_uid_or_email":"user","from_email":"user@example.org","iso_datetime":"2025-05-01T12:00:00Z","name":"Example User","quotation":"+1 (Binding)","status":"Binding","updated":true,"vote":"Yes"}},"title":"Votes","type":"object"}},"required":["start_unixtime","votes","summary","passed","outcome"],"title":"VoteDetails","type":"object"},"VoteEmail":{"additionalProperties":false,"properties":{"asf_eid":{"example":"102ed8a-503db792-79bc789-b8ca87ce@apache.org","title":"Asf Eid","type":"string"},"asf_uid_or_email":{"example":"user","title":"Asf Uid Or Email","type":"string"},"from_email":{"example":"user@example.org","title":"From Email","type":"string"},"iso_datetime":{"example":"2025-05-01T12:00:00Z","title":"Iso Datetime","type":"string"},"name":{"example":"Example User","title":"Name","type":"string"},"quotation":{"example":"+1 (Binding)","title":"Quotation","type":"string"},"status":{"$ref":"#/components/schemas/VoteStatus","example":"Binding"},"updated":{"example":true,"title":"Updated","type":"boolean"},"vote":{"$ref":"#/components/schemas/Vote","example":"Yes"}},"required":["name","asf_uid_or_email","from_email","status","asf_eid","iso_datetime","vote","quotation","updated"],"title":"VoteEmail","type":"object"},"VoteEndNotify":{"additionalProperties":false,"description":"Result of the task to notify the initiator that a vote has ended.","properties":{"kind":{"const":"vote_end_notify","title":"Kind","type":"string"},"mail_send_warnings":{"description":"Warnings from the mail server","items":{"type":"string"},"title":"Mail Send Warnings","type":"array"},"mid":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The message ID of the reminder email as sent","title":"Mid"},"sent":{"description":"Whether a reminder email was actually sent","title":"Sent","type":"boolean"},"skip_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The reason the reminder was skipped, if present","title":"Skip Reason"}},"required":["kind","sent","skip_reason","mid","mail_send_warnings"],"title":"VoteEndNotify","type":"object"},"VoteInitiate":{"additionalProperties":false,"description":"Result of the task to initiate a vote.","properties":{"email_to":{"description":"The email To address the vote was sent to","title":"Email To","type":"string"},"kind":{"const":"vote_initiate","title":"Kind","type":"string"},"mail_send_warnings":{"description":"Warnings from the mail server","items":{"type":"string"},"title":"Mail Send Warnings","type":"array"},"message":{"description":"The message from the vote initiation","title":"Message","type":"string"},"mid":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The message ID of the vote email","title":"Mid"},"subject":{"description":"The subject of the vote email","title":"Subject","type":"string"},"vote_end":{"description":"The date and time the vote ends","title":"Vote End","type":"string"}},"required":["kind","message","email_to","vote_end","subject","mid","mail_send_warnings"],"title":"VoteInitiate","type":"object"},"VoteMode":{"enum":["email","trusted"],"title":"VoteMode","type":"string"},"VoteStatus":{"enum":["Binding","Committer","Contributor","Unknown"],"title":"VoteStatus","type":"string"},"VulnerabilityDetails":{"additionalProperties":true,"properties":{"affected":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"default":null,"title":"Affected"},"database_specific":{"additionalProperties":true,"default":{},"title":"Database Specific","type":"object"},"details":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Details"},"id":{"title":"Id","type":"string"},"modified":{"title":"Modified","type":"string"},"published":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Published"},"references":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"default":null,"title":"References"},"severity":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"default":null,"title":"Severity"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Summary"}},"required":["id","modified"],"title":"VulnerabilityDetails","type":"object"}},"securitySchemes":{"BearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http"}}},"info":{"description":"OpenAPI documentation for the Apache Trusted Releases (ATR) platform.","title":"ATR API","version":"v0.1.0.dev3746-8b4b02c5+dirty"},"openapi":"3.1.0","paths":{"/api/catalog/project/{project_key}":{"get":{"description":"\nThe release catalogue for a project as JSON: every catalogued version with\nits artifacts, grouped into cycles for projects that use them.","operationId":"get_catalog_project","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"cle_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Cle Url"},"cycles":{"items":{"$ref":"#/components/schemas/CatalogCycle"},"title":"Cycles","type":"array"},"endpoint":{"const":"/catalog/project","title":"Endpoint","type":"string"},"project":{"title":"Project","type":"string"},"versions":{"items":{"$ref":"#/components/schemas/CatalogVersion"},"title":"Versions","type":"array"}},"required":["endpoint","project","versions","cycles"],"title":"CatalogProjectResults","type":"object"}}},"description":""}},"summary":"URL: GET /catalog/project/<project_key>"}},"/api/checks/list/{project_key}/{version_key}":{"get":{"description":"\nList checks by project and version.\n\nChecks are only conducted during the compose a draft phase. This endpoint\nonly returns the checks for the most recent draft revision. Once a release\nhas been promoted to the vote phase or beyond, the checks returned are\nstill those for the compose phase.\n\nWarning: the check results include results for archive members, so there\nmay potentially be thousands or results or more.","operationId":"get_checks_list","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"version_key","required":true,"schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"default":0,"title":"Offset","type":"integer"}},{"in":"query","name":"limit","schema":{"default":1000,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"checks":{"items":{"$ref":"#/components/schemas/CheckResult"},"title":"Checks","type":"array"},"checks_revision":{"example":"00005","title":"Checks Revision","type":"string"},"count":{"title":"Count","type":"integer"},"current_phase":{"$ref":"#/components/schemas/ReleasePhase","example":"release_candidate"},"endpoint":{"const":"/checks/list","title":"Endpoint","type":"string"}},"required":["endpoint","checks","checks_revision","current_phase","count"],"title":"ChecksListResults","type":"object"}}},"description":""}},"summary":"URL: GET /checks/list/<project_key>/<version_key>"}},"/api/checks/list/{project_key}/{version_key}/{revision}":{"get":{"description":"\nList checks by project, version, and revision.\n\nChecks are only conducted during the compose a draft phase. This endpoint\nonly returns the checks for the specified draft revision. Once a release\nhas been promoted to the vote phase or beyond, the checks returned are\nstill those for the specified revision from the compose phase.\n\nWarning: the check results include results for archive members, so there\nmay potentially be thousands or results or more.","operationId":"get_checks_list_revision","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"version_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"revision","required":true,"schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"default":0,"title":"Offset","type":"integer"}},{"in":"query","name":"limit","schema":{"default":1000,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"checks":{"items":{"$ref":"#/components/schemas/CheckResult"},"title":"Checks","type":"array"},"checks_revision":{"example":"00005","title":"Checks Revision","type":"string"},"count":{"title":"Count","type":"integer"},"current_phase":{"$ref":"#/components/schemas/ReleasePhase","example":"release_candidate"},"endpoint":{"const":"/checks/list","title":"Endpoint","type":"string"}},"required":["endpoint","checks","checks_revision","current_phase","count"],"title":"ChecksListResults","type":"object"}}},"description":""}},"summary":"URL: GET /checks/list/<project_key>/<version_key>/<revision>"}},"/api/checks/ongoing/{project_key}/{version_key}":{"get":{"description":"\nCount ongoing checks by project, version, and optionally revision.\n\nChecks are only conducted during the compose a draft phase. This endpoint\nreturns the number of ongoing checks for the specified draft revision if\npresent, or the most recent draft revision otherwise. A draft release\ncannot be promoted to the vote phase if checks are still ongoing.","operationId":"get_checks_ongoing","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"version_key","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/checks/ongoing","title":"Endpoint","type":"string"},"ongoing":{"example":10,"title":"Ongoing","type":"integer"}},"required":["endpoint","ongoing"],"title":"ChecksOngoingResults","type":"object"}}},"description":""}},"summary":"URL: GET /checks/ongoing/<project_key>/<version_key>[/<revision>]"}},"/api/checks/ongoing/{project_key}/{version_key}/{revision}":{"get":{"description":"\nCount ongoing checks by project, version, and optionally revision.\n\nChecks are only conducted during the compose a draft phase. This endpoint\nreturns the number of ongoing checks for the specified draft revision if\npresent, or the most recent draft revision otherwise. A draft release\ncannot be promoted to the vote phase if checks are still ongoing.","operationId":"get_checks_ongoing","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"version_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"revision","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/checks/ongoing","title":"Endpoint","type":"string"},"ongoing":{"example":10,"title":"Ongoing","type":"integer"}},"required":["endpoint","ongoing"],"title":"ChecksOngoingResults","type":"object"}}},"description":""}},"summary":"URL: GET /checks/ongoing/<project_key>/<version_key>[/<revision>]"}},"/api/cle/project/{project_key}":{"get":{"description":"\nGenerate an ECMA-428 Common Lifecycle Enumeration document covering every\ncycle and release of a project. This is the canonical form per the spec -\none document per component. The body is the raw CLE document, with no ATR\nenvelope, so it can be consumed directly by tooling that expects spec-shaped\nCLE JSON.","operationId":"get_cle_project","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}}],"responses":{},"summary":"URL: GET /cle/project/<project_key>"}},"/api/cle/release/{project_key}/{version_key}":{"get":{"description":"\nGenerate a CLE document filtered to a single release. This is a derived\nview rather than a spec form - the document still has the per-component\nshape ECMA-428 prescribes, but only includes events that touch this\nrelease: its own released and archived events, plus the lifecycle events\nof the cycle it belongs to.","operationId":"get_cle_release","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"version_key","required":true,"schema":{"type":"string"}}],"responses":{},"summary":"URL: GET /cle/release/<project_key>/<version_key>"}},"/api/committee/get/{name}":{"get":{"description":"\nGet a committee by name.\n\nThe name of the committee is the name without any prefixes or suffixes such\nas \"Apache\" or \"PMC\", in lower case, and with hyphens instead of spaces.\nThe Apache Simple Example PMC, for example, would have the name\n\"simple-example\".","operationId":"get_committee_get","parameters":[{"in":"path","name":"name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"committee":{"$ref":"#/components/schemas/Committee"},"endpoint":{"const":"/committee/get","title":"Endpoint","type":"string"}},"required":["endpoint","committee"],"title":"CommitteeGetResults","type":"object"}}},"description":""}},"summary":"URL: GET /committee/get/<name>"}},"/api/committee/keys/{name}":{"get":{"description":"\nList public OpenPGP keys by committee name.\n\nThe name of the committee is the name without any prefixes or suffixes such\nas \"Apache\" or \"PMC\", in lower case, and with hyphens instead of spaces.\nThe Apache Simple Example PMC, for example, would have the name\n\"simple-example\".","operationId":"get_committee_keys","parameters":[{"in":"path","name":"name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/committee/keys","title":"Endpoint","type":"string"},"keys":{"items":{"$ref":"#/components/schemas/SigningCertificate"},"title":"Keys","type":"array"}},"required":["endpoint","keys"],"title":"CommitteeKeysResults","type":"object"}}},"description":""}},"summary":"URL: GET /committee/keys/<name>"}},"/api/committee/projects/{name}":{"get":{"description":"\nList projects by committee name.\n\nThe name of the committee is the name without any prefixes or suffixes such\nas \"Apache\" or \"PMC\", in lower case, and with hyphens instead of spaces.\nThe Apache Simple Example PMC, for example, would have the name\n\"simple-example\".","operationId":"get_committee_projects","parameters":[{"in":"path","name":"name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/committee/projects","title":"Endpoint","type":"string"},"projects":{"items":{"$ref":"#/components/schemas/Project"},"title":"Projects","type":"array"}},"required":["endpoint","projects"],"title":"CommitteeProjectsResults","type":"object"}}},"description":""}},"summary":"URL: GET /committee/projects/<name>"}},"/api/committees/list":{"get":{"description":"\nList committees.\n\nThe list of committees is returned in no particular order.","operationId":"get_committees_list","parameters":[{"in":"query","name":"retired","schema":{"default":false,"title":"Retired","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"committees":{"items":{"$ref":"#/components/schemas/Committee"},"title":"Committees","type":"array"},"endpoint":{"const":"/committees/list","title":"Endpoint","type":"string"}},"required":["endpoint","committees"],"title":"CommitteesListResults","type":"object"}}},"description":""}},"summary":"URL: GET /committees/list"}},"/api/distribute/record_from_workflow":{"post":{"description":"\nRecord the result of an automated distribution from the GH tooling-actions workflow.\nValidates the caller is a Github workflow, triggered by ATR itself","operationId":"post_distribution_record_from_workflow","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"asf_uid":{"example":"user","title":"Asf Uid","type":"string"},"details":{"example":false,"title":"Details","type":"boolean"},"distribution_owner_namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"example","title":"Distribution Owner Namespace"},"distribution_package":{"example":"example","title":"Distribution Package","type":"string"},"distribution_version":{"example":"0.0.1","title":"Distribution Version","type":"string"},"jwt":{"example":"eyJhbGciOiJIUzI1[...]mMjLiuyu5CSpyHI=","title":"Jwt","type":"string"},"phase":{"$ref":"#/components/schemas/TrustedWorkflowPhase","default":"compose","examples":["compose","finish"]},"platform":{"$ref":"#/components/schemas/DistributionPlatform","example":{"default_owner_namespace":null,"gh_slug":"artifacthub","name":"Artifact Hub","requires_owner_namespace":true,"template_staging_url":"https://staging.artifacthub.io/api/v1/packages/helm/{owner_namespace}/{package}/{version}","template_url":"https://artifacthub.io/api/v1/packages/helm/{owner_namespace}/{package}/{version}"}},"project":{"example":"example","title":"Project","type":"string"},"publisher":{"example":"user","title":"Publisher","type":"string"},"staging":{"example":false,"title":"Staging","type":"boolean"},"task_id":{"example":"32","title":"Task Id","type":"string"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["asf_uid","publisher","jwt","project","version","platform","distribution_package","distribution_version","staging","details","task_id"],"title":"DistributionRecordFromWorkflowArgs","type":"object"}}}},"responses":{},"summary":"URL: POST /distribute/record_from_workflow"}},"/api/distribute/ssh/register":{"post":{"description":"\nRegister an SSH key sent with a corroborating Trusted Publisher JWT,\nvalidating the requested release is in the correct phase.","operationId":"post_distribute_ssh_register","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"asf_uid":{"example":"user","title":"Asf Uid","type":"string"},"jwt":{"example":"eyJhbGciOiJIUzI1[...]mMjLiuyu5CSpyHI=","title":"Jwt","type":"string"},"phase":{"$ref":"#/components/schemas/TrustedWorkflowPhase","default":"compose","examples":["compose","finish"]},"project_key":{"example":"tooling","title":"Project Key","type":"string"},"publisher":{"example":"user","title":"Publisher","type":"string"},"ssh_key":{"example":"ssh-ed25519 AAAAC3NzaC1lZDI1NTEgH5C9okWi0dh25AAAAIOMqqnkVzrm0SdG6UOoqKLsabl9GKJl","title":"Ssh Key","type":"string"},"task_id":{"example":"32","title":"Task Id","type":"string"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["publisher","jwt","ssh_key","asf_uid","project_key","version","task_id"],"title":"DistributeSshRegisterArgs","type":"object"}}}},"responses":{},"summary":"URL: POST /distribute/ssh/register"}},"/api/distribute/task/status":{"post":{"description":"\nUpdate the status of a distribution task\nValidates the caller is a Github workflow, triggered by ATR itself","operationId":"post_update_distribution_task_status","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"jwt":{"example":"eyJhbGciOiJIUzI1[...]mMjLiuyu5CSpyHI=","title":"Jwt","type":"string"},"message":{"description":"Workflow message","title":"Message","type":"string"},"project_key":{"description":"Project name in ATR","title":"Project Key","type":"string"},"publisher":{"example":"user","title":"Publisher","type":"string"},"run_id":{"description":"Workflow run ID","title":"Run Id","type":"string"},"status":{"description":"Workflow status","title":"Status","type":"string"},"workflow":{"description":"Workflow name","title":"Workflow","type":"string"}},"required":["publisher","jwt","workflow","run_id","project_key","status","message"],"title":"DistributeStatusUpdateArgs","type":"object"}}}},"responses":{},"summary":"URL: POST /distribute/task/status"}},"/api/distribution/list/{project_key}/{version_key}":{"get":{"description":"\nList recorded distributions for a release.","operationId":"get_distribution_list","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"version_key","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"distributions":{"items":{"$ref":"#/components/schemas/DistributionListEntry"},"title":"Distributions","type":"array"},"endpoint":{"const":"/distribution/list","title":"Endpoint","type":"string"}},"required":["endpoint","distributions"],"title":"DistributionListResults","type":"object"}}},"description":""}},"summary":"URL: GET /distribution/list/<project_key>/<version_key>"}},"/api/distribution/record":{"post":{"description":"\nRecord a manual distribution.","operationId":"post_distribution_record","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"details":{"example":false,"title":"Details","type":"boolean"},"distribution_owner_namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"example","title":"Distribution Owner Namespace"},"distribution_package":{"example":"example","title":"Distribution Package","type":"string"},"distribution_version":{"example":"0.0.1","title":"Distribution Version","type":"string"},"platform":{"$ref":"#/components/schemas/DistributionPlatform","example":{"default_owner_namespace":null,"gh_slug":"artifacthub","name":"Artifact Hub","requires_owner_namespace":true,"template_staging_url":"https://staging.artifacthub.io/api/v1/packages/helm/{owner_namespace}/{package}/{version}","template_url":"https://artifacthub.io/api/v1/packages/helm/{owner_namespace}/{package}/{version}"}},"project":{"example":"example","title":"Project","type":"string"},"staging":{"example":false,"title":"Staging","type":"boolean"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["project","version","platform","distribution_package","distribution_version","staging","details"],"title":"DistributionRecordArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/distribution/record","title":"Endpoint","type":"string"},"success":{"const":true,"example":true,"title":"Success","type":"boolean"}},"required":["endpoint","success"],"title":"DistributionRecordResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /distribution/record"}},"/api/ignore/add":{"post":{"description":"\nAdd a check ignore.","operationId":"post_ignore_add","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"checker_glob":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"atr.tasks.checks.license.files","title":"Checker Glob"},"member_rel_path_glob":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"apache-example-0.0.1/*.xml","title":"Member Rel Path Glob"},"message_glob":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"sha512 matches for apache-example-0.0.1/*.xml","title":"Message Glob"},"primary_rel_path_glob":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"apache-example-0.0.1-*.tar.gz","title":"Primary Rel Path Glob"},"project_key":{"example":"example","title":"Project Key","type":"string"},"release_glob":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"example-0.0.*","title":"Release Glob"},"revision_number":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"00001","title":"Revision Number"},"status":{"anyOf":[{"$ref":"#/components/schemas/CheckResultStatusIgnore"},{"type":"null"}],"default":null,"example":"concern"}},"required":["project_key"],"title":"IgnoreAddArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/ignore/add","title":"Endpoint","type":"string"},"success":{"const":true,"example":true,"title":"Success","type":"boolean"}},"required":["endpoint","success"],"title":"IgnoreAddResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /ignore/add"}},"/api/ignore/delete":{"post":{"description":"\nDelete a check ignore.","operationId":"post_ignore_delete","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"id":{"example":1,"title":"Id","type":"integer"},"project_key":{"example":"example","title":"Project Key","type":"string"}},"required":["project_key","id"],"title":"IgnoreDeleteArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/ignore/delete","title":"Endpoint","type":"string"},"success":{"const":true,"example":true,"title":"Success","type":"boolean"}},"required":["endpoint","success"],"title":"IgnoreDeleteResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /ignore/delete"}},"/api/ignore/list/{project_key}":{"get":{"description":"\nList ignores by project name.","operationId":"get_ignore_list","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/ignore/list","title":"Endpoint","type":"string"},"ignores":{"items":{"$ref":"#/components/schemas/CheckResultIgnore"},"title":"Ignores","type":"array"}},"required":["endpoint","ignores"],"title":"IgnoreListResults","type":"object"}}},"description":""}},"summary":"URL: GET /ignore/list/<project_key>"}},"/api/jwt/create":{"post":{"description":"\nCreate a JWT.\n\nThe payload must include a valid PAT.","operationId":"post_jwt_create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"asfuid":{"example":"user","title":"Asfuid","type":"string"},"pat":{"example":"8M5t4GCU63EdOy4NNXgXn7o-bc-muK8TRg5W-DeBaWY","title":"Pat","type":"string"}},"required":["asfuid","pat"],"title":"JwtCreateArgs","type":"object"}}}},"responses":{},"summary":"URL: POST /jwt/create"}},"/api/key/add":{"post":{"description":"\nAdd a public OpenPGP key.\n\nOnce associated with the specified committees, the key will appear in the\nautomatically generated KEYS file for each committee.","operationId":"post_key_add","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"asfuid":{"example":"user","title":"Asfuid","type":"string"},"committees":{"example":["example"],"items":{"type":"string"},"title":"Committees","type":"array"},"key":{"example":"-----BEGIN PGP PUBLIC KEY BLOCK-----\n\n...\n-----END PGP PUBLIC KEY BLOCK-----\n","title":"Key","type":"string"}},"required":["asfuid","key","committees"],"title":"KeyAddArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/key/add","title":"Endpoint","type":"string"},"fingerprint":{"example":"0123456789abcdef0123456789abcdef01234567","title":"Fingerprint","type":"string"},"warnings":{"items":{"type":"string"},"title":"Warnings","type":"array"}},"required":["endpoint","fingerprint"],"title":"KeyAddResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /key/add"}},"/api/key/delete":{"post":{"description":"\nDelete a public OpenPGP key.\n\nWarning: we plan to change how key deletion works.","operationId":"post_key_delete","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"fingerprint":{"example":"0123456789abcdef0123456789abcdef01234567","title":"Fingerprint","type":"string"}},"required":["fingerprint"],"title":"KeyDeleteArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/key/delete","title":"Endpoint","type":"string"},"success":{"const":true,"example":true,"title":"Success","type":"boolean"},"warnings":{"items":{"type":"string"},"title":"Warnings","type":"array"}},"required":["endpoint","success"],"title":"KeyDeleteResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /key/delete"}},"/api/key/get/{fingerprint}":{"get":{"description":"\nGet a public OpenPGP key by fingerprint.\n\nAll public OpenPGP keys stored within the database are accessible.","operationId":"get_key_get","parameters":[{"in":"path","name":"fingerprint","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/key/get","title":"Endpoint","type":"string"},"key":{"$ref":"#/components/schemas/SigningCertificate"}},"required":["endpoint","key"],"title":"KeyGetResults","type":"object"}}},"description":""}},"summary":"URL: GET /key/get/<fingerprint>"}},"/api/keys/upload":{"post":{"description":"\nUpload a public OpenPGP KEYS file.","operationId":"post_keys_upload","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"committee":{"example":"example","title":"Committee","type":"string"},"filetext":{"example":"-----BEGIN PGP PUBLIC KEY BLOCK-----\n\n...\n-----END PGP PUBLIC KEY BLOCK-----\n","title":"Filetext","type":"string"}},"required":["filetext","committee"],"title":"KeysUploadArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/keys/upload","title":"Endpoint","type":"string"},"error_count":{"example":0,"title":"Error Count","type":"integer"},"results":{"items":{"anyOf":[{"$ref":"#/components/schemas/KeysUploadResult"},{"$ref":"#/components/schemas/KeysUploadException"}]},"title":"Results","type":"array"},"submitted_committee":{"example":"example","title":"Submitted Committee","type":"string"},"success_count":{"example":1,"title":"Success Count","type":"integer"},"warnings":{"items":{"type":"string"},"title":"Warnings","type":"array"}},"required":["endpoint","results","success_count","error_count","submitted_committee"],"title":"KeysUploadResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /keys/upload"}},"/api/keys/user/{asf_uid}":{"get":{"description":"\nList public OpenPGP keys by the ASF UID of a user.","operationId":"get_keys_user","parameters":[{"in":"path","name":"asf_uid","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/keys/user","title":"Endpoint","type":"string"},"keys":{"items":{"$ref":"#/components/schemas/SigningCertificate"},"title":"Keys","type":"array"}},"required":["endpoint","keys"],"title":"KeysUserResults","type":"object"}}},"description":""}},"summary":"URL: GET /keys/user/<asf_uid>"}},"/api/policy/get/{project_key}":{"get":{"description":"\nGet project policy by name.\n\nReturns the release policy settings for a project.\nIf no policy has been configured, defaults are returned.","operationId":"get_policy_get","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/policy/get","title":"Endpoint","type":"string"},"policy_announce_recipients":{"$ref":"#/components/schemas/RecipientDefaults"},"policy_announce_release_subject":{"title":"Policy Announce Release Subject","type":"string"},"policy_announce_release_template":{"title":"Policy Announce Release Template","type":"string"},"policy_announce_release_template_url":{"title":"Policy Announce Release Template Url","type":"string"},"policy_binary_artifact_paths":{"items":{"type":"string"},"title":"Policy Binary Artifact Paths","type":"array"},"policy_finish_vote_template":{"title":"Policy Finish Vote Template","type":"string"},"policy_finish_vote_template_url":{"title":"Policy Finish Vote Template Url","type":"string"},"policy_github_compose_workflow_path":{"items":{"type":"string"},"title":"Policy Github Compose Workflow Path","type":"array"},"policy_github_finish_workflow_path":{"items":{"type":"string"},"title":"Policy Github Finish Workflow Path","type":"array"},"policy_github_repository_branch":{"title":"Policy Github Repository Branch","type":"string"},"policy_github_repository_name":{"title":"Policy Github Repository Name","type":"string"},"policy_github_vote_workflow_path":{"items":{"type":"string"},"title":"Policy Github Vote Workflow Path","type":"array"},"policy_license_check_mode":{"$ref":"#/components/schemas/LicenseCheckMode"},"policy_min_hours":{"title":"Policy Min Hours","type":"integer"},"policy_release_checklist":{"title":"Policy Release Checklist","type":"string"},"policy_source_artifact_paths":{"items":{"type":"string"},"title":"Policy Source Artifact Paths","type":"array"},"policy_start_vote_subject":{"title":"Policy Start Vote Subject","type":"string"},"policy_start_vote_template":{"title":"Policy Start Vote Template","type":"string"},"policy_start_vote_template_url":{"title":"Policy Start Vote Template Url","type":"string"},"policy_vote_comment_template":{"title":"Policy Vote Comment Template","type":"string"},"policy_vote_comment_template_url":{"title":"Policy Vote Comment Template Url","type":"string"},"policy_vote_mode":{"$ref":"#/components/schemas/VoteMode","example":"email"},"policy_vote_recipients":{"$ref":"#/components/schemas/RecipientDefaults"},"project_key":{"title":"Project Key","type":"string"}},"required":["endpoint","project_key","policy_announce_release_subject","policy_announce_release_template","policy_announce_release_template_url","policy_binary_artifact_paths","policy_github_compose_workflow_path","policy_github_finish_workflow_path","policy_github_repository_branch","policy_github_repository_name","policy_github_vote_workflow_path","policy_license_check_mode","policy_vote_recipients","policy_announce_recipients","policy_min_hours","policy_vote_mode","policy_release_checklist","policy_source_artifact_paths","policy_start_vote_subject","policy_start_vote_template","policy_start_vote_template_url","policy_finish_vote_template","policy_finish_vote_template_url","policy_vote_comment_template","policy_vote_comment_template_url"],"title":"PolicyGetResults","type":"object"}}},"description":""}},"summary":"URL: GET /policy/get/<project_key>"}},"/api/policy/update":{"post":{"description":"\nUpdate release policy fields for a project.\n\nOnly fields present in the request body are modified.","operationId":"post_policy_update","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"announce_recipients":{"anyOf":[{"$ref":"#/components/schemas/RecipientDefaults"},{"type":"null"}],"default":null},"announce_release_subject":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Announce Release Subject"},"announce_release_template":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Announce Release Template"},"announce_release_template_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Announce Release Template Url"},"auto_archive_prior_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Auto Archive Prior Release"},"binary_artifact_paths":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Binary Artifact Paths"},"download_path_suffix":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Download Path Suffix"},"file_tag_mappings":{"anyOf":[{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object"},{"type":"null"}],"default":null,"title":"File Tag Mappings"},"finish_vote_template":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Finish Vote Template"},"finish_vote_template_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Finish Vote Template Url"},"github_compose_workflow_path":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Github Compose Workflow Path"},"github_finish_workflow_path":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Github Finish Workflow Path"},"github_repository_branch":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Github Repository Branch"},"github_repository_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Github Repository Name"},"github_vote_workflow_path":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Github Vote Workflow Path"},"license_check_mode":{"anyOf":[{"$ref":"#/components/schemas/LicenseCheckMode"},{"type":"null"}],"default":null},"min_hours":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Min Hours"},"project":{"example":"example","title":"Project","type":"string"},"rat_excludes_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Rat Excludes Url"},"release_checklist":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Release Checklist"},"require_version_in_filenames":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Require Version In Filenames"},"source_artifact_paths":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Source Artifact Paths"},"source_excludes_lightweight":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Source Excludes Lightweight"},"source_excludes_rat":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Source Excludes Rat"},"start_vote_subject":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Start Vote Subject"},"start_vote_template":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Start Vote Template"},"start_vote_template_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Start Vote Template Url"},"vote_comment_template":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Vote Comment Template"},"vote_comment_template_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Vote Comment Template Url"},"vote_mode":{"anyOf":[{"$ref":"#/components/schemas/VoteMode"},{"type":"null"}],"default":null},"vote_recipients":{"anyOf":[{"$ref":"#/components/schemas/RecipientDefaults"},{"type":"null"}],"default":null}},"required":["project"],"title":"PolicyUpdateArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/policy/update","title":"Endpoint","type":"string"},"success":{"const":true,"example":true,"title":"Success","type":"boolean"}},"required":["endpoint","success"],"title":"PolicyUpdateResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /policy/update"}},"/api/project/config":{"post":{"description":"\nUpsert a project's full configuration.\n\nCreates a project under the specified key if it does not yet exist.\nOtherwise, updates all specified fields for an existing project. With\nsync_mode \"full\", every field this endpoint can set but the caller omitted\nis reset to its default as well. The trusted publishing settings are not\naccepted here in either mode; they are set in ATR by a committee member.\n\nRequires a system token. This endpoint backs the .asf.yaml processor, which\nestablishes upstream that the caller may act for the named committee. For an\nexisting project, committee_key must match the current value.","operationId":"post_project_config_upsert","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"committee_key":{"example":"example","title":"Committee Key","type":"string"},"policy":{"anyOf":[{"$ref":"#/components/schemas/ProjectConfigPolicyArgs"},{"type":"null"}],"default":null},"project":{"anyOf":[{"$ref":"#/components/schemas/ProjectConfigProjectArgs"},{"type":"null"}],"default":null},"project_key":{"example":"example","title":"Project Key","type":"string"},"sync_mode":{"default":"merge","enum":["merge","full"],"title":"Sync Mode","type":"string"}},"required":["project_key","committee_key"],"title":"ProjectConfigArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"created":{"example":false,"title":"Created","type":"boolean"},"endpoint":{"const":"/project/config","title":"Endpoint","type":"string"},"success":{"const":true,"example":true,"title":"Success","type":"boolean"}},"required":["endpoint","success","created"],"title":"ProjectConfigResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /project/config"}},"/api/project/get/{project_key}":{"get":{"description":"\nGet a project by name.","operationId":"get_project_get","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/project/get","title":"Endpoint","type":"string"},"project":{"$ref":"#/components/schemas/Project"}},"required":["endpoint","project"],"title":"ProjectGetResults","type":"object"}}},"description":""}},"summary":"URL: GET /project/get/<project_key>"}},"/api/project/releases/{project_key}":{"get":{"description":"\nList releases by project name.","operationId":"get_project_releases","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"default":0,"title":"Offset","type":"integer"}},{"in":"query","name":"limit","schema":{"default":1000,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"count":{"title":"Count","type":"integer"},"endpoint":{"const":"/project/releases","title":"Endpoint","type":"string"},"releases":{"items":{"$ref":"#/components/schemas/Release"},"title":"Releases","type":"array"}},"required":["endpoint","releases","count"],"title":"ProjectReleasesResults","type":"object"}}},"description":""}},"summary":"URL: GET /project/releases/<project_key>"}},"/api/projects/list":{"get":{"description":"\nList projects.","operationId":"get_projects_list","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/projects/list","title":"Endpoint","type":"string"},"projects":{"items":{"$ref":"#/components/schemas/Project"},"title":"Projects","type":"array"}},"required":["endpoint","projects"],"title":"ProjectsListResults","type":"object"}}},"description":""}},"summary":"URL: GET /projects/list"}},"/api/publisher/distribution/record":{"post":{"description":"\nRecord a distribution with a corroborating Trusted Publisher JWT.","operationId":"post_publisher_distribution_record","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"details":{"example":false,"title":"Details","type":"boolean"},"distribution_owner_namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"example","title":"Distribution Owner Namespace"},"distribution_package":{"example":"example","title":"Distribution Package","type":"string"},"distribution_version":{"example":"0.0.1","title":"Distribution Version","type":"string"},"jwt":{"example":"eyJhbGciOiJIUzI1[...]mMjLiuyu5CSpyHI=","title":"Jwt","type":"string"},"platform":{"$ref":"#/components/schemas/DistributionPlatform","example":{"default_owner_namespace":null,"gh_slug":"artifacthub","name":"Artifact Hub","requires_owner_namespace":true,"template_staging_url":"https://staging.artifacthub.io/api/v1/packages/helm/{owner_namespace}/{package}/{version}","template_url":"https://artifacthub.io/api/v1/packages/helm/{owner_namespace}/{package}/{version}"}},"publisher":{"example":"user","title":"Publisher","type":"string"},"staging":{"example":false,"title":"Staging","type":"boolean"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["publisher","jwt","version","platform","distribution_package","distribution_version","staging","details"],"title":"PublisherDistributionRecordArgs","type":"object"}}}},"responses":{},"summary":"URL: POST /publisher/distribution/record"}},"/api/publisher/jwt/create":{"post":{"description":"\nExchange a Trusted Publisher JWT for a short lived ATR JWT.\n\nThe ATR JWT can create a release and store files in it, for the one project that the workflow\nis registered to. It lasts five minutes and can't be refreshed, and each Trusted Publisher JWT\ncan be exchanged only once.","operationId":"post_publisher_jwt_create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"declare_sources":{"default":true,"example":true,"title":"Declare Sources","type":"boolean"},"jwt":{"example":"eyJhbGciOiJIUzI1[...]mMjLiuyu5CSpyHI=","title":"Jwt","type":"string"},"publisher":{"example":"user","title":"Publisher","type":"string"},"source_commit":{"$ref":"#/components/schemas/OptionalCommitHash","default":null,"example":"0123456789abcdef0123456789abcdef01234567"}},"required":["publisher","jwt"],"title":"PublisherJwtCreateArgs","type":"object"}}}},"responses":{},"summary":"URL: POST /publisher/jwt/create"}},"/api/publisher/release/announce":{"post":{"description":"\nAnnounce a release with a corroborating Trusted Publisher JWT.","operationId":"post_publisher_release_announce","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"body":{"example":"The Apache Example team is pleased to announce the release of Example 1.0.0...","title":"Body","type":"string"},"email_to":{"example":"dev@example.apache.org","title":"Email To","type":"string"},"jwt":{"example":"eyJhbGciOiJIUzI1[...]mMjLiuyu5CSpyHI=","title":"Jwt","type":"string"},"path_suffix":{"$ref":"#/components/schemas/OptionalRelPath","example":"example/1.0.0"},"publisher":{"example":"user","title":"Publisher","type":"string"},"revision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"00005","title":"Revision"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["publisher","jwt","version","email_to","body","path_suffix"],"title":"PublisherReleaseAnnounceArgs","type":"object"}}}},"responses":{},"summary":"URL: POST /publisher/release/announce"}},"/api/publisher/release/source":{"post":{"description":"\nDeclare the repository and commit that source archives in a draft were built from,\nwith a corroborating Trusted Publisher JWT.","operationId":"post_publisher_release_source","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"expected_revision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"00003","title":"Expected Revision"},"jwt":{"example":"eyJhbGciOiJIUzI1[...]mMjLiuyu5CSpyHI=","title":"Jwt","type":"string"},"publisher":{"example":"user","title":"Publisher","type":"string"},"sources":{"example":[{"commit":"0123456789abcdef0123456789abcdef01234567","relpath":"example-0.0.1-src.tar.gz","repository":"apache/example"}],"items":{"$ref":"#/components/schemas/SourceDeclaration"},"title":"Sources","type":"array"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["publisher","jwt","version","sources"],"title":"PublisherReleaseSourceArgs","type":"object"}}}},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/publisher/release/source","title":"Endpoint","type":"string"},"revision":{"$ref":"#/components/schemas/Revision"}},"required":["endpoint","revision"],"title":"PublisherReleaseSourceResults","type":"object"}}},"description":""}},"summary":"URL: POST /publisher/release/source"}},"/api/publisher/ssh/register":{"post":{"description":"\nRegister an SSH key sent with a corroborating Trusted Publisher JWT.","operationId":"post_publisher_ssh_register","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"declare_sources":{"default":true,"example":true,"title":"Declare Sources","type":"boolean"},"jwt":{"example":"eyJhbGciOiJIUzI1[...]mMjLiuyu5CSpyHI=","title":"Jwt","type":"string"},"publisher":{"example":"user","title":"Publisher","type":"string"},"source_commit":{"$ref":"#/components/schemas/OptionalCommitHash","default":null,"example":"0123456789abcdef0123456789abcdef01234567"},"ssh_key":{"example":"ssh-ed25519 AAAAC3NzaC1lZDI1NTEgH5C9okWi0dh25AAAAIOMqqnkVzrm0SdG6UOoqKLsabl9GKJl","title":"Ssh Key","type":"string"}},"required":["publisher","jwt","ssh_key"],"title":"PublisherSshRegisterArgs","type":"object"}}}},"responses":{},"summary":"URL: POST /publisher/ssh/register"}},"/api/publisher/vote/resolve":{"post":{"description":"\nResolve a vote with a corroborating Trusted Publisher JWT.","operationId":"post_publisher_vote_resolve","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"jwt":{"example":"eyJhbGciOiJIUzI1[...]mMjLiuyu5CSpyHI=","title":"Jwt","type":"string"},"publisher":{"example":"user","title":"Publisher","type":"string"},"resolution":{"enum":["passed","failed","cancelled"],"example":"passed","title":"Resolution","type":"string"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["publisher","jwt","version","resolution"],"title":"PublisherVoteResolveArgs","type":"object"}}}},"responses":{},"summary":"URL: POST /publisher/vote/resolve"}},"/api/release/announce":{"post":{"description":"\nAnnounce a release.\n\nAfter a vote on a release has passed, if everything is in order and all\npaths are correct, the release can be announced. This will send an email to\nthe specified announcement address, and promote the release to the finished\nrelease phase. Once announced, a release is final and cannot be changed.\n\nIf the body is omitted, it is rendered from the project announce email\ntemplate.","operationId":"post_release_announce","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"body":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"The Apache Example team is pleased to announce the release of Example 1.0.0...","title":"Body"},"email_bcc":{"default":[],"example":["private@example.apache.org"],"items":{"type":"string"},"title":"Email Bcc","type":"array"},"email_cc":{"default":[],"example":["announce@apache.org"],"items":{"type":"string"},"title":"Email Cc","type":"array"},"email_to":{"example":"dev@example.apache.org","title":"Email To","type":"string"},"path_suffix":{"$ref":"#/components/schemas/OptionalRelPath","example":"example/1.0.0"},"project":{"example":"example","title":"Project","type":"string"},"revision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"00005","title":"Revision"},"version":{"example":"1.0.0","title":"Version","type":"string"}},"required":["project","version","email_to","path_suffix"],"title":"ReleaseAnnounceArgs","type":"object"}}}},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/release/announce","title":"Endpoint","type":"string"},"success":{"const":true,"example":true,"title":"Success","type":"boolean"}},"required":["endpoint","success"],"title":"ReleaseAnnounceResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /release/announce"}},"/api/release/commit":{"post":{"description":"\nRecord the commit that the source archives in a draft were built from.\nThis is the same commit that the upload form asks for, and applies to the whole release.\nProjects with several GitHub repositories declare each archive with release/source instead.","operationId":"post_release_commit","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"commit":{"$ref":"#/components/schemas/OptionalCommitHash","default":null,"example":"0123456789abcdef0123456789abcdef01234567"},"project":{"example":"example","title":"Project","type":"string"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["project","version"],"title":"ReleaseCommitArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/release/commit","title":"Endpoint","type":"string"},"release":{"$ref":"#/components/schemas/Release"}},"required":["endpoint","release"],"title":"ReleaseCommitResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /release/commit"}},"/api/release/create":{"post":{"description":"\nCreate a release.\n\nRelease are created as a draft, which must be composed.","operationId":"post_release_create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"project":{"example":"example","title":"Project","type":"string"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["project","version"],"title":"ReleaseCreateArgs","type":"object"}}}},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/release/create","title":"Endpoint","type":"string"},"release":{"$ref":"#/components/schemas/Release"}},"required":["endpoint","release"],"title":"ReleaseCreateResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /release/create"}},"/api/release/delete":{"post":{"description":"\nDelete a release.","operationId":"post_release_delete","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"project":{"example":"example","title":"Project","type":"string"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["project","version"],"title":"ReleaseDeleteArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"deleted":{"const":true,"example":true,"title":"Deleted","type":"boolean"},"endpoint":{"const":"/release/delete","title":"Endpoint","type":"string"}},"required":["endpoint","deleted"],"title":"ReleaseDeleteResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /release/delete"}},"/api/release/draft/delete":{"post":{"description":"\nDelete a draft release.","operationId":"post_release_draft_delete","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"project":{"example":"example","title":"Project","type":"string"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["project","version"],"title":"ReleaseDraftDeleteArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/release/draft/delete","title":"Endpoint","type":"string"},"success":{"const":true,"example":true,"title":"Success","type":"boolean"}},"required":["endpoint","success"],"title":"ReleaseDraftDeleteResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /release/draft/delete"}},"/api/release/get/{project_key}/{version_key}":{"get":{"description":"\nGet a release by project and version.","operationId":"get_release_get","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"version_key","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/release/get","title":"Endpoint","type":"string"},"release":{"$ref":"#/components/schemas/Release"}},"required":["endpoint","release"],"title":"ReleaseGetResults","type":"object"}}},"description":""}},"summary":"URL: GET /release/get/<project_key>/<version_key>"}},"/api/release/manifest/{project_key}/{version_key}/{revision}":{"get":{"operationId":"get_release_manifest","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"version_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"revision","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/release/manifest","title":"Endpoint","type":"string"},"files":{"description":"All files in the requested revision, without pagination.","items":{"$ref":"#/components/schemas/ReleaseManifestFile"},"title":"Files","type":"array"},"project":{"title":"Project","type":"string"},"revision":{"title":"Revision","type":"string"},"version":{"title":"Version","type":"string"}},"required":["endpoint","project","version","revision","files"],"title":"ReleaseManifestResults","type":"object"}}},"description":""}}}},"/api/release/paths/{project_key}/{version_key}":{"get":{"description":"\nList paths in a release by project and version.","operationId":"get_release_paths","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"version_key","required":true,"schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"default":0,"title":"Offset","type":"integer"}},{"in":"query","name":"limit","schema":{"default":1000,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"count":{"title":"Count","type":"integer"},"endpoint":{"const":"/release/paths","title":"Endpoint","type":"string"},"rel_paths":{"example":["example/0.0.1/example-0.0.1-bin.tar.gz"],"items":{"type":"string"},"title":"Rel Paths","type":"array"}},"required":["endpoint","rel_paths","count"],"title":"ReleasePathsResults","type":"object"}}},"description":""}},"summary":"URL: GET /release/paths/<project_key>/<version_key>[/<revision>]"}},"/api/release/paths/{project_key}/{version_key}/{revision}":{"get":{"description":"\nList paths in a release by project and version.","operationId":"get_release_paths","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"version_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"revision","required":true,"schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"default":0,"title":"Offset","type":"integer"}},{"in":"query","name":"limit","schema":{"default":1000,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"count":{"title":"Count","type":"integer"},"endpoint":{"const":"/release/paths","title":"Endpoint","type":"string"},"rel_paths":{"example":["example/0.0.1/example-0.0.1-bin.tar.gz"],"items":{"type":"string"},"title":"Rel Paths","type":"array"}},"required":["endpoint","rel_paths","count"],"title":"ReleasePathsResults","type":"object"}}},"description":""}},"summary":"URL: GET /release/paths/<project_key>/<version_key>[/<revision>]"}},"/api/release/revisions/{project_key}/{version_key}":{"get":{"description":"\nList revisions by project and version.","operationId":"get_release_revisions","parameters":[{"in":"path","name":"project_key","required":true,"schema":{"type":"string"}},{"in":"path","name":"version_key","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/release/revisions","title":"Endpoint","type":"string"},"revisions":{"items":{"$ref":"#/components/schemas/Revision"},"title":"Revisions","type":"array"}},"required":["endpoint","revisions"],"title":"ReleaseRevisionsResults","type":"object"}}},"description":""}},"summary":"URL: GET /release/revisions/<project_key>/<version_key>"}},"/api/release/source":{"post":{"description":"\nDeclare the repository and commit that source archives in a draft were built from, archive by archive.\nProjects with several GitHub repositories must use this, as ATR can't tell which one an archive came from.\nProjects with one repository can instead give the commit when uploading, or with release/commit.","operationId":"post_release_source","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"expected_revision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"00003","title":"Expected Revision"},"project":{"example":"example","title":"Project","type":"string"},"sources":{"example":[{"commit":"0123456789abcdef0123456789abcdef01234567","relpath":"example-0.0.1-src.tar.gz","repository":"apache/example"}],"items":{"$ref":"#/components/schemas/SourceDeclaration"},"title":"Sources","type":"array"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["project","version","sources"],"title":"ReleaseSourceArgs","type":"object"}}}},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/release/source","title":"Endpoint","type":"string"},"revision":{"$ref":"#/components/schemas/Revision"}},"required":["endpoint","revision"],"title":"ReleaseSourceResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /release/source"}},"/api/release/store":{"post":{"description":"\nStore a file in a release, streaming the raw request body to disk.\nMetadata is passed in the query string, and the body is the file content.","operationId":"post_release_store","parameters":[{"in":"query","name":"project","required":true,"schema":{"title":"Project","type":"string"}},{"in":"query","name":"version","required":true,"schema":{"title":"Version","type":"string"}},{"in":"query","name":"relpath","required":true,"schema":{"title":"Relpath","type":"string"}},{"in":"query","name":"expected_revision","schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Expected Revision"}},{"in":"query","name":"source_commit","schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Commit"}}],"requestBody":{"content":{"application/octet-stream":{"schema":{"format":"binary","type":"string"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/release/store","title":"Endpoint","type":"string"},"quarantined":{"title":"Quarantined","type":"boolean"},"revision":{"anyOf":[{"$ref":"#/components/schemas/Revision"},{"type":"null"}]}},"required":["endpoint","quarantined","revision"],"title":"ReleaseStoreResults","type":"object"}}},"description":""},"202":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/release/store","title":"Endpoint","type":"string"},"quarantined":{"title":"Quarantined","type":"boolean"},"revision":{"anyOf":[{"$ref":"#/components/schemas/Revision"},{"type":"null"}]}},"required":["endpoint","quarantined","revision"],"title":"ReleaseStoreResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /release/store"}},"/api/release/upload":{"post":{"description":"\nUpload a file to a release.\nThis endpoint could theoretically be more rate limited but we may wish to allow a project/user to upload\nmultiple files in a short period of time.","operationId":"post_release_upload","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"content":{"example":"This is the content of the file.","title":"Content","type":"string"},"expected_revision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"00003","title":"Expected Revision"},"project":{"example":"example","title":"Project","type":"string"},"relpath":{"example":"example/0.0.1/example-0.0.1-bin.tar.gz","title":"Relpath","type":"string"},"source_commit":{"$ref":"#/components/schemas/OptionalCommitHash","default":null,"example":"0123456789abcdef0123456789abcdef01234567"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["project","version","relpath","content"],"title":"ReleaseUploadArgs","type":"object"}}}},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/release/upload","title":"Endpoint","type":"string"},"revision":{"$ref":"#/components/schemas/Revision"}},"required":["endpoint","revision"],"title":"ReleaseUploadResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /release/upload"}},"/api/releases/list":{"get":{"description":"\nList releases.\n\nThe list of releases is paged and can be filtered by phase.","operationId":"get_releases_list","parameters":[{"in":"query","name":"offset","schema":{"default":0,"title":"Offset","type":"integer"}},{"in":"query","name":"limit","schema":{"default":20,"title":"Limit","type":"integer"}},{"in":"query","name":"phase","schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Phase"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"count":{"title":"Count","type":"integer"},"data":{"items":{"$ref":"#/components/schemas/Release"},"title":"Data","type":"array"},"endpoint":{"const":"/releases/list","title":"Endpoint","type":"string"}},"required":["endpoint","data","count"],"title":"ReleasesListResults","type":"object"}}},"description":""}},"summary":"URL: GET /releases/list"}},"/api/sbom/generate":{"post":{"operationId":"post_sbom_generate","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"project":{"example":"example","title":"Project","type":"string"},"relpath":{"example":"example-0.0.1-bin.tar.gz","title":"Relpath","type":"string"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["project","version","relpath"],"title":"SbomGenerateArgs","type":"object"}}}},"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/sbom/generate","title":"Endpoint","type":"string"},"task":{"$ref":"#/components/schemas/Task"}},"required":["endpoint","task"],"title":"SbomGenerateResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}]}},"/api/signature/provenance":{"post":{"description":"\nGet the provenance of a signature.","operationId":"post_signature_provenance","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"project_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"example","title":"Project Key"},"signature_asc_text":{"example":"-----BEGIN PGP SIGNATURE-----\n\n...\n-----END PGP SIGNATURE-----\n","title":"Signature Asc Text","type":"string"},"signature_file_name":{"example":"example-0.0.1-bin.tar.gz.asc","title":"Signature File Name","type":"string"},"signature_sha3_256":{"example":"0123456789abcdef0123456789abcdef01234567","title":"Signature Sha3 256","type":"string"},"version_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"0.0.1","title":"Version Key"}},"required":["signature_file_name","signature_asc_text","signature_sha3_256"],"title":"SignatureProvenanceArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"committees_with_artifact":{"items":{"$ref":"#/components/schemas/SignatureProvenanceKey"},"title":"Committees With Artifact","type":"array"},"endpoint":{"const":"/signature/provenance","title":"Endpoint","type":"string"},"fingerprint":{"example":"0123456789abcdef0123456789abcdef01234567","title":"Fingerprint","type":"string"},"key_asc_text":{"example":"-----BEGIN PGP PUBLIC KEY BLOCK-----\n\n...\n-----END PGP PUBLIC KEY BLOCK-----\n","title":"Key Asc Text","type":"string"}},"required":["endpoint","fingerprint","key_asc_text","committees_with_artifact"],"title":"SignatureProvenanceResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /signature/provenance"}},"/api/ssh-key/delete":{"post":{"description":"\nDelete an SSH key.\n\nAn SSH key can only be deleted by the user who owns it.","operationId":"post_ssh_key_delete","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"fingerprint":{"example":"0123456789abcdef0123456789abcdef01234567","title":"Fingerprint","type":"string"}},"required":["fingerprint"],"title":"SshKeyDeleteArgs","type":"object"}}}},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/ssh-key/delete","title":"Endpoint","type":"string"},"success":{"const":true,"example":true,"title":"Success","type":"boolean"}},"required":["endpoint","success"],"title":"SshKeyDeleteResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /ssh-key/delete"}},"/api/ssh-keys/list/{asf_uid}":{"get":{"description":"\nList SSH keys by ASF UID.","operationId":"get_ssh_keys_list","parameters":[{"in":"path","name":"asf_uid","required":true,"schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"default":0,"title":"Offset","type":"integer"}},{"in":"query","name":"limit","schema":{"default":20,"title":"Limit","type":"integer"}}],"responses":{},"summary":"URL: GET /ssh-keys/list/<asf_uid>"}},"/api/task/get/{task_id}":{"get":{"operationId":"get_task_get","parameters":[{"in":"path","name":"task_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/task/get","title":"Endpoint","type":"string"},"task":{"$ref":"#/components/schemas/Task"}},"required":["endpoint","task"],"title":"TaskGetResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}]}},"/api/test/activate-project":{"post":{"description":"\nRestore a project to ACTIVE status (test mode only).","operationId":"post_test_activate_project","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"properties":{"project_key":{"title":"Project Key","type":"string"}},"required":["project_key"],"title":"TestProjectStatusArgs","type":"object"}}}},"responses":{},"summary":"URL: POST /test/activate-project"}},"/api/test/archive-project":{"post":{"description":"\nSet a project to DORMANT status, as a PMC archive does (test mode only).","operationId":"post_test_archive_project","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"properties":{"project_key":{"title":"Project Key","type":"string"}},"required":["project_key"],"title":"TestProjectStatusArgs","type":"object"}}}},"responses":{},"summary":"URL: POST /test/archive-project"}},"/api/user/info":{"get":{"description":"\nGet information about a user.","operationId":"get_user_info","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/user/info","title":"Endpoint","type":"string"},"member_of":{"example":["committee_key_a"],"items":{"type":"string"},"title":"Member Of","type":"array"},"participant_of":{"example":["committee_key_a","committee_key_b"],"items":{"type":"string"},"title":"Participant Of","type":"array"}},"required":["endpoint","participant_of","member_of"],"title":"UserInfoResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: GET /user/info"}},"/api/users/list":{"get":{"description":"\nList known users.\n\nThis is not a list of all ASF users, but only those known to ATR.","operationId":"get_users_list","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/users/list","title":"Endpoint","type":"string"},"users":{"example":["user1","user2"],"items":{"type":"string"},"title":"Users","type":"array"}},"required":["endpoint","users"],"title":"UsersListResults","type":"object"}}},"description":""}},"summary":"URL: GET /users/list"}},"/api/vote/cast":{"post":{"description":"\nCast a Trusted Vote ballot.","operationId":"post_vote_cast","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"choice":{"$ref":"#/components/schemas/VoteChoice","example":"+1"},"comment":{"default":"","example":"Looks good to me","title":"Comment","type":"string"},"project":{"example":"example","title":"Project","type":"string"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["project","version","choice"],"title":"VoteCastArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/vote/cast","title":"Endpoint","type":"string"},"receipt_email_to":{"example":["dev@example.apache.org"],"items":{"type":"string"},"title":"Receipt Email To","type":"array"},"success":{"const":true,"example":true,"title":"Success","type":"boolean"}},"required":["endpoint","success","receipt_email_to"],"title":"VoteCastResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /vote/cast"}},"/api/vote/resolve":{"post":{"description":"\nResolve a vote.\n\nA vote can be resolved as passed, failed, or cancelled.","operationId":"post_vote_resolve","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"early_reason":{"default":"","example":"Fix for a publicly known security issue","title":"Early Reason","type":"string"},"project":{"example":"example","title":"Project","type":"string"},"resolution":{"enum":["passed","failed","cancelled"],"example":"passed","title":"Resolution","type":"string"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["project","version","resolution"],"title":"VoteResolveArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/vote/resolve","title":"Endpoint","type":"string"},"success":{"const":true,"example":true,"title":"Success","type":"boolean"}},"required":["endpoint","success"],"title":"VoteResolveResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /vote/resolve"}},"/api/vote/start":{"post":{"description":"\nStart a vote.","operationId":"post_vote_start","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"automatic_publish_when_resolved":{"default":false,"example":false,"title":"Automatic Publish When Resolved","type":"boolean"},"automatic_resolve_when_finished":{"default":false,"example":false,"title":"Automatic Resolve When Finished","type":"boolean"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"The Apache Example team is pleased to announce the release of Example 0.0.1...","title":"Body"},"concerns_noted":{"default":[],"example":["atr.tasks.checks.license.headers"],"items":{"type":"string"},"title":"Concerns Noted","type":"array"},"email_bcc":{"default":[],"example":["dev@example.apache.org"],"items":{"type":"string"},"title":"Email Bcc","type":"array"},"email_cc":{"default":[],"example":["dev@example.apache.org"],"items":{"type":"string"},"title":"Email Cc","type":"array"},"email_to":{"example":"dev@example.apache.org","title":"Email To","type":"string"},"notify_when_finished":{"default":false,"example":false,"title":"Notify When Finished","type":"boolean"},"project":{"example":"example","title":"Project","type":"string"},"revision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"00005","title":"Revision"},"second_round_email_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"general@incubator.apache.org","title":"Second Round Email To"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"example":"[VOTE] Apache Example 0.0.1 release","title":"Subject"},"version":{"example":"0.0.1","title":"Version","type":"string"},"vote_duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"example":72,"title":"Vote Duration"}},"required":["project","version","email_to"],"title":"VoteStartArgs","type":"object"}}}},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"endpoint":{"const":"/vote/start","title":"Endpoint","type":"string"},"task":{"$ref":"#/components/schemas/Task"}},"required":["endpoint","task"],"title":"VoteStartResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /vote/start"}},"/api/vote/tabulate":{"post":{"description":"\nTabulate a vote. Public data which is available to all logged-in committers (JWT Auth).","operationId":"post_vote_tabulate","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"project":{"example":"example","title":"Project","type":"string"},"version":{"example":"0.0.1","title":"Version","type":"string"}},"required":["project","version"],"title":"VoteTabulateArgs","type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"details":{"anyOf":[{"$ref":"#/components/schemas/VoteDetails"},{"type":"null"}],"default":null},"endpoint":{"const":"/vote/tabulate","title":"Endpoint","type":"string"},"trusted_ballots":{"anyOf":[{"items":{"$ref":"#/components/schemas/TrustedBallotEntry"},"type":"array"},{"type":"null"}],"default":null,"title":"Trusted Ballots"},"trusted_passed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Trusted Passed"},"trusted_summary":{"anyOf":[{"$ref":"#/components/schemas/TrustedVoteSummary"},{"type":"null"}],"default":null},"vote_mode":{"$ref":"#/components/schemas/VoteMode","example":"email"},"vote_seq":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"example":1,"title":"Vote Seq"}},"required":["endpoint","vote_mode"],"title":"VoteTabulateResults","type":"object"}}},"description":""}},"security":[{"BearerAuth":[]}],"summary":"URL: POST /vote/tabulate"}}}}
