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 Settings API

Settings service handles all API endpoints related to configuration settings

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

Tagged areas include Settings. 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 12 operations across 5 paths, and defines 16 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}.

12 operations 5 paths 16 schemas 3 DELETE5 GET1 PATCH3 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 Settings 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 12

Across 5 paths, the API surfaces 12 operations — 3 DELETE, 5 GET, 1 PATCH, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

Settings 12

Settings service handles all API endpoints related to configuration settings

GET
/code/api/v1/settings/general
Find general settings of the account, organization, or project
findSpaceGeneralSettings 4 params → 200400401403404500
PATCH
/code/api/v1/settings/general
Update general settings of the account, organization, or project
updateSpaceGeneralSettings 3 params body → 200400401403404500
DELETE
/iacm/api/orgs/{org}/projects/{project}/settings/default-pipelines
Delete default pipeline
settings#delete-default-pipeline 3 params body → 200400401403404408409423
GET
/iacm/api/orgs/{org}/projects/{project}/settings/default-pipelines
List default pipelines
settings#list-default-pipelines 4 params → 200400401403404408409423
PUT
/iacm/api/orgs/{org}/projects/{project}/settings/default-pipelines
Upsert default pipeline
settings#upsert-default-pipeline 3 params body → 200400401403404408409423
GET
/iacm/api/orgs/{org}/projects/{project}/settings/disabled
Check push data
settings#check-push-data 3 params → 200400401403404408409423
DELETE
/iacm/api/orgs/{org}/projects/{project}/settings/drift-config
Disable drift automation for all workspaces in a project
settings#disable-project-drift 4 params → 202400401403404408409423
GET
/iacm/api/orgs/{org}/projects/{project}/settings/drift-config
Get project-level drift automation status for a provisioner
settings#get-project-drift 4 params → 200400401403404408409423
PUT
/iacm/api/orgs/{org}/projects/{project}/settings/drift-config
Enable drift automation for all workspaces in a project
settings#enable-project-drift 3 params body → 202400401403404408409423
DELETE
/iacm/api/orgs/{org}/projects/{project}/settings/ephemeral-config
Disable ephemeral TTL for all workspaces in a project
settings#disable-ephemeral-workspaces-in-project 4 params → 202400401403404408409423
GET
/iacm/api/orgs/{org}/projects/{project}/settings/ephemeral-config
Get project-level ephemeral configuration for a provisioner
settings#get-ephemeral-workspaces-in-project 4 params → 200400401403404408409423
PUT
/iacm/api/orgs/{org}/projects/{project}/settings/ephemeral-config
Enable ephemeral TTL for all workspaces in a project
settings#enable-ephemeral-workspaces-in-project 3 params body → 202400401403404408409423

Schemas 16

The contract defines 16 schemas that model the data the API accepts and returns. The most detailed are GetEphemeralWorkspacesInProjectResponse (10 properties), EnableEphemeralWorkspacesInProjectRequest (9 properties), HarnessIacmDefaultpipeline (8 properties), IaCMError (6 properties). Each schema is shown below with its type and property counts.

SettingsGeneralSettingsSpace
object
1 property
DefaultPipelineCollection
array
EnableEphemeralWorkspacesInProjectRequest
object
9 properties 2 required
DeleteDefaultPipelineRequest
object
3 properties 2 required
CheckPushDataResponse
object
1 property 1 required
DisableProjectDriftResponse
object
2 properties 2 required
EnableEphemeralWorkspacesInProjectResponse
object
2 properties 2 required
UpsertDefaultPipelineRequest
object
5 properties 4 required
EnableProjectDriftResponse
object
2 properties 2 required
EnableProjectDriftRequest
object
4 properties 4 required
HarnessIacmDefaultpipeline
object
8 properties 7 required
IaCMError
object
6 properties 6 required
DisableEphemeralWorkspacesInProjectResponse
object
2 properties 2 required
UsererrorError
object
2 properties
GetEphemeralWorkspacesInProjectResponse
object
10 properties 2 required
GetProjectDriftResponse
object
5 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

harness-settings-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 Settings 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.