Harness

Harness Settings API

Settings service handles all API endpoints related to configuration settings

GitHub OpenAPI

Operations 12

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 /code/api/v1/settings/general Get general Code repository settings for a scope · Find general settings of the account, organization, or project #
Ask an LLM
“What default branch is configured for new Harness Code repositories in my project?”
“Can I see which general settings a project inherits from its org or account?”
Tell an agent
Get the general code settings for account {account}.
Show inherited general settings for project {project} in org {org}, account {account}.
PATCH /code/api/v1/settings/general Change the default branch for a scope · Update general settings of the account, organization, or project #
Ask an LLM
“How do I change the default branch name used for new repositories?”
“Can I set a different default branch per project rather than account-wide?”
Tell an agent
Set the default branch to {branch} for account {account}.
Update project {project} in account {account} to use {branch} as default branch.
DELETE /iacm/api/orgs/{org}/projects/{project}/settings/default-pipelines Remove a default pipeline association · Delete default pipeline #
Ask an LLM
“How do I stop a pipeline from being the default for a provisioner operation?”
“Can I clear a workspace-level default pipeline override?”
Tell an agent destructive · confirm first
Remove the default pipeline for {operation} with {provisioner} in {org}/{project}.
Unset the {operation} default pipeline on workspace {workspace} in {org}/{project}.
GET /iacm/api/orgs/{org}/projects/{project}/settings/default-pipelines List default pipelines for IaC operations · List default pipelines #
Ask an LLM
“Which pipelines run by default for plan and apply operations in my IaCM project?”
“Can I see the default pipeline mappings for just one workspace?”
Tell an agent
List default pipeline associations in project {project}, org {org}, account {account}.
Show the default pipelines for workspace {workspace} in {org}/{project}.
PUT /iacm/api/orgs/{org}/projects/{project}/settings/default-pipelines Set the default pipeline for a provisioner operation · Upsert default pipeline #
Ask an LLM
“How do I make a specific pipeline the default for Terraform plan runs in a project?”
“Can I override the default pipeline for an operation in only one workspace?”
Tell an agent
Set pipeline {pipeline} as the default for {operation} with {provisioner} in {org}/{project}.
Associate default pipeline {pipeline} with {operation} for workspace {workspace} in {org}/{project}.
GET /iacm/api/orgs/{org}/projects/{project}/settings/disabled Check if plan and state upload is disabled · Check push data #
Ask an LLM
“Is my IaCM project set to send Terraform plans and state back to the server?”
“Has pushing plan and state data been turned off for this project?”
Tell an agent
Check whether plan and state data are pushed for project {project} in org {org}.
Tell me if state upload is disabled in {org}/{project}.
DELETE /iacm/api/orgs/{org}/projects/{project}/settings/drift-config Turn off drift detection for a whole project · Disable drift automation for all workspaces in a project #
Ask an LLM
“How do I switch off drift detection for every workspace in a project?”
“Will disabling project drift remove the drift triggers from each workspace?”
Tell an agent destructive · confirm first
Disable drift automation for {provisioner} in {org}/{project}.
Remove all drift triggers from workspaces in project {project}, org {org}, provisioner {provisioner}.
GET /iacm/api/orgs/{org}/projects/{project}/settings/drift-config Get project drift detection settings · Get project-level drift automation status for a provisioner #
Ask an LLM
“Is drift detection turned on for all workspaces in my project, and on what schedule?”
“Which pipeline runs project-level drift checks for a provisioner?”
Tell an agent
Get the drift automation status for {provisioner} in {org}/{project}.
Show the drift check schedule and pipeline for provisioner {provisioner} in project {project}, org {org}.
PUT /iacm/api/orgs/{org}/projects/{project}/settings/drift-config Turn on drift detection for a whole project · Enable drift automation for all workspaces in a project #
Ask an LLM
“How do I enable scheduled drift detection across every workspace in a project?”
“Can I choose how often drift checks run, say every 6 hours?”
Tell an agent
Enable drift detection in {org}/{project} using pipeline {pipeline} for {provisioner}.
Run drift checks every {every} {unit} for all workspaces in {org}/{project}.
DELETE /iacm/api/orgs/{org}/projects/{project}/settings/ephemeral-config Turn off ephemeral TTL for a project · Disable ephemeral TTL for all workspaces in a project #
Ask an LLM
“How do I stop workspaces in my project from being auto-destroyed?”
“Can I remove the ephemeral destroy schedules from all workspaces at once?”
Tell an agent destructive · confirm first
Disable ephemeral TTL for {provisioner} in {org}/{project}.
Remove auto-destroy schedules from every workspace in project {project}, org {org}, provisioner {provisioner}.
GET /iacm/api/orgs/{org}/projects/{project}/settings/ephemeral-config Get project ephemeral workspace TTL settings · Get project-level ephemeral configuration for a provisioner #
Ask an LLM
“Are workspaces in my project set to auto-destroy after a TTL?”
“What destroy and delete schedule is saved for ephemeral workspaces?”
Tell an agent
Get the ephemeral workspace config for {provisioner} in {org}/{project}.
Show the saved TTL and destroy-on date for ephemeral workspaces in project {project}, org {org}, provisioner {provisioner}.
PUT /iacm/api/orgs/{org}/projects/{project}/settings/ephemeral-config Make a project's workspaces ephemeral with a TTL · Enable ephemeral TTL for all workspaces in a project #
Ask an LLM
“How do I have every workspace in a project destroy its infrastructure automatically after a few days?”
“Can I also delete the workspace itself after the resources are destroyed?”
Tell an agent
Enable ephemeral TTL in {org}/{project} with pipeline {pipeline} for {provisioner}.
Destroy workspace resources {delay} {unit} after creation across {org}/{project}.

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