Harness

Harness Applications API

The Applications API from Harness — 30 operation(s) for applications.

GitHub OpenAPI

Operations 35

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 /gitops/api/v1/agents/{agentIdentifier}/applications List GitOps applications managed by an agent · List applications for a specific agent #
Ask an LLM
“Which GitOps applications does a particular Harness GitOps agent manage?”
“Can I narrow an agent's application list to ones from a specific Git repo?”
Tell an agent
List all applications managed by GitOps agent {agent}.
Show the applications on agent {agent} that come from repo {repo}.
POST /gitops/api/v1/agents/{agentIdentifier}/applications Create a GitOps application on an agent · Create an application #
Ask an LLM
“How do I register a new Argo-style application with my GitOps agent?”
“Can I create an application that upserts if it already exists?”
Tell an agent
Create a new GitOps application on agent {agent} in cluster {cluster}.
Add an application to agent {agent} sourced from repository {repo}, upserting if it exists.
GET /gitops/api/v1/agents/{agentIdentifier}/applications/parent/{query.name} Find the parent app of a GitOps application · Get parent application #
Ask an LLM
“Which app-of-apps or ApplicationSet owns this child GitOps application?”
“Can I look up the parent application from a child app's name?”
Tell an agent
Find the parent application of child app {app} on agent {agent}.
Tell me which app of apps manages {app} under GitOps agent {agent}.
GET /gitops/api/v1/agents/{agentIdentifier}/applications/{query.applicationName}/managed-resources List resources managed by a GitOps application · Get ManagedResources #
Ask an LLM
“What Kubernetes resources does my GitOps application manage?”
“Can I filter an application's managed resources by kind or namespace?”
Tell an agent
List the managed resources of application {app} on agent {agent}.
Show managed resources of kind {kind} for app {app} on agent {agent}.
GET /gitops/api/v1/agents/{agentIdentifier}/applications/{query.applicationName}/resource-tree Get the resource tree of a GitOps application · Get resource tree #
Ask an LLM
“How are the resources in my GitOps application nested, from Deployment down to pods?”
“What does the full resource hierarchy of an application look like right now?”
Tell an agent
Get the resource tree snapshot for application {app} on agent {agent}.
Show me the one-time hierarchy of resources owned by {app} via agent {agent}.
GET /gitops/api/v1/agents/{agentIdentifier}/applications/{query.name} Get a GitOps application by name · Get application #
Ask an LLM
“What is the current sync and health status of a specific GitOps application?”
“Can I force a refresh when fetching one application's details?”
Tell an agent
Get the details of GitOps application {app} on agent {agent}.
Fetch application {app} from agent {agent} with a {refresh} refresh.
GET /gitops/api/v1/agents/{agentIdentifier}/applications/{query.name}/events List Kubernetes events for a GitOps application · List resource events #
Ask an LLM
“What Kubernetes events has my GitOps application's resources emitted recently?”
“Can I see events for just one resource inside an application?”
Tell an agent
List the Kubernetes events for application {app} on agent {agent}.
Show events for resource {resource} in application {app} on agent {agent}.
GET /gitops/api/v1/agents/{agentIdentifier}/applications/{query.name}/logs Stream logs across an application's pods · PodLogs returns stream of log entries for the specified pod(s) #
Ask an LLM
“How can I tail logs from all the pods in a GitOps application without naming a pod?”
“Can I stream application logs only from the last few minutes?”
Tell an agent
Stream logs for application {app} on agent {agent}, picking the pod by query.
Follow live logs for container {container} across application {app} on agent {agent}.
GET /gitops/api/v1/agents/{agentIdentifier}/applications/{query.name}/logs/batch Fetch application pod logs in batches · Agent application stream service pod logs batch2 #
Ask an LLM
“Can I pull an application's pod logs in chunks of up to 1000 lines instead of one at a time?”
“What's the batched way to read logs for a GitOps app when I don't know the pod name?”
Tell an agent
Fetch batched logs for application {app} on agent {agent}, up to 1000 entries per batch.
Get the last {lines} log lines in batches for application {app} on agent {agent}.
GET /gitops/api/v1/agents/{agentIdentifier}/applications/{query.name}/manifests Get the rendered manifests of an application · Get application manifest #
Ask an LLM
“What Kubernetes manifests does my GitOps application render to?”
“Can I see an application's manifests at a specific Git revision?”
Tell an agent
Get the manifests for application {app} on agent {agent}.
Render manifests of {app} on agent {agent} at revision {revision}.
GET /gitops/api/v1/agents/{agentIdentifier}/applications/{query.name}/pods/{query.podName}/logs Stream logs from a named pod in an application · PodLogs returns stream of log entries for the specified pod(s) #
Ask an LLM
“How do I stream logs from one specific pod belonging to my GitOps app?”
“Can I see the previous container's logs for a pod that restarted?”
Tell an agent
Stream logs from pod {pod} in application {app} on agent {agent}.
Follow logs of pod {pod} in {app} (agent {agent}) since {seconds} seconds ago.
GET /gitops/api/v1/agents/{agentIdentifier}/applications/{query.name}/pods/{query.podName}/logs/batch Fetch a named pod's logs in batches · Agent application stream service pod logs batch #
Ask an LLM
“Can I read a single pod's logs in 1000-entry batches rather than a live stream?”
“Is there a batched log read for a specific pod in a GitOps application?”
Tell an agent
Fetch batched logs from pod {pod} of application {app} on agent {agent}.
Pull pod {pod} logs in batches for {app} on agent {agent}, filtered by {filter}.
GET /gitops/api/v1/agents/{agentIdentifier}/applications/{query.name}/revisions/{query.revision}/metadata Get commit metadata for an application revision · Get revision metadata #
Ask an LLM
“Who authored the commit my GitOps application is synced to, and what was the message?”
“Can I see the metadata behind a specific revision of an application?”
Tell an agent
Get the revision metadata for {revision} of application {app} on agent {agent}.
Show the author and message for commit {revision} in app {app} via agent {agent}.
GET /gitops/api/v1/agents/{agentIdentifier}/applications/{query.name}/syncwindows Get the sync windows of an application · Get sync windows of the application #
Ask an LLM
“When is my GitOps application allowed to sync, according to its sync windows?”
“Are there any sync windows currently blocking deployments for this app?”
Tell an agent
Show the sync windows for application {app} on agent {agent}.
Check whether sync windows block application {app} on agent {agent}.
PUT /gitops/api/v1/agents/{agentIdentifier}/applications/{request.application.metadata.name} Replace a GitOps application definition · Update an application #
Ask an LLM
“How do I update an existing GitOps application's full definition?”
“Can I change which cluster or repo an application points to after creating it?”
Tell an agent
Update GitOps application {app} on agent {agent} with the new definition.
Repoint application {app} on agent {agent} to repository {repo}.
DELETE /gitops/api/v1/agents/{agentIdentifier}/applications/{request.name} Delete a GitOps application · Delete an application #
Ask an LLM
“How do I remove a GitOps application from my agent?”
“Can I delete an application without cascading to its Kubernetes resources?”
Tell an agent destructive · confirm first
Delete GitOps application {app} from agent {agent}.
Remove application {app} on agent {agent} with cascade set to {cascade}.
PATCH /gitops/api/v1/agents/{agentIdentifier}/applications/{request.name} Apply a patch to a GitOps application · Patch an application #
Ask an LLM
“Can I patch just a few fields of a GitOps application instead of replacing it?”
“What's the way to send a JSON or merge patch to an application?”
Tell an agent
Patch GitOps application {app} on agent {agent} with my changes.
Apply patch request {patch} to application {app} on agent {agent}.
DELETE /gitops/api/v1/agents/{agentIdentifier}/applications/{request.name}/operation Stop an application's running operation · Terminate operation #
Ask an LLM
“How do I cancel a sync that's stuck in progress on a GitOps application?”
“Can I terminate whatever operation an application is currently running?”
Tell an agent destructive · confirm first
Terminate the running operation on application {app} on agent {agent}.
Cancel the in-progress sync for {app} under agent {agent}.
GET /gitops/api/v1/agents/{agentIdentifier}/applications/{request.name}/resource Get one resource inside a GitOps application · Get an application resource #
Ask an LLM
“How do I see the live state of a single Kubernetes resource in my GitOps app?”
“Can I fetch one Deployment's live manifest from an application?”
Tell an agent
Get resource {resource} of kind {kind} in application {app} on agent {agent}.
Show the live {resource} in namespace {namespace} for app {app} on agent {agent}.
DELETE /gitops/api/v1/agents/{agentIdentifier}/applications/{request.name}/resource Delete a single resource from an application · Delete resource #
Ask an LLM
“How do I delete one pod or Deployment that belongs to a GitOps application?”
“Can I force-delete or orphan a resource inside an application?”
Tell an agent destructive · confirm first
Delete resource {resource} of kind {kind} from application {app} on agent {agent}.
Force delete {resource} in namespace {namespace} within app {app} on agent {agent}.
POST /gitops/api/v1/agents/{agentIdentifier}/applications/{request.name}/resource Patch a single resource in an application · Patch an application resource #
Ask an LLM
“Can I patch one Kubernetes resource inside a GitOps app, like bumping replicas?”
“Which patch types are supported when editing an application's resource?”
Tell an agent
Patch resource {resource} in application {app} on agent {agent} with {patch}.
Apply a {patch_type} patch to {resource} of kind {kind} in app {app} on agent {agent}.
GET /gitops/api/v1/agents/{agentIdentifier}/applications/{request.name}/resource/actions List actions available on an application resource · List resource actions #
Ask an LLM
“What custom actions, like restart, can I run on a resource in my GitOps app?”
“Which resource actions are available for a given Deployment in an application?”
Tell an agent
List the available actions for resource {resource} in application {app} on agent {agent}.
Show what actions I can run on {kind} {resource} in app {app} (agent {agent}).
POST /gitops/api/v1/agents/{agentIdentifier}/applications/{request.name}/resource/actions Run an action on an application resource · Run resource action #
Ask an LLM
“How do I trigger a restart action on a Deployment in my GitOps application?”
“Can I run a named resource action against one resource in an app?”
Tell an agent
Run action {action} on resource {resource} in application {app} on agent {agent}.
Restart {kind} {resource} in app {app} via agent {agent} using action {action}.
POST /gitops/api/v1/agents/{agentIdentifier}/applications/{request.name}/rollback Roll back a GitOps application to a prior deploy · Rollback syncs an application to its target state #
Ask an LLM
“How do I roll a GitOps application back to an earlier deployment?”
“Can I dry-run a rollback before actually doing it?”
Tell an agent
Roll back application {app} on agent {agent} to history entry {history_id}.
Do a dry-run rollback of {app} on agent {agent} with pruning enabled.
PUT /gitops/api/v1/agents/{agentIdentifier}/applications/{request.name}/spec Update only the spec of a GitOps application · Update application spec #
Ask an LLM
“Can I change just an application's spec, such as its source or destination, without touching metadata?”
“How do I edit the sync policy in a GitOps application's spec?”
Tell an agent
Update the spec of application {app} on agent {agent} to {spec}.
Validate and replace only the spec section for {app} on agent {agent}.
POST /gitops/api/v1/agents/{agentIdentifier}/applications/{request.name}/sync Sync a GitOps application to its target state · Sync an application #
Ask an LLM
“How do I deploy the latest Git changes by syncing one GitOps application?”
“Can I sync an application to a specific revision with prune turned on?”
Tell an agent
Sync application {app} on agent {agent}.
Sync {app} on agent {agent} to revision {revision} and prune removed resources.
GET /gitops/api/v1/agents/{agentIdentifier}/stream/applications Watch a stream of application change events · Watch returns stream of application change events #
Ask an LLM
“Can I subscribe to live change events for the applications on a GitOps agent?”
“How do I get notified as applications on an agent change state?”
Tell an agent
Watch application change events on agent {agent}.
Stream change events for application {app} on agent {agent}.
GET /gitops/api/v1/agents/{agentIdentifier}/stream/applications/{query.applicationName}/resource-tree Stream live updates to an application's resource tree · WatchResourceTree returns stream of application resource tree #
Ask an LLM
“Can I keep a live stream open of an application's resource tree as it changes?”
“Is there a streaming version of the resource hierarchy for a GitOps app?”
Tell an agent
Stream resource tree updates for application {app} on agent {agent}.
Keep watching the resource tree of {app} via agent {agent} as it changes.
GET /gitops/api/v1/applications/attributes List attributes for GitOps applications · List attributes for applications #
Ask an LLM
“What attributes are recorded for my GitOps applications?”
“Can I get attributes for a specific set of application identifiers?”
Tell an agent
List attributes for applications {apps} in project {project}.
Show application attributes across my project.
POST /gitops/api/v1/applications/bulk/refresh Refresh many GitOps applications at once · Bulk refresh multiple applications #
Ask an LLM
“How do I refresh the status of several GitOps applications in one call?”
“Can I do a hard refresh on a batch of apps to bypass the manifest cache?”
Tell an agent
Refresh applications {targets} in bulk.
Run a {refresh} refresh across applications {targets}.
POST /gitops/api/v1/applications/bulk/sync Sync many GitOps applications at once · Bulk sync multiple applications #
Ask an LLM
“Can I kick off a sync for a whole batch of GitOps applications together?”
“Is a dry run supported when syncing multiple apps in bulk?”
Tell an agent
Bulk sync applications {targets} to their target state.
Dry-run a bulk sync of {targets} with prune enabled.
POST /gitops/api/v1/applications/ns Search namespaces used by GitOps applications · List namespaces for a specific query #
Ask an LLM
“Which Kubernetes namespaces are my GitOps applications deployed into?”
“Can I search application namespaces by a partial name?”
Tell an agent
List the namespaces of GitOps applications matching {term}.
Show application namespaces in project {project}, {size} per page.
GET /gitops/api/v1/applications/sets List legacy ApplicationSets in a project · List LegacyApplicationSets #
Ask an LLM
“What legacy ApplicationSets exist in my Harness project?”
“Can I search legacy application sets by name?”
Tell an agent
List legacy ApplicationSets in project {project}.
Find legacy application sets whose name matches {term}.
POST /gitops/api/v1/applications/sync List sync history and status for applications · List application sync status #
Ask an LLM
“When did my GitOps applications last sync, and did those syncs succeed?”
“Can I filter sync records by operation phase or date range?”
Tell an agent
List sync status records for application {app}.
Show application syncs in phase {phase} between {start} and {end}.
GET /gitops/api/v1/applications/{name}/exists Check whether an application name is taken · Check if an application exists #
Ask an LLM
“Is there already a GitOps application with this name?”
“Can two applications share a name if they live in different app namespaces?”
Tell an agent
Check if an application named {name} exists.
Check whether {name} is already used in app namespace {namespace} on agent {agent}.

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-applications-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/json-schema/harness-applications-application-spec-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/json-schema/harness-repositories-revision-metadata-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/json-schema/harness-applications-application-tree-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/json-schema/harness-servicev1-application-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/json-schema/harness-applications-application-sync-request-schema.json

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