Harness

Harness Artifacts API

APIs to get, list artifacts

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/v1/registry/{registry_identifier}/artifact/{artifact}/redirect Open an artifact's page in the registry UI · Redirect to Harness Artifact Page #
Ask an LLM
“Is there a link that redirects straight to an artifact's page in Harness Artifact Registry?”
“Can I jump to the UI page for a particular version of an artifact?”
Tell an agent
Redirect me to the page for artifact {artifact} in registry {registry}.
Open the registry page for {artifact} version {version} in {registry}.
DELETE /har/api/v1/registry/{registry_ref}/artifact/{artifact} Delete an artifact and all its versions · Delete Artifact #
Ask an LLM
“How do I delete an entire artifact from a Harness registry?”
“Can I remove a package along with every version it has?”
Tell an agent destructive · confirm first
Delete artifact {artifact} from registry {registry}.
Remove the whole {artifact} package, all versions, from {registry}.
PUT /har/api/v1/registry/{registry_ref}/artifact/{artifact}/labels Set the labels on an artifact · Update Artifact Labels #
Ask an LLM
“How do I add or change labels on an artifact in my registry?”
“Can I replace an artifact's labels in one request?”
Tell an agent
Set the labels on artifact {artifact} in {registry} to {labels}.
Label {artifact} in registry {registry} as {labels}.
GET /har/api/v1/registry/{registry_ref}/artifact/{artifact}/stats Get download and usage stats for one artifact · Get Artifact Stats #
Ask an LLM
“How many downloads has a specific artifact had over a date range?”
“What are the usage stats for one package in my registry?”
Tell an agent
Get stats for artifact {artifact} in {registry} from {from} to {to}.
Show usage statistics for the {artifact} artifact in registry {registry}.
GET /har/api/v1/registry/{registry_ref}/artifact/{artifact}/summary Get a summary of an artifact · Get Artifact Summary #
Ask an LLM
“What's the overview of an artifact, like its type and latest version?”
“Can I get a quick summary of a package across all its versions?”
Tell an agent
Summarize artifact {artifact} in registry {registry}.
Give me the artifact-level summary for {artifact} of type {type} in {registry}.
GET /har/api/v1/registry/{registry_ref}/artifact/{artifact}/tags List tags of an OCI image · List OCI Artifact tags #
Ask an LLM
“Which tags exist for a container image in my Harness registry?”
“Can I search an OCI artifact's tags by name?”
Tell an agent
List the OCI tags for image {artifact} in registry {registry}.
Find tags on image {artifact} in {registry} matching {term}.
DELETE /har/api/v1/registry/{registry_ref}/artifact/{artifact}/version/{version} Delete one version of an artifact · Delete an Artifact Version #
Ask an LLM
“How do I delete a single version of a package without removing the others?”
“Can I remove one bad release of an artifact from the registry?”
Tell an agent destructive · confirm first
Delete version {version} of artifact {artifact} in {registry}.
Remove only release {version} of {artifact} from registry {registry}.
GET /har/api/v1/registry/{registry_ref}/artifact/{artifact}/version/{version}/bulk-download Request a bulk download of an artifact version · Create a bulk download request #
Ask an LLM
“Can I download all the files of an artifact version in one bulk request?”
“How do I start a bulk download for a specific package version?”
Tell an agent
Create a bulk download request for {artifact} version {version} in {registry}.
Start a bulk download of every file in {artifact}:{version} from registry {registry}.
GET /har/api/v1/registry/{registry_ref}/artifact/{artifact}/version/{version}/deploymentdetails See where an artifact version is deployed · Describe Artifact Deployments #
Ask an LLM
“Which environments is this artifact version deployed to?”
“Can I filter an artifact version's deployments to production environments only?”
Tell an agent
Show deployments of {artifact} version {version} from registry {registry}.
List where {artifact}:{version} in {registry} is deployed in {env_type} environments.
GET /har/api/v1/registry/{registry_ref}/artifact/{artifact}/version/{version}/details Get full details of an artifact version · Describe Artifact Details #
Ask an LLM
“What are the full details of a specific artifact version, including child versions?”
“Can I see the metadata recorded for one release of a package?”
Tell an agent
Get details for {artifact} version {version} in registry {registry}.
Describe child version {child} of {artifact}:{version} in {registry}.
GET /har/api/v1/registry/{registry_ref}/artifact/{artifact}/version/{version}/file/{file_name} Check a file exists in an artifact version · Get Artifact file #
Ask an LLM
“Does a given file exist inside a specific artifact version?”
“Can I validate that a named file was published with a package release?”
Tell an agent
Check that file {file} exists in {artifact} version {version} in {registry}.
Confirm {file} was published with {artifact}:{version} in registry {registry}.
GET /har/api/v1/registry/{registry_ref}/artifact/{artifact}/version/{version}/files List the files in an artifact version · Describe Artifact files #
Ask an LLM
“What files make up a particular artifact version?”
“Can I search the file list of a package release by name?”
Tell an agent
List files in {artifact} version {version} in registry {registry}.
Find files named like {term} in {artifact}:{version} from {registry}.
GET /har/api/v1/registry/{registry_ref}/artifact/{artifact}/version/{version}/summary Get a summary of one artifact version · Get Artifact Version Summary #
Ask an LLM
“What's the at-a-glance summary for one version of an artifact?”
“Can I summarize an image version by its digest?”
Tell an agent
Summarize version {version} of {artifact} in {registry}.
Give the version summary of {artifact}:{version} in {registry} for digest {digest}.
GET /har/api/v1/registry/{registry_ref}/artifact/{artifact}/versions List all versions of an artifact · List Artifact Versions #
Ask an LLM
“Which versions of this package have been published to my registry?”
“Can I include deleted versions when listing an artifact's releases?”
Tell an agent
List every version of artifact {artifact} in registry {registry}.
Show versions of {artifact} in {registry} matching {term}.
GET /har/api/v1/registry/{registry_ref}/artifact/labels List labels used in a registry · List Artifact Labels #
Ask an LLM
“What labels are used on artifacts across this registry?”
“Can I search the registry's artifact labels by keyword?”
Tell an agent
List artifact labels in registry {registry}.
Find labels in {registry} containing {term}.
GET /har/api/v1/registry/{registry_ref}/artifact/stats Get artifact stats for a whole registry · Get Artifact Stats #
Ask an LLM
“How many artifacts and downloads does my registry have overall?”
“What are registry-wide artifact statistics for last month?”
Tell an agent
Get registry-wide artifact stats for {registry}.
Show artifact statistics across registry {registry} between {from} and {to}.

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-artifacts-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-artifacts-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-artifacts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Harness Artifacts 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 (57 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/openapi/harness-artifacts-api-openapi.yml