How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Harness Repositories API

Read APIs backing the STO Target Code Repositories page.

Harness Repositories API is one of 488 APIs that Harness publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Repositories. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

This API exposes 24 operations across 20 paths, and defines 54 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 2 base URLs: https://app.harness.io, https://{vanity}.

24 operations 20 paths 54 schemas 1 DELETE18 GET4 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://app.harness.io
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Harness Repositories API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (x-api-key). By default, every request must be authenticated.

  • x-api-key — API key is a token provided while making the API calls. This is used to authenticate the client at the exposed endpoint.

Paths & Operations 24

Across 20 paths, the API surfaces 24 operations — 1 DELETE, 18 GET, 4 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Repositories 24

Read APIs backing the STO Target Code Repositories page.

GET
/gitops/api/v1/agents/{agentIdentifier}/repositories
ListRepositories gets a list of all configured repositories
AgentRepositoryService_ListRepositories 8 params → 200default
POST
/gitops/api/v1/agents/{agentIdentifier}/repositories
CreateRepository creates a new repository configuration
AgentRepositoryService_CreateRepository 6 params body → 200default
GET
/gitops/api/v1/agents/{agentIdentifier}/repositories/eso/check
Checks whether External Secrets Operator is installed
AgentRepositoryService_CheckExternalSecretsOperator 4 params → 200default
GET
/gitops/api/v1/agents/{agentIdentifier}/repositories/eso/generators
Returns a list of ESO generators installed in agent namespace
AgentRepositoryService_ListESOGenerators 7 params → 200default
POST
/gitops/api/v1/agents/{agentIdentifier}/repositories/oci/type
Returns the Repository type of OCI repo
AgentRepositoryService_CheckOCIRepoType 4 params body → 200default
POST
/gitops/api/v1/agents/{agentIdentifier}/repositories/validate
ValidateAccess gets connection state for a repository
AgentRepositoryService_ValidateAccess 5 params body → 200default
GET
/gitops/api/v1/agents/{agentIdentifier}/repositories/{identifier}
Get returns a repository or its credentials
AgentRepositoryService_Get 8 params → 200default
DELETE
/gitops/api/v1/agents/{agentIdentifier}/repositories/{identifier}
DeleteRepository deletes a repository from the configuration
AgentRepositoryService_DeleteRepository 9 params → 200default
PUT
/gitops/api/v1/agents/{agentIdentifier}/repositories/{identifier}
UpdateRepository updates a repository configuration
AgentRepositoryService_UpdateRepository 5 params body → 200default
GET
/gitops/api/v1/agents/{agentIdentifier}/repositories/{identifier}/appdetails
GetAppDetails returns application details by given path
AgentRepositoryService_GetAppDetails 47 params → 200default
GET
/gitops/api/v1/agents/{agentIdentifier}/repositories/{identifier}/apps
ListApps returns list of apps in the repo
AgentRepositoryService_ListApps 9 params → 200default
GET
/gitops/api/v1/agents/{agentIdentifier}/repositories/{identifier}/helmcharts
GetHelmCharts returns list of helm charts in the specified repository
AgentRepositoryService_GetHelmCharts 8 params → 200default
GET
/gitops/api/v1/agents/{agentIdentifier}/repositories/{identifier}/refs
Returns a list of refs (e.g. branches and tags) in the repo
AgentRepositoryService_ListRefs 8 params → 200default
GET
/gitops/api/v1/agents/{agentIdentifier}/repositories_byurl/appdetails
GetAppDetailsByUrl returns application details by given path for repositories…
AgentRepositoryService_GetAppDetailsByUrl 47 params → 200default
GET
/gitops/api/v1/agents/{agentIdentifier}/repositories_byurl/apps
ListAppsByUrl returns list of apps in the repo
AgentRepositoryService_ListAppsByUrl 9 params → 200default
GET
/gitops/api/v1/agents/{agentIdentifier}/repositories_byurl/helmcharts
GetHelmChartsByUrl returns list of helm charts in the repository by URL
AgentRepositoryService_GetHelmChartsByUrl 8 params → 200default
GET
/gitops/api/v1/agents/{agentIdentifier}/repositories_byurl/refs
Returns a list of refs (e.g. branches and tags) in the repo by URL
AgentRepositoryService_ListRefsByUrl 8 params → 200default
GET
/gitops/api/v1/agents/{agentIdentifier}/repository_byurl
Get a repository configured in gitops by URL from Harness
AgentRepositoryService_GetByUrl 6 params → 200default
GET
/gitops/api/v1/repositories
List Repositories by repository credential template
RepositoryService_ListRepositoriesByRepositoryCredentialTemplate 7 params → 200default
POST
/gitops/api/v1/repositories
List repositories
RepositoryService_ListRepositories body → 200default
GET
/gitops/api/v1/repositories/exists
Check if a repository exists
RepositoryService_Exists 5 params → 200default
GET
/sto/api/v2/repositories
List code repositories
Repositories#ListRepositories 11 params → 200400401403404429500
GET
/sto/api/v2/repositories/{targetId}/variants
List a repository's scanned variants
Repositories#ListRepositoryVariants 7 params → 200400401403404429500
GET
/sto/api/v2/repositories/overview
Get repositories overview
Repositories#RepositoriesOverview 3 params → 200400401403404429500

Schemas 54

The contract defines 54 schemas that model the data the API accepts and returns. The most detailed are repositoriesRepository (27 properties), repositoriesRepoAccessQuery (18 properties), v1RepoListReq (12 properties), StoRepository (11 properties). Each schema is shown below with its type and property counts.

repositoriesRefs
object
2 properties
repositoriesRepoCreateRequest
object
7 properties
repositoriesGCRWorkloadIdentity
object
4 properties
StoPagination
object
5 properties 4 required
repositoriesAWSSecretRef
object
3 properties
v1Repositorylist
object
7 properties
v1OCIRepoTypeResponse
object
1 property
TargetVariant
object
Information about a Scan Target Variant
6 properties 5 required
RepoListReqRepoSortByOptions
string
commonsConnectionState
object
4 properties
applicationsKsonnetParameter
object
3 properties
repositoriesRepoAccessQuery
object
18 properties
v1OCIRepoType
object
1 property
repositoriesKsonnetEnvironment
object
3 properties
repositoriesKsonnetAppSpec
object
3 properties
repositoriesRepository
object
27 properties
servicev1Repository
object
10 properties
RepositorySeverityCounts
object
Counts by severity, sourced from targetsummary.
6 properties 6 required
repositoriesRepositoryList
object
RepositoryList is a collection of Repositories.
2 properties
RepositoriesListRepositoriesResponseBody
object
2 properties 2 required
v1SortOrderOptions
string
gatewayruntimeError
object
4 properties
protobufAny
object
Any contains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message. Protobuf library provides supp…
2 properties
v1ListMeta
object
ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMe…
4 properties
protobufFieldMask
object
paths: "f.a" paths: "f.b.d" Here f represents a field in some root message, a and b fields in the message found in f, and d a field found in the message in f.b…
1 property
repositoriesHelmChart
object
2 properties
repositoriesServiceAccountSelector
object
3 properties
NotFound
object
2 properties 1 required
repositoriesCheckESOResponse
object
1 property
applicationsHelmParameter
object
3 properties
repositoriesKustomizeAppSpec
object
1 property
RepositoriesListRepositoryVariantsResponseBody
object
2 properties 2 required
applicationsHelmFileParameter
object
2 properties
repositoriesKsonnetEnvironmentDestination
object
2 properties
RepositoriesOverviewResult
object
Aggregate widgets for the Target Code Repositories page (UI 3.0).
7 properties 5 required
repositoriesESOGeneratorType
string
repositoriesHelmChartsResponse
object
1 property
OCIRepoTypeResponseOCIRepoTypeEnum
string
repositoriesAppInfo
object
2 properties
repositoriesRepoAppDetailsResponse
object
5 properties
repositoriesGCRAccessTokenGenerator
object
3 properties
v1RepoByUrlRespList
object
1 property
repositoriesRepoResponse
object
v1RepoListReq
object
12 properties
repositoriesDirectoryAppSpec
object
repositoriesESOGeneratorResponse
object
3 properties
RepositorySeverityDeltas
object
Change in counts by severity since the last UTC 12:00 AM snapshot. Positive means increased, negative means decreased.
6 properties 6 required
repositoriesHelmAppSpec
object
5 properties
repositoriesECRAuthorizationTokenGenerator
object
ECRAuthorizationTokenSpec represents externalSecret for ECR External Secret Operator generator.
4 properties
StoRepository
object
A code repository target as shown on the Target Code Repositories page (UI 3.0).
11 properties 5 required
repositoriesRepoAppsResponse
object
1 property
v1Time
object
Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time pack…
2 properties
repositoriesRepoUpdateRequest
object
6 properties
RepositorySourceBreakdownItem
object
Repository count for a single source (one GROUP BY source bucket).
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

harness-repositories-api-openapi.yml Raw ↑

Other APIs Harness publishes across the network.

Harness Continuous Integration API
Harness Continuous Delivery and GitOps API
Harness Feature Management and Experimentation API
Harness Cloud Cost Management API
Harness Chaos Engineering API
Harness Security Testing Orchestration API
Harness Internal Developer Portal API
Harness Code Repository API
Harness Service Reliability Management API
Harness Infrastructure as Code Management API
Harness Supply Chain Security API
Harness Software Engineering Insights API
Where this information came from

This is an independent, third-party profile of Harness Repositories API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.