> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/artifact-registry/api-reference/registry-v3-registries.md).

# Registry V3 Registries

V3 registries endpoints

## List registries

> Lists registries.

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[{"description":"V3 registries endpoints","name":"Registry V3 - Registries"}],"servers":[{"url":"/api"}],"paths":{"/v3/registries":{"get":{"description":"Lists registries.","operationId":"ListRegistriesV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/OrgIdentifierV3"},{"$ref":"#/components/parameters/ProjectIdentifierV3"},{"$ref":"#/components/parameters/PackageTypeListParamV3"},{"$ref":"#/components/parameters/RegistryTypeParamV3"},{"$ref":"#/components/parameters/MetadataFilterListParamV3"},{"$ref":"#/components/parameters/RegistryScopeV3"},{"$ref":"#/components/parameters/DeleteFilterParamV3"},{"$ref":"#/components/parameters/SigningKeyIdFilterParamV3"},{"$ref":"#/components/parameters/IsInternalFilterParamV3"},{"$ref":"#/components/parameters/PageNumberV3"},{"$ref":"#/components/parameters/PageSizeV3"},{"$ref":"#/components/parameters/SortV3"},{"$ref":"#/components/parameters/SearchTermV3"},{"$ref":"#/components/parameters/IncludeMetaParamV3"}],"responses":{"200":{"$ref":"#/components/responses/ListRegistryResponseV3"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"List registries","tags":["Registry V3 - Registries"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"OrgIdentifierV3":{"description":"Unique identifier for the organization within the account.\n\nExample: `default` or `engineering_org`\n","in":"query","name":"org_identifier","schema":{"type":"string"}},"ProjectIdentifierV3":{"description":"Unique identifier for the project within the organization.\n\nExample: `my_project` or `frontend_services`\n","in":"query","name":"project_identifier","schema":{"type":"string"}},"PackageTypeListParamV3":{"description":"Registry Package Type","in":"query","name":"package_types","schema":{"items":{"type":"string"},"type":"array"}},"RegistryTypeParamV3":{"description":"Registry Type","in":"query","name":"type","schema":{"enum":["VIRTUAL","UPSTREAM"],"type":"string"}},"MetadataFilterListParamV3":{"description":"Filter by metadata using key:value format","in":"query","name":"metadata","schema":{"items":{"type":"string"},"type":"array"}},"RegistryScopeV3":{"description":"**Scope of registries to list**\n* **none** – current space only (default)   * **ancestors** – current space **plus** all parent spaces   * **descendants** – current space **plus** all child spaces  \nIf omitted, `none` is assumed.\n","in":"query","name":"scope","schema":{"enum":["ancestors","descendants","none"],"type":"string"}},"DeleteFilterParamV3":{"in":"query","name":"deleted","schema":{"default":"exclude","enum":["exclude","include","only"],"type":"string"}},"SigningKeyIdFilterParamV3":{"description":"Filter registries by signing key ID (UUID)","in":"query","name":"signing_key_id","schema":{"type":"string"}},"IsInternalFilterParamV3":{"description":"Filter registries by whether they are internal (system-managed).\n\nWhen `true`, only internal registries in the requested scope are returned.\nWhen `false`, only non-internal registries are returned. If omitted, both\ninternal and non-internal registries are returned.\n","in":"query","name":"is_internal","schema":{"type":"boolean"}},"PageNumberV3":{"description":"The page number for pagination (0-indexed).\n\nUsed to navigate through large result sets. Combined with `size` parameter\nto control which subset of results to return.\n\nExample: `page=0` returns the first page, `page=1` returns the second page\n","in":"query","name":"page","schema":{"default":0,"format":"int64","type":"integer"}},"PageSizeV3":{"description":"The number of items to return per page.\n\nControls the page size for paginated results. \n\nExample: `size=50` returns up to 50 items per page\n","in":"query","name":"size","schema":{"default":20,"format":"int64","maximum":100,"minimum":1,"type":"integer"}},"SortV3":{"description":"The sort for the results.\nAccepted pattern: `sort_field:sort_order` where sort_field is the field name\nand sort_order is either `asc` or `desc`.\n\nExamples: `name:asc`, `modifiedAt:desc`\n","in":"query","name":"sort","schema":{"type":"string"}},"SearchTermV3":{"description":"Search term for filtering results.\n\nExample: `search_term=prod` might match keys like \"production\", \"prod-env\", etc.\n","in":"query","name":"search_term","schema":{"type":"string"}},"IncludeMetaParamV3":{"description":"When `true`, include the `meta` object (e.g. active/deleted counts)\nin the response.\n","in":"query","name":"include_meta","schema":{"default":false,"type":"boolean"}}},"responses":{"ListRegistryResponseV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListRegistriesResponseBodyV3"}}},"description":"response for list registry"}},"schemas":{"ListRegistriesResponseBodyV3":{"allOf":[{"$ref":"#/components/schemas/PageInfoV3"},{"properties":{"items":{"items":{"$ref":"#/components/schemas/RegistryV3"},"type":"array"},"meta":{"$ref":"#/components/schemas/MetaV3"}},"required":["items"],"type":"object"}]},"PageInfoV3":{"description":"Pagination metadata.\n- `page` selects which page of results to return (0 = first page).\n- `size` controls how many items are returned per page.\n- `hasMore` is true if more results exist after this page.\n","properties":{"hasMore":{"description":"True if more results exist after this page.","type":"boolean"},"page":{"description":"The current page (0-indexed)","format":"int64","type":"integer"},"size":{"description":"Number of items per page","format":"int64","type":"integer"}},"required":["page","size","hasMore"],"type":"object"},"RegistryV3":{"description":"Registry Metadata","properties":{"deletedAt":{"$ref":"#/components/schemas/DeletedAtMsV3"},"deletedBy":{"$ref":"#/components/schemas/UserInfoV3"},"description":{"type":"string"},"id":{"format":"uuid","type":"string"},"isInternal":{"description":"Indicates that the registry is internal (system-managed).","type":"boolean"},"isPublic":{"type":"boolean"},"modifiedAt":{"$ref":"#/components/schemas/ModifiedAtMsV3"},"modifiedBy":{"$ref":"#/components/schemas/UserInfoV3"},"name":{"type":"string"},"opaMetadataValidation":{"type":"boolean"},"orgIdentifier":{"$ref":"#/components/schemas/orgIdentifier"},"packageType":{"$ref":"#/components/schemas/PackageTypeV3"},"path":{"type":"string"},"projectIdentifier":{"$ref":"#/components/schemas/projectIdentifier"},"type":{"$ref":"#/components/schemas/RegistryTypeV3"},"url":{"type":"string"}},"required":["id","name","type","packageType","isPublic","url"],"type":"object"},"DeletedAtMsV3":{"description":"Unix timestamp in milliseconds when the resource was soft-deleted","format":"int64","nullable":true,"type":"integer"},"UserInfoV3":{"description":"Structured user information for a principal","properties":{"display_name":{"description":"Human-readable display name","type":"string"},"email":{"description":"Email address","type":"string"},"type":{"description":"Principal type (user, service, service_account)","type":"string"},"uid":{"description":"Principal unique identifier (username)","type":"string"}},"type":"object"},"ModifiedAtMsV3":{"description":"Unix timestamp in milliseconds when the resource was last modified","format":"int64","nullable":true,"type":"integer"},"orgIdentifier":{"type":"string"},"PackageTypeV3":{"description":"Package type. Known values include: DOCKER, MAVEN, PYTHON, GENERIC, HELM, HELM_HTTP, NUGET, NPM, RPM, CARGO, COMPOSER, GO, HUGGINGFACE, CONDA, DART, SWIFT, PUPPET, RUBY, RAW, DEBIAN, CONAN, TERRAFORM, TERRAFORM_BACKEND, CRAN, WOLFI, ALPINE. This field is extensible; clients must handle unknown values.\n","type":"string"},"projectIdentifier":{"type":"string"},"RegistryTypeV3":{"description":"refers to type of registry i.e virtual or upstream","enum":["VIRTUAL","UPSTREAM"],"type":"string"},"MetaV3":{"description":"Metadata about the list response","properties":{"activeCount":{"description":"Count of active (non-deleted) entities","format":"int64","type":"integer"},"deletedCount":{"description":"Count of soft-deleted entities","format":"int64","type":"integer"}},"required":["activeCount","deletedCount"],"type":"object"},"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}}}}
```

## Create a Registry

> Creates a registry in the scope given by the account, org and project identifiers. The scope is taken from the query parameters, so the body carries no parent reference.<br>

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[{"description":"V3 registries endpoints","name":"Registry V3 - Registries"}],"servers":[{"url":"/api"}],"paths":{"/v3/registries":{"post":{"description":"Creates a registry in the scope given by the account, org and project identifiers. The scope is taken from the query parameters, so the body carries no parent reference.\n","operationId":"CreateRegistryV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/OrgIdentifierV3"},{"$ref":"#/components/parameters/ProjectIdentifierV3"}],"requestBody":{"$ref":"#/components/requestBodies/RegistryCreateRequestV3"},"responses":{"201":{"$ref":"#/components/responses/RegistryResponseV3"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"Create a Registry","tags":["Registry V3 - Registries"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"OrgIdentifierV3":{"description":"Unique identifier for the organization within the account.\n\nExample: `default` or `engineering_org`\n","in":"query","name":"org_identifier","schema":{"type":"string"}},"ProjectIdentifierV3":{"description":"Unique identifier for the project within the organization.\n\nExample: `my_project` or `frontend_services`\n","in":"query","name":"project_identifier","schema":{"type":"string"}}},"requestBodies":{"RegistryCreateRequestV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistryCreateBodyV3"}}},"description":"request body for creating a registry","required":true}},"schemas":{"RegistryCreateBodyV3":{"description":"Body for creating a registry. The parent scope comes from the\naccount_identifier, org_identifier and project_identifier query\nparameters, so there is no parent reference here.\n\n`cleanupPolicy` is not accepted. Cleanup policies are deprecated, so a new registry is\nnever created with one; the field is left out rather than accepted and discarded\nsilently. Policies on registries that already have them are reported by the single\nregistry responses and are not removed by this API.\n","properties":{"allowedPattern":{"description":"Patterns of artifacts allowed in this registry.","items":{"type":"string"},"type":"array"},"blockedPattern":{"description":"Patterns of artifacts blocked from this registry.","items":{"type":"string"},"type":"array"},"config":{"$ref":"#/components/schemas/RegistryConfigV3"},"description":{"description":"Human readable description of the registry.","type":"string"},"identifier":{"description":"Identifier of the registry, unique within the parent scope. This is the only identifier accepted on create, because no UUID exists yet.\n","type":"string"},"isPublic":{"description":"Whether the registry is readable without authentication.","type":"boolean"},"opaMetadataValidation":{"description":"Whether OPA metadata validation is enforced on this registry.","type":"boolean"},"packageType":{"$ref":"#/components/schemas/PackageTypeV3"},"policyRefs":{"description":"References to Harness OPA policy sets to apply to this registry. These are Harness platform entities addressed by identifier and scope across all of Harness, so they are not UUIDs.\n","items":{"type":"string"},"type":"array"},"scanners":{"description":"Vulnerability scanners to enable on this registry.","items":{"$ref":"#/components/schemas/ScannerV3"},"type":"array"}},"required":["identifier","packageType","config"],"type":"object"},"RegistryConfigV3":{"description":"Type-specific configuration for a registry. Discriminated by type: set type to VIRTUAL for a virtual registry or UPSTREAM for an upstream proxy, and supply the matching variant.\n","discriminator":{"mapping":{"UPSTREAM":"#/components/schemas/UpstreamConfigV3","VIRTUAL":"#/components/schemas/VirtualConfigV3"},"propertyName":"type"},"oneOf":[{"$ref":"#/components/schemas/VirtualConfigV3"},{"$ref":"#/components/schemas/UpstreamConfigV3"}],"properties":{"type":{"$ref":"#/components/schemas/RegistryTypeV3"}},"required":["type"],"type":"object"},"VirtualConfigV3":{"description":"Configuration for a virtual registry.","properties":{"debianConfig":{"$ref":"#/components/schemas/DebianConfigV3"},"signingConfig":{"$ref":"#/components/schemas/SigningConfigV3"},"upstreamProxies":{"description":"UUIDs of the upstream proxy registries this virtual registry resolves through, in resolution order. Note that v1 accepts upstream proxy *names* here; v3 uses UUIDs per the id-over-identifier rule.\n","items":{"format":"uuid","type":"string"},"type":"array"}},"type":"object"},"DebianConfigV3":{"description":"Debian-specific configuration. Applies only when packageType is DEBIAN.","properties":{"optionalIndexCompressionFormats":{"description":"Additional compression formats to generate for index and metadata files.","items":{"enum":[".xz"],"type":"string"},"type":"array"},"remoteIndexedArchitectures":{"default":["amd64","i386","arm64"],"description":"Architectures to index when building metadata from linked upstream registries.","items":{"type":"string"},"type":"array"}},"type":"object"},"SigningConfigV3":{"description":"Repository metadata signing configuration, e.g. GPG signing for Debian packages.","properties":{"keyId":{"description":"UUID of the signing key to use. The key must be ACTIVE and belong to the same account, org and project as the registry.\n","format":"uuid","nullable":true,"type":"string"},"signingEnabled":{"default":false,"description":"Whether metadata signing is enabled for this registry.","type":"boolean"}},"required":["signingEnabled"],"type":"object"},"UpstreamConfigV3":{"description":"Configuration for an upstream proxy registry.","properties":{"auth":{"$ref":"#/components/schemas/UpstreamAuthV3"},"authType":{"$ref":"#/components/schemas/UpstreamAuthTypeV3"},"firewallMode":{"$ref":"#/components/schemas/FirewallModeV3"},"metadataCacheTTL":{"description":"Time-to-live in seconds for cached upstream metadata. A duration, not a timestamp, so it is expressed in seconds rather than milliseconds.\n","format":"int64","maximum":604800,"minimum":0,"type":"integer"},"negativeCacheTTL":{"description":"Time-to-live in seconds for cached NOT_FOUND responses from the upstream. A duration, not a timestamp, so it is expressed in seconds rather than milliseconds.\n","format":"int64","maximum":604800,"minimum":0,"type":"integer"},"remoteUrlSuffix":{"description":"Optional path suffix appended to the remote URL for this registry. For Python upstreams this overrides the default `/simple` path used for PyPI-compatible indexes. Leading and trailing slashes are normalized away.\n","type":"string"},"signingConfig":{"$ref":"#/components/schemas/SigningConfigV3"},"source":{"$ref":"#/components/schemas/UpstreamSourceV3"},"url":{"description":"Remote URL of the upstream. Required when source is CUSTOM.","type":"string"}},"required":["authType"],"type":"object"},"UpstreamAuthV3":{"description":"Upstream credentials. The variant is selected by the sibling authType field rather than by a property on this object, so there is no discriminator here. Omit this object entirely when authType is ANONYMOUS.\n","oneOf":[{"$ref":"#/components/schemas/UpstreamAuthUserPasswordV3"},{"$ref":"#/components/schemas/UpstreamAuthAccessKeySecretKeyV3"},{"$ref":"#/components/schemas/UpstreamAuthBearerTokenV3"}]},"UpstreamAuthUserPasswordV3":{"description":"Username plus a password held in a Harness secret. Used when authType is USER_PASSWORD.","properties":{"secretIdentifier":{"description":"Identifier of the Harness secret holding the password. This is a Harness platform secret, addressed by identifier and scope across all of Harness, so it is not a UUID.\n","type":"string"},"secretSpaceId":{"format":"int64","type":"integer"},"secretSpacePath":{"type":"string"},"userName":{"type":"string"}},"required":["userName"],"type":"object"},"UpstreamAuthAccessKeySecretKeyV3":{"description":"Access key and secret key pair. Used when authType is ACCESS_KEY_SECRET_KEY.","properties":{"accessKey":{"description":"Plaintext access key. Mutually exclusive with accessKeySecretIdentifier.","type":"string"},"accessKeySecretIdentifier":{"description":"Identifier of the Harness secret holding the access key.","type":"string"},"accessKeySecretSpaceId":{"format":"int64","type":"integer"},"accessKeySecretSpacePath":{"type":"string"},"secretKeyIdentifier":{"description":"Identifier of the Harness secret holding the secret key.","type":"string"},"secretKeySpaceId":{"format":"int64","type":"integer"},"secretKeySpacePath":{"type":"string"}},"required":["secretKeyIdentifier"],"type":"object"},"UpstreamAuthBearerTokenV3":{"description":"Bearer token held in a Harness secret. Used when authType is BEARER_TOKEN.","properties":{"secretIdentifier":{"description":"Identifier of the Harness secret holding the bearer token.","type":"string"},"secretSpaceId":{"format":"int64","type":"integer"},"secretSpacePath":{"type":"string"}},"type":"object"},"UpstreamAuthTypeV3":{"description":"Authentication scheme used against the upstream. Known values include: USER_PASSWORD, ACCESS_KEY_SECRET_KEY, BEARER_TOKEN, ANONYMOUS. This field is extensible; clients must handle unknown values. ANONYMOUS takes no auth object.\n","type":"string"},"FirewallModeV3":{"description":"Firewall mode","enum":["ENABLED","QUARANTINE","ALLOW"],"type":"string"},"UpstreamSourceV3":{"description":"Well-known upstream this proxy points at. Known values include: DOCKERHUB, CUSTOM, AWS_ECR, MAVEN_CENTRAL, PYPI, NPMJS, NUGET_ORG, CRATES, RUBYGEMS, GO_PROXY, HUGGING_FACE, ANACONDA, PUBDEV, PACKAGIST, PUPPET_FORGE, HELM_CHART_REPO, CONAN_CENTER, TERRAFORM_REGISTRY, CRAN, WOLFI, ALPINE. This field is extensible; clients must handle unknown values. Use CUSTOM together with url for anything else.\n","type":"string"},"RegistryTypeV3":{"description":"refers to type of registry i.e virtual or upstream","enum":["VIRTUAL","UPSTREAM"],"type":"string"},"PackageTypeV3":{"description":"Package type. Known values include: DOCKER, MAVEN, PYTHON, GENERIC, HELM, HELM_HTTP, NUGET, NPM, RPM, CARGO, COMPOSER, GO, HUGGINGFACE, CONDA, DART, SWIFT, PUPPET, RUBY, RAW, DEBIAN, CONAN, TERRAFORM, TERRAFORM_BACKEND, CRAN, WOLFI, ALPINE. This field is extensible; clients must handle unknown values.\n","type":"string"},"ScannerV3":{"description":"A vulnerability scanner enabled on a registry.","properties":{"name":{"description":"Scanner name. Known values include: AQUA_TRIVY, GRYPE. This field is extensible; clients must handle unknown values.\n","type":"string"}},"type":"object"},"RegistryDetailV3":{"allOf":[{"$ref":"#/components/schemas/RegistryV3"},{"properties":{"allowedPattern":{"description":"Patterns of artifacts allowed in this registry.","items":{"type":"string"},"type":"array"},"blockedPattern":{"description":"Patterns of artifacts blocked from this registry.","items":{"type":"string"},"type":"array"},"cleanupPolicy":{"description":"Cleanup policies for this registry.","items":{"$ref":"#/components/schemas/CleanupPolicyV3"},"type":"array"},"config":{"$ref":"#/components/schemas/RegistryConfigV3"},"createdAt":{"$ref":"#/components/schemas/CreatedAtMsV3"},"policyRefs":{"description":"References to Harness OPA policy sets applied to this registry. These are Harness platform entities addressed by identifier and scope across all of Harness, so they are not UUIDs.\n","items":{"type":"string"},"type":"array"},"scanners":{"description":"Vulnerability scanners enabled on this registry.","items":{"$ref":"#/components/schemas/ScannerV3"},"type":"array"}},"type":"object"}],"description":"Full registry representation, returned by single-registry endpoints. Extends RegistryV3 with the nested settings that are too expensive to populate per item in list results.\n"},"RegistryV3":{"description":"Registry Metadata","properties":{"deletedAt":{"$ref":"#/components/schemas/DeletedAtMsV3"},"deletedBy":{"$ref":"#/components/schemas/UserInfoV3"},"description":{"type":"string"},"id":{"format":"uuid","type":"string"},"isInternal":{"description":"Indicates that the registry is internal (system-managed).","type":"boolean"},"isPublic":{"type":"boolean"},"modifiedAt":{"$ref":"#/components/schemas/ModifiedAtMsV3"},"modifiedBy":{"$ref":"#/components/schemas/UserInfoV3"},"name":{"type":"string"},"opaMetadataValidation":{"type":"boolean"},"orgIdentifier":{"$ref":"#/components/schemas/orgIdentifier"},"packageType":{"$ref":"#/components/schemas/PackageTypeV3"},"path":{"type":"string"},"projectIdentifier":{"$ref":"#/components/schemas/projectIdentifier"},"type":{"$ref":"#/components/schemas/RegistryTypeV3"},"url":{"type":"string"}},"required":["id","name","type","packageType","isPublic","url"],"type":"object"},"DeletedAtMsV3":{"description":"Unix timestamp in milliseconds when the resource was soft-deleted","format":"int64","nullable":true,"type":"integer"},"UserInfoV3":{"description":"Structured user information for a principal","properties":{"display_name":{"description":"Human-readable display name","type":"string"},"email":{"description":"Email address","type":"string"},"type":{"description":"Principal type (user, service, service_account)","type":"string"},"uid":{"description":"Principal unique identifier (username)","type":"string"}},"type":"object"},"ModifiedAtMsV3":{"description":"Unix timestamp in milliseconds when the resource was last modified","format":"int64","nullable":true,"type":"integer"},"orgIdentifier":{"type":"string"},"projectIdentifier":{"type":"string"},"CleanupPolicyV3":{"description":"A cleanup policy describing which versions a registry should expire.","properties":{"expireDays":{"description":"Delete matching versions older than this many days.","format":"int32","type":"integer"},"name":{"type":"string"},"packagePrefix":{"description":"Only packages whose name starts with one of these prefixes are considered.","items":{"type":"string"},"type":"array"},"versionPrefix":{"description":"Only versions whose name starts with one of these prefixes are considered.","items":{"type":"string"},"type":"array"}},"type":"object"},"CreatedAtMsV3":{"description":"Unix timestamp in milliseconds when the resource was created","format":"int64","nullable":true,"type":"integer"},"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}},"responses":{"RegistryResponseV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistryDetailV3"}}},"description":"response for a single registry"}}}}
```

## Get a Registry

> Retrieves a single registry by its UUID, including its configuration and other nested settings that are omitted from list results. Soft-deleted registries are returned as well, so that a caller holding a UUID can read one in order to restore it; \`deletedAt\` and \`deletedBy\` report the deletion.<br>

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[{"description":"V3 registries endpoints","name":"Registry V3 - Registries"}],"servers":[{"url":"/api"}],"paths":{"/v3/registries/{id}":{"get":{"description":"Retrieves a single registry by its UUID, including its configuration and other nested settings that are omitted from list results. Soft-deleted registries are returned as well, so that a caller holding a UUID can read one in order to restore it; `deletedAt` and `deletedBy` report the deletion.\n","operationId":"GetRegistryV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/OrgIdentifierV3"},{"$ref":"#/components/parameters/ProjectIdentifierV3"},{"$ref":"#/components/parameters/IdPathParamV3"}],"responses":{"200":{"$ref":"#/components/responses/RegistryResponseV3"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"Get a Registry","tags":["Registry V3 - Registries"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"OrgIdentifierV3":{"description":"Unique identifier for the organization within the account.\n\nExample: `default` or `engineering_org`\n","in":"query","name":"org_identifier","schema":{"type":"string"}},"ProjectIdentifierV3":{"description":"Unique identifier for the project within the organization.\n\nExample: `my_project` or `frontend_services`\n","in":"query","name":"project_identifier","schema":{"type":"string"}},"IdPathParamV3":{"in":"path","name":"id","required":true,"schema":{"type":"string"}}},"responses":{"RegistryResponseV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistryDetailV3"}}},"description":"response for a single registry"}},"schemas":{"RegistryDetailV3":{"allOf":[{"$ref":"#/components/schemas/RegistryV3"},{"properties":{"allowedPattern":{"description":"Patterns of artifacts allowed in this registry.","items":{"type":"string"},"type":"array"},"blockedPattern":{"description":"Patterns of artifacts blocked from this registry.","items":{"type":"string"},"type":"array"},"cleanupPolicy":{"description":"Cleanup policies for this registry.","items":{"$ref":"#/components/schemas/CleanupPolicyV3"},"type":"array"},"config":{"$ref":"#/components/schemas/RegistryConfigV3"},"createdAt":{"$ref":"#/components/schemas/CreatedAtMsV3"},"policyRefs":{"description":"References to Harness OPA policy sets applied to this registry. These are Harness platform entities addressed by identifier and scope across all of Harness, so they are not UUIDs.\n","items":{"type":"string"},"type":"array"},"scanners":{"description":"Vulnerability scanners enabled on this registry.","items":{"$ref":"#/components/schemas/ScannerV3"},"type":"array"}},"type":"object"}],"description":"Full registry representation, returned by single-registry endpoints. Extends RegistryV3 with the nested settings that are too expensive to populate per item in list results.\n"},"RegistryV3":{"description":"Registry Metadata","properties":{"deletedAt":{"$ref":"#/components/schemas/DeletedAtMsV3"},"deletedBy":{"$ref":"#/components/schemas/UserInfoV3"},"description":{"type":"string"},"id":{"format":"uuid","type":"string"},"isInternal":{"description":"Indicates that the registry is internal (system-managed).","type":"boolean"},"isPublic":{"type":"boolean"},"modifiedAt":{"$ref":"#/components/schemas/ModifiedAtMsV3"},"modifiedBy":{"$ref":"#/components/schemas/UserInfoV3"},"name":{"type":"string"},"opaMetadataValidation":{"type":"boolean"},"orgIdentifier":{"$ref":"#/components/schemas/orgIdentifier"},"packageType":{"$ref":"#/components/schemas/PackageTypeV3"},"path":{"type":"string"},"projectIdentifier":{"$ref":"#/components/schemas/projectIdentifier"},"type":{"$ref":"#/components/schemas/RegistryTypeV3"},"url":{"type":"string"}},"required":["id","name","type","packageType","isPublic","url"],"type":"object"},"DeletedAtMsV3":{"description":"Unix timestamp in milliseconds when the resource was soft-deleted","format":"int64","nullable":true,"type":"integer"},"UserInfoV3":{"description":"Structured user information for a principal","properties":{"display_name":{"description":"Human-readable display name","type":"string"},"email":{"description":"Email address","type":"string"},"type":{"description":"Principal type (user, service, service_account)","type":"string"},"uid":{"description":"Principal unique identifier (username)","type":"string"}},"type":"object"},"ModifiedAtMsV3":{"description":"Unix timestamp in milliseconds when the resource was last modified","format":"int64","nullable":true,"type":"integer"},"orgIdentifier":{"type":"string"},"PackageTypeV3":{"description":"Package type. Known values include: DOCKER, MAVEN, PYTHON, GENERIC, HELM, HELM_HTTP, NUGET, NPM, RPM, CARGO, COMPOSER, GO, HUGGINGFACE, CONDA, DART, SWIFT, PUPPET, RUBY, RAW, DEBIAN, CONAN, TERRAFORM, TERRAFORM_BACKEND, CRAN, WOLFI, ALPINE. This field is extensible; clients must handle unknown values.\n","type":"string"},"projectIdentifier":{"type":"string"},"RegistryTypeV3":{"description":"refers to type of registry i.e virtual or upstream","enum":["VIRTUAL","UPSTREAM"],"type":"string"},"CleanupPolicyV3":{"description":"A cleanup policy describing which versions a registry should expire.","properties":{"expireDays":{"description":"Delete matching versions older than this many days.","format":"int32","type":"integer"},"name":{"type":"string"},"packagePrefix":{"description":"Only packages whose name starts with one of these prefixes are considered.","items":{"type":"string"},"type":"array"},"versionPrefix":{"description":"Only versions whose name starts with one of these prefixes are considered.","items":{"type":"string"},"type":"array"}},"type":"object"},"RegistryConfigV3":{"description":"Type-specific configuration for a registry. Discriminated by type: set type to VIRTUAL for a virtual registry or UPSTREAM for an upstream proxy, and supply the matching variant.\n","discriminator":{"mapping":{"UPSTREAM":"#/components/schemas/UpstreamConfigV3","VIRTUAL":"#/components/schemas/VirtualConfigV3"},"propertyName":"type"},"oneOf":[{"$ref":"#/components/schemas/VirtualConfigV3"},{"$ref":"#/components/schemas/UpstreamConfigV3"}],"properties":{"type":{"$ref":"#/components/schemas/RegistryTypeV3"}},"required":["type"],"type":"object"},"VirtualConfigV3":{"description":"Configuration for a virtual registry.","properties":{"debianConfig":{"$ref":"#/components/schemas/DebianConfigV3"},"signingConfig":{"$ref":"#/components/schemas/SigningConfigV3"},"upstreamProxies":{"description":"UUIDs of the upstream proxy registries this virtual registry resolves through, in resolution order. Note that v1 accepts upstream proxy *names* here; v3 uses UUIDs per the id-over-identifier rule.\n","items":{"format":"uuid","type":"string"},"type":"array"}},"type":"object"},"DebianConfigV3":{"description":"Debian-specific configuration. Applies only when packageType is DEBIAN.","properties":{"optionalIndexCompressionFormats":{"description":"Additional compression formats to generate for index and metadata files.","items":{"enum":[".xz"],"type":"string"},"type":"array"},"remoteIndexedArchitectures":{"default":["amd64","i386","arm64"],"description":"Architectures to index when building metadata from linked upstream registries.","items":{"type":"string"},"type":"array"}},"type":"object"},"SigningConfigV3":{"description":"Repository metadata signing configuration, e.g. GPG signing for Debian packages.","properties":{"keyId":{"description":"UUID of the signing key to use. The key must be ACTIVE and belong to the same account, org and project as the registry.\n","format":"uuid","nullable":true,"type":"string"},"signingEnabled":{"default":false,"description":"Whether metadata signing is enabled for this registry.","type":"boolean"}},"required":["signingEnabled"],"type":"object"},"UpstreamConfigV3":{"description":"Configuration for an upstream proxy registry.","properties":{"auth":{"$ref":"#/components/schemas/UpstreamAuthV3"},"authType":{"$ref":"#/components/schemas/UpstreamAuthTypeV3"},"firewallMode":{"$ref":"#/components/schemas/FirewallModeV3"},"metadataCacheTTL":{"description":"Time-to-live in seconds for cached upstream metadata. A duration, not a timestamp, so it is expressed in seconds rather than milliseconds.\n","format":"int64","maximum":604800,"minimum":0,"type":"integer"},"negativeCacheTTL":{"description":"Time-to-live in seconds for cached NOT_FOUND responses from the upstream. A duration, not a timestamp, so it is expressed in seconds rather than milliseconds.\n","format":"int64","maximum":604800,"minimum":0,"type":"integer"},"remoteUrlSuffix":{"description":"Optional path suffix appended to the remote URL for this registry. For Python upstreams this overrides the default `/simple` path used for PyPI-compatible indexes. Leading and trailing slashes are normalized away.\n","type":"string"},"signingConfig":{"$ref":"#/components/schemas/SigningConfigV3"},"source":{"$ref":"#/components/schemas/UpstreamSourceV3"},"url":{"description":"Remote URL of the upstream. Required when source is CUSTOM.","type":"string"}},"required":["authType"],"type":"object"},"UpstreamAuthV3":{"description":"Upstream credentials. The variant is selected by the sibling authType field rather than by a property on this object, so there is no discriminator here. Omit this object entirely when authType is ANONYMOUS.\n","oneOf":[{"$ref":"#/components/schemas/UpstreamAuthUserPasswordV3"},{"$ref":"#/components/schemas/UpstreamAuthAccessKeySecretKeyV3"},{"$ref":"#/components/schemas/UpstreamAuthBearerTokenV3"}]},"UpstreamAuthUserPasswordV3":{"description":"Username plus a password held in a Harness secret. Used when authType is USER_PASSWORD.","properties":{"secretIdentifier":{"description":"Identifier of the Harness secret holding the password. This is a Harness platform secret, addressed by identifier and scope across all of Harness, so it is not a UUID.\n","type":"string"},"secretSpaceId":{"format":"int64","type":"integer"},"secretSpacePath":{"type":"string"},"userName":{"type":"string"}},"required":["userName"],"type":"object"},"UpstreamAuthAccessKeySecretKeyV3":{"description":"Access key and secret key pair. Used when authType is ACCESS_KEY_SECRET_KEY.","properties":{"accessKey":{"description":"Plaintext access key. Mutually exclusive with accessKeySecretIdentifier.","type":"string"},"accessKeySecretIdentifier":{"description":"Identifier of the Harness secret holding the access key.","type":"string"},"accessKeySecretSpaceId":{"format":"int64","type":"integer"},"accessKeySecretSpacePath":{"type":"string"},"secretKeyIdentifier":{"description":"Identifier of the Harness secret holding the secret key.","type":"string"},"secretKeySpaceId":{"format":"int64","type":"integer"},"secretKeySpacePath":{"type":"string"}},"required":["secretKeyIdentifier"],"type":"object"},"UpstreamAuthBearerTokenV3":{"description":"Bearer token held in a Harness secret. Used when authType is BEARER_TOKEN.","properties":{"secretIdentifier":{"description":"Identifier of the Harness secret holding the bearer token.","type":"string"},"secretSpaceId":{"format":"int64","type":"integer"},"secretSpacePath":{"type":"string"}},"type":"object"},"UpstreamAuthTypeV3":{"description":"Authentication scheme used against the upstream. Known values include: USER_PASSWORD, ACCESS_KEY_SECRET_KEY, BEARER_TOKEN, ANONYMOUS. This field is extensible; clients must handle unknown values. ANONYMOUS takes no auth object.\n","type":"string"},"FirewallModeV3":{"description":"Firewall mode","enum":["ENABLED","QUARANTINE","ALLOW"],"type":"string"},"UpstreamSourceV3":{"description":"Well-known upstream this proxy points at. Known values include: DOCKERHUB, CUSTOM, AWS_ECR, MAVEN_CENTRAL, PYPI, NPMJS, NUGET_ORG, CRATES, RUBYGEMS, GO_PROXY, HUGGING_FACE, ANACONDA, PUBDEV, PACKAGIST, PUPPET_FORGE, HELM_CHART_REPO, CONAN_CENTER, TERRAFORM_REGISTRY, CRAN, WOLFI, ALPINE. This field is extensible; clients must handle unknown values. Use CUSTOM together with url for anything else.\n","type":"string"},"CreatedAtMsV3":{"description":"Unix timestamp in milliseconds when the resource was created","format":"int64","nullable":true,"type":"integer"},"ScannerV3":{"description":"A vulnerability scanner enabled on a registry.","properties":{"name":{"description":"Scanner name. Known values include: AQUA_TRIVY, GRYPE. This field is extensible; clients must handle unknown values.\n","type":"string"}},"type":"object"},"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}}}}
```

## Get Registry Metadata

> Retrieves all metadata for a registry.

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[{"description":"V3 registries endpoints","name":"Registry V3 - Registries"}],"servers":[{"url":"/api"}],"paths":{"/v3/registries/{id}/metadata":{"get":{"description":"Retrieves all metadata for a registry.","operationId":"GetRegistryMetadataV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/IdPathParamV3"}],"responses":{"200":{"$ref":"#/components/responses/MetadataResponseV3"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"Get Registry Metadata","tags":["Registry V3 - Registries"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"IdPathParamV3":{"in":"path","name":"id","required":true,"schema":{"type":"string"}}},"responses":{"MetadataResponseV3":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Array of metadata entries","items":{"$ref":"#/components/schemas/MetadataV3"},"type":"array"}},"required":["data"],"type":"object"}}},"description":"Response containing all metadata entries for the requested entity"}},"schemas":{"MetadataV3":{"description":"Metadata entry","properties":{"id":{"description":"Unique identifier for this metadata entry","format":"uuid","type":"string"},"key":{"description":"The metadata key name","type":"string"},"type":{"$ref":"#/components/schemas/MetadataTypeV3"},"value":{"description":"The metadata value","type":"string"}},"required":["id","key","value","type"],"type":"object"},"MetadataTypeV3":{"description":"Indicates if metadata was manually added (MANUAL) or system-generated (AUTO)","enum":["MANUAL","AUTO"],"type":"string"},"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}}}}
```

## Upsert Registry Metadata

> Creates or overwrites metadata for a registry.

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[{"description":"V3 registries endpoints","name":"Registry V3 - Registries"}],"servers":[{"url":"/api"}],"paths":{"/v3/registries/{id}/metadata":{"post":{"description":"Creates or overwrites metadata for a registry.","operationId":"UpsertRegistryMetadataV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/IdPathParamV3"}],"requestBody":{"$ref":"#/components/requestBodies/MetadataRequestV3"},"responses":{"200":{"$ref":"#/components/responses/MetadataResponseV3"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"Upsert Registry Metadata","tags":["Registry V3 - Registries"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"IdPathParamV3":{"in":"path","name":"id","required":true,"schema":{"type":"string"}}},"requestBodies":{"MetadataRequestV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetadataInputV3"}}},"description":"Request body containing metadata key-value pairs to add or update"}},"schemas":{"MetadataInputV3":{"description":"Request payload containing metadata key-value pairs to add or update.\n","properties":{"metadata":{"description":"Array of metadata key-value pairs","items":{"$ref":"#/components/schemas/MetadataItemInputV3"},"maxItems":50,"minItems":1,"type":"array"}},"required":["metadata"],"type":"object"},"MetadataItemInputV3":{"description":"Metadata key-value pair for create/update operations","properties":{"key":{"description":"The metadata key name (case-sensitive)","maxLength":128,"minLength":1,"type":"string"},"value":{"description":"The metadata value","maxLength":256,"minLength":1,"type":"string"}},"required":["key","value"],"type":"object"},"MetadataV3":{"description":"Metadata entry","properties":{"id":{"description":"Unique identifier for this metadata entry","format":"uuid","type":"string"},"key":{"description":"The metadata key name","type":"string"},"type":{"$ref":"#/components/schemas/MetadataTypeV3"},"value":{"description":"The metadata value","type":"string"}},"required":["id","key","value","type"],"type":"object"},"MetadataTypeV3":{"description":"Indicates if metadata was manually added (MANUAL) or system-generated (AUTO)","enum":["MANUAL","AUTO"],"type":"string"},"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}},"responses":{"MetadataResponseV3":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Array of metadata entries","items":{"$ref":"#/components/schemas/MetadataV3"},"type":"array"}},"required":["data"],"type":"object"}}},"description":"Response containing all metadata entries for the requested entity"}}}}
```

## Replace Registry Metadata

> Replaces all metadata for a registry.

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[{"description":"V3 registries endpoints","name":"Registry V3 - Registries"}],"servers":[{"url":"/api"}],"paths":{"/v3/registries/{id}/metadata":{"put":{"description":"Replaces all metadata for a registry.","operationId":"SaveRegistryMetadataV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/IdPathParamV3"}],"requestBody":{"$ref":"#/components/requestBodies/MetadataRequestV3"},"responses":{"200":{"$ref":"#/components/responses/MetadataResponseV3"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"Replace Registry Metadata","tags":["Registry V3 - Registries"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"IdPathParamV3":{"in":"path","name":"id","required":true,"schema":{"type":"string"}}},"requestBodies":{"MetadataRequestV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetadataInputV3"}}},"description":"Request body containing metadata key-value pairs to add or update"}},"schemas":{"MetadataInputV3":{"description":"Request payload containing metadata key-value pairs to add or update.\n","properties":{"metadata":{"description":"Array of metadata key-value pairs","items":{"$ref":"#/components/schemas/MetadataItemInputV3"},"maxItems":50,"minItems":1,"type":"array"}},"required":["metadata"],"type":"object"},"MetadataItemInputV3":{"description":"Metadata key-value pair for create/update operations","properties":{"key":{"description":"The metadata key name (case-sensitive)","maxLength":128,"minLength":1,"type":"string"},"value":{"description":"The metadata value","maxLength":256,"minLength":1,"type":"string"}},"required":["key","value"],"type":"object"},"MetadataV3":{"description":"Metadata entry","properties":{"id":{"description":"Unique identifier for this metadata entry","format":"uuid","type":"string"},"key":{"description":"The metadata key name","type":"string"},"type":{"$ref":"#/components/schemas/MetadataTypeV3"},"value":{"description":"The metadata value","type":"string"}},"required":["id","key","value","type"],"type":"object"},"MetadataTypeV3":{"description":"Indicates if metadata was manually added (MANUAL) or system-generated (AUTO)","enum":["MANUAL","AUTO"],"type":"string"},"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}},"responses":{"MetadataResponseV3":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Array of metadata entries","items":{"$ref":"#/components/schemas/MetadataV3"},"type":"array"}},"required":["data"],"type":"object"}}},"description":"Response containing all metadata entries for the requested entity"}}}}
```

## Get registry public key

> Returns the public key for the signing key attached to a registry.\
> This is a public endpoint (no auth required) used by package managers\
> (apt, apk) to fetch the repository signing key.<br>

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[{"description":"V3 registries endpoints","name":"Registry V3 - Registries"}],"servers":[{"url":"/api"}],"paths":{"/v3/registries/{id}/public-key":{"get":{"description":"Returns the public key for the signing key attached to a registry.\nThis is a public endpoint (no auth required) used by package managers\n(apt, apk) to fetch the repository signing key.\n","operationId":"GetRegistryPublicKeyV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/IdPathParamV3"}],"responses":{"200":{"content":{"text/plain":{"schema":{"type":"string"}}},"description":"Public key content"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"Get registry public key","tags":["Registry V3 - Registries"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"IdPathParamV3":{"in":"path","name":"id","required":true,"schema":{"type":"string"}}},"schemas":{"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}}}}
```

## Rebuild the index for a registry

> Trigger an asynchronous rebuild of the repository index for the given registry. The rebuild runs in the background; this endpoint returns immediately once the request is accepted. Index rebuild is package-type specific. Registries whose package type does not maintain a rebuildable index return 405.

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[{"description":"V3 registries endpoints","name":"Registry V3 - Registries"}],"servers":[{"url":"/api"}],"paths":{"/v3/registries/{id}/rebuild-index":{"post":{"description":"Trigger an asynchronous rebuild of the repository index for the given registry. The rebuild runs in the background; this endpoint returns immediately once the request is accepted. Index rebuild is package-type specific. Registries whose package type does not maintain a rebuildable index return 405.","operationId":"RebuildRegistryIndexV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/IdPathParamV3"}],"responses":{"202":{"$ref":"#/components/responses/RebuildRegistryIndexAcceptedV3"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Index rebuild is not supported for this registry's package type."},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"Rebuild the index for a registry","tags":["Registry V3 - Registries"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"IdPathParamV3":{"in":"path","name":"id","required":true,"schema":{"type":"string"}}},"responses":{"RebuildRegistryIndexAcceptedV3":{"description":"Registry index rebuild request accepted for processing"}},"schemas":{"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}}}}
```

## Get statistics for multiple registries

> Get statistics (packageCount, size, downloadCount, artifactsCount) for a list of registries by their UUIDs.

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[{"description":"V3 registries endpoints","name":"Registry V3 - Registries"}],"servers":[{"url":"/api"}],"paths":{"/v3/registries/stats":{"post":{"description":"Get statistics (packageCount, size, downloadCount, artifactsCount) for a list of registries by their UUIDs.","operationId":"GetRegistriesStatsV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/OrgIdentifierV3"},{"$ref":"#/components/parameters/ProjectIdentifierV3"},{"$ref":"#/components/parameters/RegistryScopeV3"}],"requestBody":{"$ref":"#/components/requestBodies/RegistriesStatsRequestV3"},"responses":{"200":{"$ref":"#/components/responses/RegistriesStatsResponseV3"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"Get statistics for multiple registries","tags":["Registry V3 - Registries"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"OrgIdentifierV3":{"description":"Unique identifier for the organization within the account.\n\nExample: `default` or `engineering_org`\n","in":"query","name":"org_identifier","schema":{"type":"string"}},"ProjectIdentifierV3":{"description":"Unique identifier for the project within the organization.\n\nExample: `my_project` or `frontend_services`\n","in":"query","name":"project_identifier","schema":{"type":"string"}},"RegistryScopeV3":{"description":"**Scope of registries to list**\n* **none** – current space only (default)   * **ancestors** – current space **plus** all parent spaces   * **descendants** – current space **plus** all child spaces  \nIf omitted, `none` is assumed.\n","in":"query","name":"scope","schema":{"enum":["ancestors","descendants","none"],"type":"string"}}},"requestBodies":{"RegistriesStatsRequestV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistriesStatsRequestInputV3"}}},"description":"Request body containing list of registry UUIDs to fetch stats for","required":true}},"schemas":{"RegistriesStatsRequestInputV3":{"description":"Request input for fetching registry statistics","properties":{"registryIds":{"description":"List of registry UUIDs to fetch statistics for","items":{"format":"uuid","type":"string"},"maxItems":100,"type":"array"}},"required":["registryIds"],"type":"object"},"RegistriesStatsResponseBodyV3":{"description":"Response body containing registry statistics","properties":{"items":{"description":"List of registry statistics","items":{"$ref":"#/components/schemas/RegistryStatsV3"},"type":"array"}},"required":["items"],"type":"object"},"RegistryStatsV3":{"description":"Statistics for a single registry","properties":{"artifactsCount":{"description":"Total number of artifacts in the registry","format":"int64","type":"integer"},"downloadCount":{"description":"Total download count for the registry","format":"int64","type":"integer"},"id":{"description":"Registry UUID","format":"uuid","type":"string"},"packageCount":{"description":"Total number of packages in the registry","format":"int64","type":"integer"},"size":{"description":"Total size of the registry (human-readable format)","type":"string"}},"required":["id"],"type":"object"},"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}},"responses":{"RegistriesStatsResponseV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistriesStatsResponseBodyV3"}}},"description":"Response containing statistics for the requested registries"}}}}
```
