# Harness Agents API

**Canonical:** https://apis.io/apis/harness/harness-agents-api/  
**Provider:** Harness — https://apis.io/providers/harness/  
**Base URL:** https://app.harness.io  
**Documentation:** https://apidocs.harness.io

Harness Agents API is one of 488 APIs that [Harness](https://apis.io/providers/harness/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Agents. 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.

The Agents API from Harness — 20 operation(s) for agents.

## Operations (25)

| Method | Path | Summary |
|---|---|---|
| GET | `/gitops/api/v1/agents` | Agent service for server list |
| POST | `/gitops/api/v1/agents` | Agent service for server create |
| GET | `/gitops/api/v1/agents/ns` | Agent service for server list namespaces |
| POST | `/gitops/api/v1/agents/search` | Agent service for server search |
| GET | `/gitops/api/v1/agents/tags` | Agent service for server list tags |
| GET | `/gitops/api/v1/agents/versions` | Agent service for server list versions |
| PUT | `/gitops/api/v1/agents/{agent.identifier}` | Update agents |
| GET | `/gitops/api/v1/agents/{agentIdentifier}/deploy.yaml` | Agent service for server get deploy yaml |
| POST | `/gitops/api/v1/agents/{agentIdentifier}/deployment-spec/helm` | Agent service for server post deploy helm chart |
| POST | `/gitops/api/v1/agents/{agentIdentifier}/deployment-spec/yaml` | Agent service for server post deploy yaml |
| GET | `/gitops/api/v1/agents/{agentIdentifier}/helm-chart` | Agent service for server get deploy helm chart |
| GET | `/gitops/api/v1/agents/{agentIdentifier}/helm-overrides` | Agent service for server get deploy overrides |
| POST | `/gitops/api/v1/agents/{agentIdentifier}/helm-overrides` | Agent service for server post deploy overrides |
| GET | `/gitops/api/v1/agents/{agentIdentifier}/operator/yaml` | Agent service for server get operator yaml |
| POST | `/gitops/api/v1/agents/{agentIdentifier}/operator/yaml` | Agent service for server post operator yaml |
| PATCH | `/gitops/api/v1/agents/{agentIdentifier}/primaryNode` | Agent service for server set primary node |
| GET | `/gitops/api/v1/agents/{agentIdentifier}/sync-allowed` | Agent service for server get sync allowed |
| PUT | `/gitops/api/v1/agents/{agentIdentifier}/sync-allowed` | Agent service for server update sync allowed |
| GET | `/gitops/api/v1/agents/{identifier}` | Agent service for server get |
| DELETE | `/gitops/api/v1/agents/{identifier}` | Agent service for server delete |
| POST | `/gitops/api/v1/agents/{identifier}/credentials` | Agent service for server regenerate credentials |
| POST | `/gitops/api/v1/agents/{identifier}/scale` | Agent service for server scale |
| GET | `/gitops/api/v1/agents/{identifier}/secret-resolution/enabled` | GetSecretResolutionEnabled reports whether Harness secret resolution is enabled… |
| GET | `/gitops/api/v1/agents/{identifier}/unique` | Agent service for server unique |
| GET | `/gitops/api/v2/versions/agents/upgrade-available` | Version upgrade service upgrade available V2 |

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/openapi/harness-agents-api-openapi.yml
- **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
- **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
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/rate-limits/harness-rate-limits.yml

## Other Harness APIs (12)

- [Harness Continuous Integration API](https://apis.io/apis/harness/ci-api/)
- [Harness Continuous Delivery and GitOps API](https://apis.io/apis/harness/cd-api/)
- [Harness Feature Management and Experimentation API](https://apis.io/apis/harness/feature-flags-api/)
- [Harness Cloud Cost Management API](https://apis.io/apis/harness/ccm-api/)
- [Harness Chaos Engineering API](https://apis.io/apis/harness/chaos-api/)
- [Harness Security Testing Orchestration API](https://apis.io/apis/harness/sto-api/)
- [Harness Internal Developer Portal API](https://apis.io/apis/harness/idp-api/)
- [Harness Code Repository API](https://apis.io/apis/harness/code-repo-api/)
- [Harness Service Reliability Management API](https://apis.io/apis/harness/srm-api/)
- [Harness Infrastructure as Code Management API](https://apis.io/apis/harness/iacm-api/)
- [Harness Supply Chain Security API](https://apis.io/apis/harness/ssca-api/)
- [Harness Software Engineering Insights API](https://apis.io/apis/harness/sei-api/)

## Tags

Agents

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/harness/harness-agents-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/harness/.