Harness

Harness Registry V3 - Lifecycle API

V3 lifecycle rule endpoints

GitHub OpenAPI

Operations 11

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/lifecycle/executions List artifact lifecycle rule runs · List lifecycle executions #
Ask an LLM
“Which artifact registry lifecycle executions have run recently?”
“Can I filter lifecycle runs by status or by registry?”
Tell an agent
List lifecycle executions in account {account}.
Show lifecycle executions with status {status} for registries {registry_ids}.
POST /har/api/v3/lifecycle/executions Dry-run a registry lifecycle rule · Trigger a dry-run lifecycle execution #
Ask an LLM
“Can I preview what a lifecycle rule would clean up before it actually runs?”
“How do I trigger a dry run of an artifact retention rule?”
Tell an agent
Trigger a dry-run execution of lifecycle rule {policyId}.
Dry-run lifecycle rule {policyId} in project {project}.
GET /har/api/v3/lifecycle/executions/{executionId} Get one lifecycle execution · Get a lifecycle execution #
Ask an LLM
“What was the outcome of a specific lifecycle rule execution?”
“Can I check the status of a lifecycle dry run by its execution ID?”
Tell an agent
Get lifecycle execution {executionId}.
Show the result of lifecycle run {executionId} in account {account}.
GET /har/api/v3/lifecycle/executions/{executionId}/items List artifacts evaluated in a lifecycle run · List lifecycle execution items #
Ask an LLM
“Which artifacts did a lifecycle execution evaluate, and what happened to each?”
“Can I filter a lifecycle run's items by package type?”
Tell an agent
List the artifact items evaluated in lifecycle execution {executionId}.
Show items of lifecycle run {executionId} with status {status}.
GET /har/api/v3/lifecycle/rules List artifact lifecycle rules · List lifecycle rules #
Ask an LLM
“What artifact retention and cleanup rules are configured in my registry?”
“Can I list lifecycle rules for one package type only?”
Tell an agent
List lifecycle rules in account {account}.
Show lifecycle rules for package types {package_types} matching {search_term}.
POST /har/api/v3/lifecycle/rules Create an artifact lifecycle rule · Create a lifecycle rule #
Ask an LLM
“How do I set up a rule that cleans up old artifacts in my registry?”
“Can a lifecycle rule run on a schedule and target only some registries?”
Tell an agent
Create lifecycle rule {name} with action {action} applied to {applyTo}.
Create a lifecycle rule {name} doing {action} on {applyTo} with schedule {schedule}.
DELETE /har/api/v3/lifecycle/rules/{id} Delete a lifecycle rule · Delete a lifecycle rule #
Ask an LLM
“How do I delete an artifact lifecycle rule?”
“Who is allowed to delete a lifecycle rule shared across scopes?”
Tell an agent destructive · confirm first
Delete lifecycle rule {id}.
Remove lifecycle rule {id} from account {account}.
GET /har/api/v3/lifecycle/rules/{id} Get one lifecycle rule · Get a lifecycle rule #
Ask an LLM
“What criteria and schedule does a specific lifecycle rule use?”
“Can I view a single artifact lifecycle rule by its ID?”
Tell an agent
Get lifecycle rule {id}.
Show lifecycle rule {id} in project {project}.
PATCH /har/api/v3/lifecycle/rules/{id} Change individual fields of a lifecycle rule · Partially update a lifecycle rule #
Ask an LLM
“Can I disable a lifecycle rule without resending its whole definition?”
“Is there a way to tweak only a lifecycle rule's schedule?”
Tell an agent
Set enabled to {enabled} on lifecycle rule {id}.
Patch just the schedule of lifecycle rule {id} to {schedule}.
PUT /har/api/v3/lifecycle/rules/{id} Replace a lifecycle rule's full definition · Update a lifecycle rule #
Ask an LLM
“How do I fully redefine an existing lifecycle rule?”
“Must I resend the rule's name, action and targets when replacing it?”
Tell an agent
Replace lifecycle rule {id} with name {name}, action {action} and targets {applyTo}.
Fully rewrite lifecycle rule {id} with criteria {criteria}, name {name}, action {action}, targets {applyTo}.
GET /har/api/v3/lifecycle/stats Get lifecycle execution metrics · Get lifecycle stats #
Ask an LLM
“How much has registry lifecycle cleanup done overall across my scope?”
“Can I see aggregate lifecycle metrics for certain registries?”
Tell an agent
Show lifecycle stats for account {account}.
Get aggregate lifecycle metrics for registries {registry_ids}.

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-lifecycle-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-lifecycle-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-lifecycle-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Harness Registry V3 - Lifecycle 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 (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/openapi/harness-registry-v3-lifecycle-api-openapi.yml