Harness

variables

Variables Service handles the API for managing workspace variables.

List workspace variables

List all workspace variables.

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

Org is the organisation identifier.

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

Project is the project identifier.

Example: 9f
workspace
required
string

Workspace is the resource workspace this variable is associated with.

Example: In distinctio laudantium corporis est.
header Parameters
Harness-Account
required
string [ 1 .. 128 ] characters

Account is the internal customer account ID.

Example: 7li
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}/variables
Request samples 
Response samples 
application/json
[
  • {
    },
  • {
    }
]
Create workspace variable
Creates a new workspace variable


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


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


 
 Example:  3n
workspace
required
string
Workspace is the resource workspace this variable is associated with.


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


 
 Example:  c
Request Body schema: application/json
required
key
required
string  [ 1 .. 128 ] characters ^[a-zA-Z0-9_]+$
Key is the identifier for the secret.


 
kind
required
string
Kind is the classfcation of the variable.


 Enum: "env" "tf"  
value
required
string
Value is the value of the secret.


 
value_type
required
string
Type indecates the value type of the secret. In the case of secret this is a
reference to an item in the secret store


 Enum: "string" "secret"  
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}/variables
Request samples 
application/json
{
  • "key": "ei4",
  • "kind": "env",
  • "value": "Itaque quidem fugit eos sint dignissimos aliquid.",
  • "value_type": "secret"
}
Response samples 
application/json
{
  • "account": "r",
  • "created": 1270146940009028000,
  • "key": "d8",
  • "kind": "env",
  • "org": "9n",
  • "policy_evaluation": {
    },
  • "project": "roj",
  • "updated": 6129933213628203000,
  • "value": "Qui quos.",
  • "value_type": "string",
  • "workspace": "Suscipit veritatis aut enim eos non aut."
}
Destroy workspace variable
Deletes the given workspace variable.


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


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


 
 Example:  r
workspace
required
string
Workspace is the resource workspace this variable is associated with.


 
 Example:  Quos nihil explicabo.
kind
required
string
Kind is the classfcation of the variable.


 Enum: "env" "tf"  
 Example:  env
key
required
string  [ 1 .. 128 ] characters ^[a-zA-Z0-9_]+$
Key is the identifier for the secret.


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


 
 Example:  9l0
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}/workspaces/{workspace}/variables/{kind}/{key}
Request samples 
Response samples 
application/json
{
  • "policy_evaluation": {
    }
}
Show workspace variable
Show an individual workspace variable.


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:  akg
workspace
required
string
Workspace is the resource workspace this variable is associated with.


 
 Example:  Saepe aut repellendus aperiam aut laborum.
kind
required
string
Kind is the classfcation of the variable.


 Enum: "env" "tf"  
 Example:  env
key
required
string  [ 1 .. 128 ] characters ^[a-zA-Z0-9_]+$
Key is the identifier for the secret.


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


 
 Example:  n
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}/variables/{kind}/{key}
Request samples 
Response samples 
application/json
{
  • "account": "s11",
  • "created": 8275683458134643000,
  • "key": "pk",
  • "kind": "env",
  • "org": "y",
  • "project": "7zg",
  • "updated": 2699398147245743000,
  • "value": "Rerum ea omnis laborum.",
  • "value_type": "secret",
  • "workspace": "Rerum illo ut voluptatibus labore."
}
Update workspace variable
Updates the given workspace variable with new info.


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:  ry
workspace
required
string
Workspace is the resource workspace this variable is associated with.


 
 Example:  Aut quas qui et aspernatur quisquam consequatur.
kind
required
string
Kind is the classfcation of the variable.


 Enum: "env" "tf"  
 Example:  env
key
required
string  [ 1 .. 128 ] characters ^[a-zA-Z0-9_]+$
Key is the identifier for the secret.


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


 
 Example:  j
Request Body schema: application/json
required
value
required
string
Value is the value of the secret.


 
value_type
required
string
Type indecates the value type of the secret. In the case of secret this is a
reference to an item in the secret store


 Enum: "string" "secret"  
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/{workspace}/variables/{kind}/{key}
Request samples 
application/json
{
  • "value": "Nam eligendi voluptatum illo aliquid quia.",
  • "value_type": "string"
}
Response samples 
application/json
{
  • "policy_evaluation": {
    }
}
Get variables, provider connectors, and variable files
Returns all terraform/environment variables, provider connectors, and variable files for a workspace


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


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


 
 Example:  obs
workspace
required
string
Workspace is the resource workspace this variable is associated with.


 
 Example:  Veniam doloribus aut officia tempore voluptatem.
header Parameters
Harness-Account
required
string  [ 1 .. 128 ] characters 
Account is the internal customer account ID.


 
 Example:  30
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}/variables/merged
Request samples 
Response samples 
application/json
{
  • "environment_variables": [
    ],
  • "provider_connectors": [
    ],
  • "terraform_variables": [
    ],
  • "variable_files": [
    ]
}
➔ Next to Exemptions