# Registry V3 - Versions

V3 versions endpoints

## List versions of packages

 - [GET /har/api/v3/versions](https://apidocs.harness.io/registry-v3-versions/listversionsv3.md): Lists versions of packages

## Delete a Version

 - [DELETE /har/api/v3/versions/{id}](https://apidocs.harness.io/registry-v3-versions/deleteversionv3.md): Delete a version (soft or hard delete based on deleteType parameter)

## List Conan Recipe Revisions

 - [GET /har/api/v3/versions/{id}/conan/recipe-revisions](https://apidocs.harness.io/registry-v3-versions/listconanreciperevisionsv3.md): List finalized Conan recipe revisions for a version.

## Get Conan Recipe Revision Detail

 - [GET /har/api/v3/versions/{id}/conan/recipe-revisions/{recipe_revision_id}/details](https://apidocs.harness.io/registry-v3-versions/getconanreciperevisiondetailv3.md): Get a Conan recipe revision (RREV) detail.

## List Conan Packages of a Recipe Revision

 - [GET /har/api/v3/versions/{id}/conan/recipe-revisions/{recipe_revision_id}/packages](https://apidocs.harness.io/registry-v3-versions/listconanpackagesv3.md): List the packages (PKGIDs) under a Conan recipe revision.

## Get Conan Package Detail

 - [GET /har/api/v3/versions/{id}/conan/recipe-revisions/{recipe_revision_id}/packages/{package_id}/details](https://apidocs.harness.io/registry-v3-versions/getconanpackagedetailv3.md): Get a Conan package (PKGID) detail with its package revisions.

## List Conan Package Revisions of a Package

 - [GET /har/api/v3/versions/{id}/conan/recipe-revisions/{recipe_revision_id}/packages/{package_id}/package-revisions](https://apidocs.harness.io/registry-v3-versions/listconanpackagerevisionsv3.md): List the package revisions (PREVs) under a Conan package.

## Get Conan Package Revision Detail

 - [GET /har/api/v3/versions/{id}/conan/recipe-revisions/{recipe_revision_id}/packages/{package_id}/package-revisions/{package_revision_id}/details](https://apidocs.harness.io/registry-v3-versions/getconanpackagerevisiondetailv3.md): Get a Conan package revision (PREV) detail.

## List deployments for a version

 - [GET /har/api/v3/versions/{id}/deployments](https://apidocs.harness.io/registry-v3-versions/listversiondeploymentsv3.md): List Harness CD deployments for a specific version. Returns the environments and services that are actively running this version, together with aggregate prod/non-prod counts in meta. For OCI-based package types (DOCKER, HELM) the artifact is identified by image:tag — supply package_tag or an empty response is returned. For all other package types the artifact is identified by package_name/version_name.

## Get Version Metadata

 - [GET /har/api/v3/versions/{id}/metadata](https://apidocs.harness.io/registry-v3-versions/getversionmetadatav3.md): Retrieves all metadata for a version.

## Upsert Version Metadata

 - [POST /har/api/v3/versions/{id}/metadata](https://apidocs.harness.io/registry-v3-versions/upsertversionmetadatav3.md): Creates or overwrites metadata for a version.

## Replace Version Metadata

 - [PUT /har/api/v3/versions/{id}/metadata](https://apidocs.harness.io/registry-v3-versions/saveversionmetadatav3.md): Replaces all metadata for a version.

## Restore a Soft-Deleted Version

 - [POST /har/api/v3/versions/{id}/restore](https://apidocs.harness.io/registry-v3-versions/restoreversionv3.md): Restore a previously soft-deleted version by ID

## Add tags to version of package

 - [POST /har/api/v3/versions/{id}/tags](https://apidocs.harness.io/registry-v3-versions/addversiontagsv3.md): Add tags to version of package. Currently supported for only OCI package.

## Rebuild metadata for all versions in a registry

 - [POST /har/api/v3/versions/rebuild-metadata](https://apidocs.harness.io/registry-v3-versions/rebuildversionmetadatav3.md): Trigger metadata rebuild for all versions in a registry

## Get statistics for multiple versions

 - [POST /har/api/v3/versions/stats](https://apidocs.harness.io/registry-v3-versions/getversionsstatsv3.md): Get statistics (deploymentMetadata, downloadCount, fileCount, scanStatus, scanID, size, artifactKey) for a list of versions by their UUIDs.