Harness

settings

Settings service handles all API endpoints related to configuration settings

Delete default pipeline

Delete the association between a default pipeline and a provisioner operation

Securityx-api-key
Request
path Parameters
org
required
string
Example: Magni libero.
project
required
string
Example: Assumenda accusantium ut.
header Parameters
Harness-Account
required
string
Example: Minus facere.
Request Body schema: application/json
required
operation
required
string

The default pipeline is associated with this operation

Enum: "plan" "apply" "destroy" "drift"
provisioner
required
string

The default pipeline is associated with this provisioner

Enum: "terraform" "opentofu"
workspace
string
Default: ""

The default pipeline is associated with this workspace if specified

Responses
200

OK response.

400

BadRequestError: Bad Request response.

401

UnauthorizedError: Unauthorized response.

403

ForbiddenError: Forbidden response.

404

NotFoundError: Not Found response.

408

TimeoutError: Request Timeout response.

409

ConflictError: Conflict response.

423

LockedError: Locked response.

499

ContextCancelledError: response.

500

InternalServerError: Internal Server Error response.

502

BadGatewayError: Bad Gateway response.

delete/iacm/api/orgs/{org}/projects/{project}/settings/default-pipelines
Request samples
application/json
{
  • "operation": "plan",
  • "provisioner": "opentofu",
  • "workspace": "plan"
}

List default pipelines

List all associations between provisioner operations and default pipelines

Securityx-api-key
Request
path Parameters
org
required
string [ 1 .. 128 ] characters

Org is the organisation identifier.

Example: b2
project
required
string [ 1 .. 128 ] characters

Project is the project identifier.

Example: v
query Parameters
workspace
string
Default: ""

Workspace identifier

Example: workspace=workspace123
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: 01
Responses
200

OK response.

400

BadRequestError: Bad Request response.

401

UnauthorizedError: Unauthorized response.

403

ForbiddenError: Forbidden response.

404

NotFoundError: Not Found response.

408

TimeoutError: Request Timeout response.

409

ConflictError: Conflict response.

423

LockedError: Locked response.

499

ContextCancelledError: response.

500

InternalServerError: Internal Server Error response.

502

BadGatewayError: Bad Gateway response.

get/iacm/api/orgs/{org}/projects/{project}/settings/default-pipelines
Request samples 
Response samples 
application/json
[
  • {
    },
  • {
    },
  • {
    }
]
Upsert default pipeline
Associate a default pipeline with a provisioner operation


Securityx-api-key 
Request 
path Parameters
org
required
string
 
 Example:  Amet corporis eos rerum aut sapiente autem.
project
required
string
 
 Example:  Consequatur tenetur doloremque repellendus doloremque et et.
header Parameters
Harness-Account
required
string
 
 Example:  Ut dolor repellat veritatis.
Request Body schema: application/json
required
operation
required
string
The default pipeline is associated with this operation


 Enum: "plan" "apply" "destroy" "drift"  
pipeline
required
string
The default pipeline associated with the provisioner operation


 
provisioner
required
string
The default pipeline is associated with this provisioner


 Enum: "terraform" "opentofu"  
updated
required
integer <int64> 
Time the default pipeline was last updated


 
workspace
string
 Default:  ""
The default pipeline is associated with this workspace if specified


 
Responses 
200
OK response.


400
BadRequestError: Bad Request response.


401
UnauthorizedError: Unauthorized response.


403
ForbiddenError: Forbidden response.


404
NotFoundError: Not Found response.


408
TimeoutError: Request Timeout response.


409
ConflictError: Conflict response.


423
LockedError: Locked response.


499
ContextCancelledError:  response.


500
InternalServerError: Internal Server Error response.


502
BadGatewayError: Bad Gateway response.


put/iacm/api/orgs/{org}/projects/{project}/settings/default-pipelines
Request samples 
application/json
{
  • "operation": "plan",
  • "pipeline": "testpipeline",
  • "provisioner": "opentofu",
  • "updated": 1636669297674,
  • "workspace": "plan"
}
Check push data
Check if the plan/state should be sent to the server


Securityx-api-key 
Request 
path Parameters
org
required
string  [ 1 .. 128 ] characters 
Org is the organisation identifier.


 
 Example:  2g
project
required
string  [ 1 .. 128 ] characters 
Project is the project identifier.


 
 Example:  d
header Parameters
Harness-Account
required
string  [ 1 .. 128 ] characters 
Account is the internal customer account ID.


 
 Example:  so
Responses 
200
OK response.


400
BadRequestError: Bad Request response.


401
UnauthorizedError: Unauthorized response.


403
ForbiddenError: Forbidden response.


404
NotFoundError: Not Found response.


408
TimeoutError: Request Timeout response.


409
ConflictError: Conflict response.


423
LockedError: Locked response.


499
ContextCancelledError:  response.


500
InternalServerError: Internal Server Error response.


502
BadGatewayError: Bad Gateway response.


get/iacm/api/orgs/{org}/projects/{project}/settings/disabled
Request samples 
Response samples 
application/json
{
  • "disabled": false
}
➔ Next to tf-standard-backend