Harness

Harness Repositories API

Read APIs backing the STO Target Code Repositories page.

GitHub OpenAPI

Operations 24

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}/repositories List repositories configured on a GitOps agent · ListRepositories gets a list of all configured repositories #
Ask an LLM
“Which Git repositories are connected to my Harness GitOps agent?”
“Can I force a refresh when listing the repos an agent knows about?”
Tell an agent
List every repository configured on GitOps agent {agentIdentifier}.
Show the repos registered on agent {agentIdentifier} in project {projectIdentifier}.
POST /gitops/api/v1/agents/{agentIdentifier}/repositories Add a repository to a GitOps agent · CreateRepository creates a new repository configuration #
Ask an LLM
“How do I register a new Git or Helm repository with a GitOps agent?”
“Can I upsert a repository config so an existing one gets overwritten?”
Tell an agent
Add repository {repo} to GitOps agent {agentIdentifier}.
Create repo config {identifier} on agent {agentIdentifier} using credential template {repoCredsId}.
GET /gitops/api/v1/agents/{agentIdentifier}/repositories/eso/check Check if External Secrets Operator is installed · Checks whether External Secrets Operator is installed #
Ask an LLM
“Is External Secrets Operator installed where my GitOps agent runs?”
“What does the ESO install check report for a GitOps agent?”
Tell an agent
Check whether External Secrets Operator is installed for agent {agentIdentifier}.
Verify ESO is present in the cluster of GitOps agent {agentIdentifier}.
GET /gitops/api/v1/agents/{agentIdentifier}/repositories/eso/generators List ESO generators in an agent namespace · Returns a list of ESO generators installed in agent namespace #
Ask an LLM
“Which External Secrets generators are installed in my GitOps agent's namespace?”
“Can I filter ESO generators by type or name?”
Tell an agent
List the ESO generators installed in the namespace of agent {agentIdentifier}.
Show ESO generators of type {type} for GitOps agent {agentIdentifier}.
POST /gitops/api/v1/agents/{agentIdentifier}/repositories/oci/type Detect the repository type of an OCI repo · Returns the Repository type of OCI repo #
Ask an LLM
“What kind of repository is behind this OCI URL?”
“Can a GitOps agent tell me the repo type of an OCI registry address?”
Tell an agent
Determine the repository type of OCI repo {repoURL} via agent {agentIdentifier}.
Ask agent {agentIdentifier} to classify the OCI repository at {repoURL}.
POST /gitops/api/v1/agents/{agentIdentifier}/repositories/validate Validate connection access to a repository · ValidateAccess gets connection state for a repository #
Ask an LLM
“Can my GitOps agent actually connect to this repo with these credentials?”
“How do I test SSH key or GitHub App access to a repository before saving it?”
Tell an agent
Validate that agent {agentIdentifier} can reach repository {repo} with username {username}.
Test the connection state of repo {repo} from GitOps agent {agentIdentifier}.
GET /gitops/api/v1/agents/{agentIdentifier}/repositories/{identifier} Get a GitOps repository or its credentials · Get returns a repository or its credentials #
Ask an LLM
“What is configured for a specific repository on my GitOps agent?”
“Can I fetch one agent repository's details by its identifier?”
Tell an agent
Get repository {identifier} from GitOps agent {agentIdentifier}.
Show the configuration of repo {identifier} on agent {agentIdentifier}.
DELETE /gitops/api/v1/agents/{agentIdentifier}/repositories/{identifier} Remove a repository from a GitOps agent · DeleteRepository deletes a repository from the configuration #
Ask an LLM
“How do I remove a repository from my GitOps agent's configuration?”
“Is there a force option when deleting an agent repository?”
Tell an agent destructive · confirm first
Delete repository {identifier} from GitOps agent {agentIdentifier}.
Force-remove repo {identifier} from agent {agentIdentifier}.
PUT /gitops/api/v1/agents/{agentIdentifier}/repositories/{identifier} Update a repository configuration on an agent · UpdateRepository updates a repository configuration #
Ask an LLM
“How do I change the settings of a repo already registered on a GitOps agent?”
“Can I change the refresh interval of an existing agent repository?”
Tell an agent
Update repository {identifier} on agent {agentIdentifier} with new config {repo}.
Set the refresh interval of repo {identifier} on agent {agentIdentifier} to {refreshInterval}.
GET /gitops/api/v1/agents/{agentIdentifier}/repositories/{identifier}/appdetails Get app details at a path in an agent repository · GetAppDetails returns application details by given path #
Ask an LLM
“What application does a given path in my registered GitOps repo define?”
“Can I see the Helm or Kustomize details of an app inside a repo by its identifier?”
Tell an agent
Get the application details at path {path} in repository {identifier} on agent {agentIdentifier}.
Show app details for revision {revision} of registered repo {identifier} via agent {agentIdentifier}.
GET /gitops/api/v1/agents/{agentIdentifier}/repositories/{identifier}/apps List apps inside a registered repository · ListApps returns list of apps in the repo #
Ask an LLM
“Which apps live in a repository my GitOps agent already has registered?”
“Can I list the apps in a registered repo at a specific revision?”
Tell an agent
List the apps in repository {identifier} on agent {agentIdentifier}.
Show apps in registered repo {identifier} at revision {revision} for agent {agentIdentifier}.
GET /gitops/api/v1/agents/{agentIdentifier}/repositories/{identifier}/helmcharts List Helm charts in a registered repository · GetHelmCharts returns list of helm charts in the specified repository #
Ask an LLM
“What Helm charts are in a repository registered on my GitOps agent?”
“Can I list charts from a registered Helm repo by its identifier?”
Tell an agent
List the Helm charts in repository {identifier} on agent {agentIdentifier}.
Refresh and show the charts in registered Helm repo {identifier} via agent {agentIdentifier}.
GET /gitops/api/v1/agents/{agentIdentifier}/repositories/{identifier}/refs List branches and tags of a registered repository · Returns a list of refs (e.g. branches and tags) in the repo #
Ask an LLM
“What branches and tags exist in a repo registered on my GitOps agent?”
“Can I see a registered repository's refs by its identifier?”
Tell an agent
List branches and tags in repository {identifier} on agent {agentIdentifier}.
Show the Git refs for registered repo {identifier} through agent {agentIdentifier}.
GET /gitops/api/v1/agents/{agentIdentifier}/repositories_byurl/appdetails Get app details for a repository by its URL · GetAppDetailsByUrl returns application details by given path for repositories… #
Ask an LLM
“What app is defined at a path in a repo when I only know the repo URL?”
“Can I get Helm or Kustomize app details by repository URL instead of identifier?”
Tell an agent
Get app details at path {path} in the repo at URL {repoURL} via agent {agentIdentifier}.
Using repo URL {repoURL}, show the application details from GitOps agent {agentIdentifier}.
GET /gitops/api/v1/agents/{agentIdentifier}/repositories_byurl/apps List apps in a repository looked up by URL · ListAppsByUrl returns list of apps in the repo #
Ask an LLM
“Which apps are in a repository when I look it up by URL?”
“Can I list apps from a repo URL at a given revision?”
Tell an agent
List the apps in the repo at URL {repo} through agent {agentIdentifier}.
By URL, show apps in repo {repo} at revision {revision} for agent {agentIdentifier}.
GET /gitops/api/v1/agents/{agentIdentifier}/repositories_byurl/helmcharts List Helm charts in a repository by URL · GetHelmChartsByUrl returns list of helm charts in the repository by URL #
Ask an LLM
“What Helm charts are available at a repo URL my GitOps agent can reach?”
“Can I browse Helm charts by repository URL rather than identifier?”
Tell an agent
List Helm charts in the repository at URL {repo} via agent {agentIdentifier}.
Show charts from Helm repo URL {repo} using GitOps agent {agentIdentifier}.
GET /gitops/api/v1/agents/{agentIdentifier}/repositories_byurl/refs List branches and tags of a repository by URL · Returns a list of refs (e.g. branches and tags) in the repo by URL #
Ask an LLM
“What branches and tags does a repo URL have, as seen by my GitOps agent?”
“Can I list Git refs by repo URL without registering an identifier first?”
Tell an agent
List branches and tags for repo URL {repo} through agent {agentIdentifier}.
Show Git refs at repository URL {repo} via GitOps agent {agentIdentifier}.
GET /gitops/api/v1/agents/{agentIdentifier}/repository_byurl Find a GitOps repository by its URL · Get a repository configured in gitops by URL from Harness #
Ask an LLM
“Which GitOps repository record matches this Git URL?”
“Can I look up a repository's configuration on an agent by URL?”
Tell an agent
Get the GitOps repository with URL {url} on agent {agentIdentifier}.
Look up repo {url} on agent {agentIdentifier} and return its scope-prefixed identifier.
GET /gitops/api/v1/repositories List repositories using a credential template · List Repositories by repository credential template #
Ask an LLM
“Which repositories inherit a given repository credential template?”
“What repos would be affected if I change a credential template URL?”
Tell an agent
List repositories that use credential template {repositoryCredentialURL}.
Show repos under credential template {repositoryCredentialURL} on agent {agentIdentifier}.
POST /gitops/api/v1/repositories Search GitOps repositories across agents · List repositories #
Ask an LLM
“How do I search all GitOps repositories in a project by name?”
“Can I include child scopes when searching GitOps repositories?”
Tell an agent
Search GitOps repositories matching {searchTerm} across all agents.
Page through GitOps repositories in project {projectIdentifier}, including child scopes.
GET /gitops/api/v1/repositories/exists Check whether a repository URL is already registered · Check if a repository exists #
Ask an LLM
“Is this repository URL already registered in GitOps?”
“How can I avoid adding a duplicate repository to GitOps?”
Tell an agent
Check whether a GitOps repository with URL {url} exists.
Tell me if repo {url} is already registered on agent {agentIdentifier}.
GET /sto/api/v2/repositories List security-scanned code repositories · List code repositories #
Ask an LLM
“Which code repositories in my project have been security scanned?”
“Can I filter scanned code repos by vulnerability severity or scan type?”
Tell an agent
List scanned code repositories in project {projectId} of org {orgId}.
Show code repos in project {projectId} with {severity} severity findings.
GET /sto/api/v2/repositories/{targetId}/variants List scanned variants of a code repository · List a repository's scanned variants #
Ask an LLM
“Which branches or variants of a repository have security scans?”
“What order are scanned repository variants returned in?”
Tell an agent
List the scanned variants of code repository {targetId} in project {projectId}.
Find variants of repo target {targetId} whose name contains {search}.
GET /sto/api/v2/repositories/overview Summarize scanned code repositories and vulnerabilities · Get repositories overview #
Ask an LLM
“How many code repositories do we have and what are their vulnerability totals?”
“What share of our scanned repos have a baseline set?”
Tell an agent
Give me the code repositories overview for project {projectId}.
Show total repos, source breakdown and vulnerability counts for org {orgId} project {projectId}.

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