workspaces

Workspaces Service handles the API for managing workspaces and triggering workflows against them.

list-workspaces workspaces

List all workspaces.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: c
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
searchTerm
string
Default: ""

Filter results by partial name match

Example: searchTerm=mysta
sort
string
Default: "name,ASC"

Sort order for results

Enum: "name,ASC" "name,DESC" "updated,ASC" "updated,DESC"
Example: sort=updated,ASC
status
Array of strings

Status of the execution

Example: status=Labore eos quae necessitatibus sit.&status=Ea veniam blanditiis eaque.&status=Rerum magni ut voluptate consequatur rerum cupiditate.
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: c3
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}/workspaces
Request samples
Response samples
application/json
[
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

create-workspace workspaces

Create a new workspace.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: ax
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: 6
Request Body schema: application/json
required
budget
number <float>

define the budget for a specific workspace

cost_breakdown_json
string

cost_breakdown_json is the identifier to the breakdown cost file from the current execution that was applied successfully

cost_diff_json
string

cost_diff_json is the identifier to the diff cost file between the previous and current successful executions

cost_estimation_enabled
boolean
Default: false

define if cost estimation operations will be performed in this workspace

object

List of default pipelines associated with this workspace and any per-workspace overrrides.

description
string

Description provides long-form text about the resource.

required
object

list of environment variables configured on the workspace.

identifier
required
string [ 1 .. 128 ] characters

Workspace identifier.

name
required
string [ 1 .. 128 ] characters

Name is the human readable name for the resource.

provider_connector
required
string

Provider Connector is the reference to the connector for the infrastructure provider.

provisioner
required
string

Provisioner defines the provisioning tool to use.

Enum: "terraform" "opentofu"
provisioner_version
string
Default: "latest"

Provisioner Version defines the tool version to use.

repository
string

Repository is the name of the repository to use.

repository_branch
string

Repository Branch in which the code should be accessed.

repository_commit
string

Repository Commit/Tag in which the code should be accessed.

repository_connector
string

Repository Connector is the reference to the connector to use for this code.

repository_path
string
Default: ""

Repository Path is the path in which the infra code resides.

repository_sha
string

Repository SHA in which the code should be accessed.

terraform_plan_json
string

terraform_plan_json is the identifier to the current state file onl in JSON format.

terraform_state
string

terraform_state is the identifier to the plan file used to create the latest state.

terraform_state_json
string

terraform_state_json is the identifier to the plan file used to create the latest state only in JSON format.

Array of objects (WorkspaceTerraformVariableFiles)

define an array of terraform variables files that belong to a different repository

required
object

list of terraform variables configured on the workspace.

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}/workspaces
Request samples
application/json
{
  • "budget": 0.32656446,
  • "cost_breakdown_json": "c4a2d99bc28d236098a095277b7eb0718d6be068",
  • "cost_diff_json": "c4a2d99bc28d236098a095277b7eb0718d6be068",
  • "cost_estimation_enabled": true,
  • "default_pipelines": {
    },
  • "description": "this is a more detailed explanation of the resource.",
  • "environment_variables": {
    },
  • "identifier": "mc",
  • "name": "resource name",
  • "provider_connector": "Ducimus eos et ut et sunt veritatis.",
  • "provisioner": "opentofu",
  • "provisioner_version": "Harum vel nisi eum.",
  • "repository": "Delectus quasi totam.",
  • "repository_branch": "main",
  • "repository_commit": "abc10ed",
  • "repository_connector": "Eius eveniet illum.",
  • "repository_path": "",
  • "repository_sha": "abc10ed",
  • "terraform_plan_json": "f9e21473daaa2674d862b67a1339f4570e86de17",
  • "terraform_state": "fc1200c7a7aa52109d762a9f005b149abef01479",
  • "terraform_state_json": "c4a2d99bc28d236098a095277b7eb0718d6be068",
  • "terraform_variable_files": [
    ],
  • "terraform_variables": {
    }
}
Response samples
application/json
{
  • "policy_evaluation": {
    }
}

destroy-workspace workspaces

Deletes the given workspace.

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

Org is the organisation identifier.

Example: 5o
project
required
string [ 1 .. 128 ] characters

Project is the project identifier.

Example: s
identifier
required
string [ 1 .. 128 ] characters

Identifier is the project identifier.

Example: xty
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: ev
Responses
204

No Content 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}/workspaces/{identifier}
Request samples

show-workspace workspaces

Show an individual workspace.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: f
identifier
required
string [ 1 .. 128 ] characters

Identifier is the project identifier.

Example: r
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: l7
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}/workspaces/{identifier}
Request samples
Response samples
application/json
{
  • "account": "fd",
  • "backend_locked": true,
  • "budget": 0.69633406,
  • "cost_breakdown_json": "c4a2d99bc28d236098a095277b7eb0718d6be068",
  • "cost_diff_json": "c4a2d99bc28d236098a095277b7eb0718d6be068",
  • "cost_estimation_enabled": true,
  • "created": 621702037112282500,
  • "default_pipelines": {
    },
  • "description": "this is a more detailed explanation of the resource.",
  • "environment_variables": {
    },
  • "identifier": "u",
  • "name": "resource name",
  • "org": "ec",
  • "project": "4kn",
  • "provider_connector": "Impedit eius totam sit ut eius.",
  • "provisioner": "terraform",
  • "provisioner_data": "Dolores voluptatem et sint.",
  • "provisioner_version": "Quo architecto omnis.",
  • "repository": "Minus voluptate voluptatum nisi.",
  • "repository_branch": "main",
  • "repository_commit": "abc10ed",
  • "repository_connector": "Voluptatibus architecto a quo aut.",
  • "repository_path": "",
  • "repository_sha": "abc10ed",
  • "status": "provisioning",
  • "terraform_plan_json": "f9e21473daaa2674d862b67a1339f4570e86de17",
  • "terraform_state": "fc1200c7a7aa52109d762a9f005b149abef01479",
  • "terraform_state_json": "c4a2d99bc28d236098a095277b7eb0718d6be068",
  • "terraform_variable_files": [
    ],
  • "terraform_variables": {
    },
  • "updated": 5815378118461004000
}

update-workspace workspaces

Updates the given workspace with new info.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: 9f
identifier
required
string [ 1 .. 128 ] characters

Workspace identifier.

Example: ir
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: e
Request Body schema: application/json
required
budget
number <float>

define the budget for a specific workspace

cost_estimation_enabled
boolean
Default: false

define if cost estimation operations will be performed in this workspace

object

List of default pipelines associated with this workspace and any per-workspace overrrides.

description
string

Description provides long-form text about the resource.

required
object

list of environment variables configured on the workspace.

name
required
string [ 1 .. 128 ] characters

Name is the human readable name for the resource.

provider_connector
required
string

Provider Connector is the reference to the connector for the infrastructure provider.

provisioner
required
string

Provisioner defines the provisioning tool to use.

Enum: "terraform" "opentofu"
provisioner_version
string
Default: "latest"

Provisioner Version defines the tool version to use.

repository
string

Repository is the name of the repository to use.

repository_branch
string

Repository Branch in which the code should be accessed.

repository_commit
string

Repository Commit/Tag in which the code should be accessed.

repository_connector
string

Repository Connector is the reference to the connector to use for this code.

repository_path
string
Default: ""

Repository Path is the path in which the infra code resides.

repository_sha
string

Repository SHA in which the code should be accessed.

Array of objects (WorkspaceTerraformVariableFiles)

define an array of terraform variables files that belong to a different repository

required
object

list of terraform variables configured on the workspace.

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}/workspaces/{identifier}
Request samples
application/json
{
  • "budget": 0.72022957,
  • "cost_estimation_enabled": true,
  • "default_pipelines": {
    },
  • "description": "this is a more detailed explanation of the resource.",
  • "environment_variables": {
    },
  • "name": "resource name",
  • "provider_connector": "Placeat voluptatum dicta voluptatem.",
  • "provisioner": "opentofu",
  • "provisioner_version": "Quibusdam ad eos ut voluptatem praesentium asperiores.",
  • "repository": "Eaque ut totam adipisci.",
  • "repository_branch": "main",
  • "repository_commit": "abc10ed",
  • "repository_connector": "Blanditiis ipsum ipsam.",
  • "repository_path": "",
  • "repository_sha": "abc10ed",
  • "terraform_variable_files": [
    ],
  • "terraform_variables": {
    }
}
Response samples
application/json
{
  • "policy_evaluation": {
    }
}

force-unlock-workspace workspaces

Force unlock a workspace.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: 0
identifier
required
string [ 1 .. 128 ] characters

Identifier is the project identifier.

Example: xa
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: ztb
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}/workspaces/{identifier}/actions/force-unlock
Request samples

list-resources workspaces

List resources associated with this workspace.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: xg
identifier
required
string [ 1 .. 128 ] characters

Identifier is the project identifier.

Example: a6
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: 1j
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}/workspaces/{identifier}/resources
Request samples
Response samples
application/json
{
  • "outputs": [
    ],
  • "resources": [
    ]
}

clone-workspace workspaces

Clone the given workspace with new name.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: hs8
workspace
required
string
Example: Et non magni impedit dicta alias.
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: 6w0
Request Body schema: application/json
required
identifier
required
string [ 1 .. 128 ] characters

Workspace identifier.

name
required
string [ 1 .. 128 ] characters

Name is the human readable name for the resource.

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}/workspaces/{workspace}/clone
Request samples
application/json
{
  • "identifier": "s",
  • "name": "resource name"
}
Response samples
application/json
{
  • "policy_evaluation": {
    }
}

list-data workspaces

List all stored data for a workspace.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: l
workspace
required
string

Workspace identifier

Example: Suscipit aliquam quaerat deleniti odio temporibus.
query Parameters
pipeline_execution_id
string

Filter by pipeline execution ID

Example: pipeline_execution_id=Iure sunt.
pipeline_stage_id
string

Filter by pipeline execution stage ID

Example: pipeline_stage_id=Voluptas inventore corporis voluptatem id et nisi.
provisioner_type
string

Filter by provisioner type

Example: provisioner_type=Nihil molestiae iure.
data_type
string

Filter by data type

Example: data_type=Aspernatur illum ea aut voluptatem esse.
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
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: 6
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}/workspaces/{workspace}/data
Request samples
Response samples
application/json
[
  • {
    },
  • {
    }
]

create-data workspaces

Store binary data generated by the provisioner, such as plans and state files.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: 2
workspace
required
string

Workspace identifier

Example: workspace123
query Parameters
pipeline_id
required
string

The unique identifier for the associated pipeline

Example: pipeline_id=Quia sint non minus magnam.
stage_id
required
string

The unique identifier for a stage

Example: stage_id=Iste molestiae at dolorem non.
pipeline_execution_id
required
string

The unique identifier for the associated pipeline execution

Example: pipeline_execution_id=Sit blanditiis adipisci maiores omnis.
pipeline_stage_id
required
string

The unique identifier for the associated pipeline execution stage

Example: pipeline_stage_id=Aliquam sit consequatur magnam quaerat quisquam.
provisioner_type
required
string

Type of provisioner that created the data

Value: "tf"
Example: provisioner_type=tf
data_type
required
string

Type of data stored

Enum: "plan_human" "state_raw" "state_human" "cost_breakdown" "cost_diff"
Example: data_type=state_raw
policy_action
string

Policy action used during OPA evaluation

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

Account is the internal customer account ID.

Example: 2ww
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}/workspaces/{workspace}/data
Request samples
Response samples
application/json
{
  • "id": "dc538c61-de48-4220-958c-5f3c4f983daa",
  • "policy_evaluation": [
    ],
  • "policy_evaluation_message": "- instance type 'xlarge' is not permitted",
  • "policy_evaluation_status": "error"
}

show-data workspaces

Get binary data generated by the provisioner, such as plans and state files.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: an
workspace
required
string

Workspace is the resource workspace this variable is associated with.

Example: Aut qui voluptas facere rerum laboriosam qui.
id
required
string

The unique identifier for the data

Example: dc538c61-de48-4220-958c-5f3c4f983daa
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: nbm
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}/workspaces/{workspace}/data/{id}
Request samples
Response samples
application/json
"string"

evaluate-data workspaces

Evaluate policy against previously stored data, such as plans and state files.

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

Org is the organisation identifier.

Example: 3fg
project
required
string [ 1 .. 128 ] characters

Project is the project identifier.

Example: au
workspace
required
string

Workspace is the resource workspace this variable is associated with.

Example: Eius qui numquam quas ipsa.
id
required
string

The unique identifier for the data

Example: dc538c61-de48-4220-958c-5f3c4f983daa
query Parameters
pipeline_execution_id
string

Pipeline execution associated with this evaluation

Example: pipeline_execution_id=Voluptas laborum sunt eveniet.
policy_action
required
string

Policy action used during OPA evaluation

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

Account is the internal customer account ID.

Example: bft
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}/workspaces/{workspace}/data/{id}/evaluate-policy
Request samples
Response samples
application/json
{
  • "id": "dc538c61-de48-4220-958c-5f3c4f983daa",
  • "policy_evaluation": [
    ],
  • "policy_evaluation_message": "- instance type 'xlarge' is not permitted",
  • "policy_evaluation_status": "error"
}

send-event workspaces

Store binary data generated by the provisioner, such as plans and state files.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: 4
workspace
required
string [ 1 .. 1024 ] characters

Workspace associated with this event

Example: a
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: 4
Request Body schema: application/json
required
object
event_type
required
string

The type of event that occurred

Enum: "plan" "drifted" "provisioning" "destroying" "active" "inactive" "failed"
object (ActivityMetadata)
pipeline_execution_id
string
Default: ""

Deprecated: use metadata instead

pipeline_stage_id
string
Default: ""

Deprecated: use metadata instead

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}/workspaces/{workspace}/events
Request samples
application/json
{
  • "data": {
    },
  • "event_type": "failed",
  • "metadata": {
    },
  • "pipeline_execution_id": "Optio sint aut eum enim sit.",
  • "pipeline_stage_id": "Temporibus autem voluptatibus eveniet."
}

list-pipelines workspaces

List the pipelines where the workspace is been used

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

Org is the organisation identifier.

Example: 6h
project
required
string [ 1 .. 128 ] characters

Project is the project identifier.

Example: qes
workspace
required
string

Workspace identifier

Example: Reprehenderit sequi enim enim.
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
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: 10
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}/workspaces/{workspace}/pipelines
Request samples
Response samples
application/json
{
  • "account": "c",
  • "org": "2r",
  • "pipelines": [
    ],
  • "project": "zr"
}

create-speculative-plan workspaces

Create a speculative plan for a workspace.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: p
workspace
required
string

The workspace associated with the speculative plan.

Example: Sed natus.
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: z
Responses
201

Created 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}/workspaces/{workspace}/speculative-plans
Request samples
Response samples
application/json
{
  • "account": "3z",
  • "created": 3445342921537919500,
  • "executed": true,
  • "id": "e43bf7d5-e90c-446e-8be4-dd1e2e07d95b",
  • "org": "yk3",
  • "pipeline_execution_id": "Eum maiores voluptate aut.",
  • "pipeline_execution_url": "Ipsa earum a necessitatibus numquam.",
  • "project": "54e",
  • "sha256_checksum": "Sint voluptas dolores similique et laudantium voluptas.",
  • "updated": 2608797972627052500,
  • "workspace": "Vel sit similique ex quia vitae ut."
}

find-speculative-plan workspaces

Find speculative plan

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: x
workspace
required
string

Workspace is the resource workspace this variable is associated with.

Example: Consectetur officiis ut cum.
id
required
string <uuid>

The ID of the speculative plan.

Example: 1c5ba97e-4cdd-41db-bf3e-e38bba217b19
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: j
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}/workspaces/{workspace}/speculative-plans/{id}
Request samples
Response samples
application/json
{
  • "account": "zs8",
  • "created": 4607456546116372500,
  • "executed": true,
  • "id": "4d57eb6c-a0e7-46a4-83ad-3e24d045b936",
  • "org": "6d",
  • "pipeline_execution_id": "Eius ut dolor exercitationem officiis ut dignissimos.",
  • "pipeline_execution_url": "Ratione rerum numquam ut.",
  • "project": "j",
  • "sha256_checksum": "Vero eos sequi alias.",
  • "updated": 1514955751162670600,
  • "workspace": "Et et praesentium."
}

download-speculative-plan workspaces

Download the source code diff for the speculative plan.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: 92
workspace
required
string

Workspace is the resource workspace this variable is associated with.

Example: Sequi nihil impedit nisi cumque asperiores ut.
id
required
string <uuid>

The ID of the speculative plan.

Example: e137aa9f-3a94-4ccc-af98-e2d2ecffd01b
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: 6
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}/workspaces/{workspace}/speculative-plans/{id}/download
Request samples
Response samples
application/json
"string"

execute-speculative-plan workspaces

Execute the speculative plan

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: 9e
workspace
required
string

Workspace is the resource workspace this variable is associated with.

Example: Nemo autem sint impedit dolorem.
id
required
string <uuid>

The ID of the speculative plan.

Example: 8bb9a26c-1aa3-46ce-b142-e18818532a96
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: z2
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}/workspaces/{workspace}/speculative-plans/{id}/execute
Request samples
Response samples
application/json
{
  • "account": "r",
  • "created": 2084420558530537700,
  • "executed": false,
  • "id": "4511a95e-b7ef-4349-8990-f340e853c1b1",
  • "org": "d",
  • "pipeline_execution_id": "Accusantium reiciendis maxime tempora.",
  • "pipeline_execution_url": "Ea culpa explicabo voluptas.",
  • "project": "y",
  • "sha256_checksum": "In aspernatur debitis neque nostrum repellendus.",
  • "updated": 4422666637651784000,
  • "workspace": "Quisquam repellat nam blanditiis mollitia nam nobis."
}

upload-speculative-plan workspaces

Upload the source code diff for the speculative plan.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: b
workspace
required
string

Workspace is the resource workspace this variable is associated with.

Example: Minus debitis quaerat debitis dolores.
id
required
string <uuid>

The ID of the speculative plan.

Example: 9d8dd31d-40ab-498b-8fab-5ae73a029c33
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: mw
Content-Digest
required
string

Content-Digest header as defined in https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Digest. Sha256 is the only supported algorithm.

Example: Et ab est et eos sit qui.
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}/workspaces/{workspace}/speculative-plans/{id}/upload
Request samples
Response samples
application/json
{
  • "account": "pya",
  • "created": 7531938199277998000,
  • "executed": false,
  • "id": "9d868462-033e-466d-8e1a-eb01f9c77f14",
  • "org": "py",
  • "pipeline_execution_id": "Ea odit temporibus qui perspiciatis.",
  • "pipeline_execution_url": "Harum suscipit quia modi et quis maiores.",
  • "project": "k",
  • "sha256_checksum": "Et voluptas aspernatur autem.",
  • "updated": 6778418678030238000,
  • "workspace": "Modi repellendus illo quae similique."
}