Harness

Harness Registry V3 - Versions API

V3 versions endpoints

GitHub OpenAPI

Operations 16

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /har/api/v3/versions List package versions in the artifact registry · List versions of packages #
Ask an LLM
“Which package versions are stored in my Harness Artifact Registry?”
“Can I list only the versions that were soft-deleted?”
Tell an agent
List package versions in account {account}.
List versions of packages {packages} in registry {registry} for account {account}.
DELETE /har/api/v3/versions/{id} Delete a package version · Delete a Version #
Ask an LLM
“How do I delete one version of a package from the registry?”
“Can I permanently remove a version rather than soft-deleting it?”
Tell an agent destructive · confirm first
Delete package version {version} in account {account}.
Hard delete version {version} with force set to {force} in account {account}.
GET /har/api/v3/versions/{id}/conan/recipe-revisions List Conan recipe revisions for a version · List Conan Recipe Revisions #
Ask an LLM
“What Conan recipe revisions (RREVs) exist for this package version?”
“Can I page through finalized recipe revisions of a Conan version?”
Tell an agent
List Conan recipe revisions of version {version} in account {account}.
Show page {page} of recipe revisions for Conan version {version} (account {account}).
GET /har/api/v3/versions/{id}/conan/recipe-revisions/{recipe_revision_id}/details Get details of a Conan recipe revision · Get Conan Recipe Revision Detail #
Ask an LLM
“What's recorded about a specific Conan recipe revision?”
“Can I inspect one RREV of a Conan package version?”
Tell an agent
Get details of recipe revision {rrev} for version {version} in account {account}.
Show the Conan RREV {rrev} under version {version} for account {account}.
GET /har/api/v3/versions/{id}/conan/recipe-revisions/{recipe_revision_id}/packages List Conan packages under a recipe revision · List Conan Packages of a Recipe Revision #
Ask an LLM
“Which binary packages (PKGIDs) were built for a Conan recipe revision?”
“How many Conan packages sit under one recipe revision?”
Tell an agent
List packages under recipe revision {rrev} of version {version} in account {account}.
Show the PKGIDs built for Conan recipe revision {rrev}, version {version}, account {account}.
GET /har/api/v3/versions/{id}/conan/recipe-revisions/{recipe_revision_id}/packages/{package_id}/details Get a Conan package and its revisions · Get Conan Package Detail #
Ask an LLM
“What details and package revisions are attached to a specific Conan PKGID?”
“Can I look up one Conan binary package by its package ID?”
Tell an agent
Get details of Conan package {package} in recipe revision {rrev}, version {version}, account {account}.
Show PKGID {package} with its revisions for RREV {rrev} of version {version} (account {account}).
GET /har/api/v3/versions/{id}/conan/recipe-revisions/{recipe_revision_id}/packages/{package_id}/package-revisions List revisions of a Conan package · List Conan Package Revisions of a Package #
Ask an LLM
“What package revisions (PREVs) exist for a Conan binary package?”
“Can I page through the PREVs of one Conan PKGID?”
Tell an agent
List package revisions of {package} under RREV {rrev}, version {version}, account {account}.
Page through PREVs for Conan package {package} (RREV {rrev}, version {version}, account {account}).
GET /har/api/v3/versions/{id}/conan/recipe-revisions/{recipe_revision_id}/packages/{package_id}/package-revisions/{package_revision_id}/details Get details of a Conan package revision · Get Conan Package Revision Detail #
Ask an LLM
“What's recorded for one specific Conan package revision (PREV)?”
“Can I drill all the way down to a single PREV of a Conan binary?”
Tell an agent
Get PREV {prev} of package {package}, RREV {rrev}, version {version} in account {account}.
Show detail for Conan package revision {prev} under package {package} (RREV {rrev}, version {version}, account {account}).
GET /har/api/v3/versions/{id}/deployments See where a package version is deployed · List deployments for a version #
Ask an LLM
“Which environments and services are currently running this artifact version?”
“Is this version deployed to production, or only to non-prod environments?”
Tell an agent
List the deployments running version {version} in account {account}.
Show {env_type} environments where version {version} is deployed (account {account}).
GET /har/api/v3/versions/{id}/metadata Get the metadata of a package version · Get Version Metadata #
Ask an LLM
“What key-value metadata is attached to this package version?”
“Can I read all custom metadata on a registry version?”
Tell an agent
Get all metadata for version {version} in account {account}.
Show the metadata labels on package version {version} for account {account}.
POST /har/api/v3/versions/{id}/metadata Add or update metadata keys on a version · Upsert Version Metadata #
Ask an LLM
“Can I add a new metadata key to a version without replacing the existing ones?”
“How do I set or overwrite individual metadata values on a package version?”
Tell an agent
Upsert metadata {metadata} onto version {version} in account {account}.
Add or overwrite the keys {metadata} on package version {version} for account {account}.
PUT /har/api/v3/versions/{id}/metadata Replace all metadata on a package version · Replace Version Metadata #
Ask an LLM
“How do I overwrite every metadata entry on a version with a fresh set?”
“Does replacing version metadata drop keys I leave out?”
Tell an agent
Replace all metadata on version {version} with {metadata} in account {account}.
Wipe and reset the metadata of version {version} to {metadata} (account {account}).
POST /har/api/v3/versions/{id}/restore Restore a soft-deleted package version · Restore a Soft-Deleted Version #
Ask an LLM
“Can I bring back a package version I soft-deleted by mistake?”
“How do I undelete a version in the artifact registry?”
Tell an agent
Restore soft-deleted version {version} in account {account}.
Undelete package version {version} for account {account}.
POST /har/api/v3/versions/{id}/tags Add tags to an OCI package version · Add tags to version of package #
Ask an LLM
“How do I add extra tags to an existing container image version in the registry?”
“Which package types support adding tags to a version?”
Tell an agent
Add tags {tags} to version {version} in account {account}.
Tag OCI image version {version} as {tags} for account {account}.
POST /har/api/v3/versions/rebuild-metadata Rebuild metadata for every version in a registry · Rebuild metadata for all versions in a registry #
Ask an LLM
“Can I regenerate the metadata for all versions in a registry at once?”
“How do I trigger a registry-wide metadata rebuild?”
Tell an agent
Rebuild metadata for all versions in registry {registry}, account {account}.
Trigger a full version metadata rebuild on registry {registry} (account {account}).
POST /har/api/v3/versions/stats Get download, size and scan stats for versions · Get statistics for multiple versions #
Ask an LLM
“How many times have these package versions been downloaded, and how big are they?”
“What's the scan status for a batch of versions by UUID?”
Tell an agent
Get statistics for versions {versions} in account {account}.
Show download counts, file counts and scan status for versions {versions} (account {account}).

Documentation

📖
Documentation
https://apidocs.harness.io
📖
APIReference
https://apidocs.harness.io
📖
GettingStarted
https://developer.harness.io/docs/platform/automation/api/api-quickstart/
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/authentication/harness-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/rate-limits/harness-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/openapi/harness-registry-v3-versions-api-openapi.yml

Other Resources

🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/scopes/harness-scopes.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/errors/harness-error-codes.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/conventions/harness-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/conventions/harness-conventions.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/harness:harness-registry-v3-versions-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

harness-registry-v3-versions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Harness Registry V3 - Versions API
  version: '1.0'
  description: The Harness Software Delivery Platform uses OpenAPI Specification v3.0.
  contact:
    name: API Support
    email: contact@harness.io
    url: https://harness.io/
  x-logo:
    url: https://mma.prnewswire.com/media/779232/Harnes_logo_horizontal.jpg?p=facebook
    altText: Harness
  termsOfService: https://harness.io/terms-of-use/
servers:
- url: https://app.harness.io
  description: Harness host URL
- url: https://{vanity}
  description: Vanity URL
  variables:
    vanity:
      default: app.harness.io
security:
- x-api-key: []
tags:


# --- truncated at 32 KB (48 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/openapi/harness-registry-v3-versions-api-openapi.yml