Harness

approvals

Approval service handles the approval API to approve or reject pipeline executions

List approvals

List all the approvals

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: zwl
query Parameters
limit
integer <int64> [ 1 .. 1000 ]
Default: 30

Limit is the number of records to return for a page.

Example: limit=30
page
integer <int64> >= 1
Default: 1

Page is the page number to return relative to the page 'limit'.

Example: page=1
workspace
string

Workspace identifier

Example: workspace=Accusamus id omnis eligendi.
pipeline_execution_id
string

Pipeline identifier

Example: pipeline_execution_id=Qui et repudiandae aut.
pipeline_stage_id
string

Pipeline stage identifier

Example: pipeline_stage_id=Omnis nisi occaecati maxime excepturi unde.
status_type
string

Status of the approval step

Enum: "approved" "rejected" "pending"
Example: status_type=pending
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: 7yp
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}/approvals
Request samples 
Response samples 
application/json
[
  • {
    },
  • {
    },
  • {
    }
]
Create approval
Create an approval resource


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


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


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


 
 Example:  j
Request Body schema: application/json
required
pipeline_execution_id
required
string
The unique identifier for the associated pipeline execution


 
pipeline_stage_id
required
string
The unique identifier for the associated pipeline execution stage


 
status
string
 Default:  "pending"
Status of the approval resource


 Enum: "pending" "approved" "rejected"  
workspace_id
required
string
The unique identifier for the workspace_id


 
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.


post/iacm/api/orgs/{org}/projects/{project}/approvals
Request samples 
application/json
{
  • "pipeline_execution_id": "Quis reprehenderit expedita atque aut.",
  • "pipeline_stage_id": "Nihil debitis molestiae consequatur nihil quibusdam commodi.",
  • "status": "rejected",
  • "workspace_id": "Itaque et dolorem perferendis et dolore."
}
Response samples 
application/json
{
  • "id": "Libero ratione reiciendis error inventore saepe."
}
Show approval
Retrieve a single approval


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


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


 
 Example:  kmy
id
required
string <uuid> 
 
 Example:  8223c34b-f914-48f5-a5bb-70909399bafe
header Parameters
Harness-Account
required
string  [ 1 .. 128 ] characters 
Account is the internal customer account ID.


 
 Example:  k9v
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}/approvals/{id}
Request samples 
Response samples 
application/json
{
  • "actioned_by": "John Doe",
  • "created": 4080863221896605700,
  • "status": "Inventore nesciunt non repudiandae.",
  • "updated": 5639822667071797000
}
Update approval
Update a single approval


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


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


 
 Example:  tf
id
required
string <uuid> 
 
 Example:  4c6d635a-6a21-4dce-a5ef-18ca37ab94e5
header Parameters
Harness-Account
required
string  [ 1 .. 128 ] characters 
Account is the internal customer account ID.


 
 Example:  a
Request Body schema: application/json
required
actioned_by
string
User that approved/rejected the step


 
status
required
string
 Default:  "pending"
Status update to be performed upon the Approval step


 Enum: "approved" "rejected" "pending"  
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}/approvals/{id}
Request samples 
application/json
{
  • "actioned_by": "John Doe",
  • "status": "pending"
}
➔ Next to costs