# Show workspace

Show an individual workspace.

Endpoint: GET /iacm/api/orgs/{org}/projects/{project}/workspaces/{identifier}
Version: 1.0
Security: x-api-key

## Path parameters:

  - `org` (string, required)
    Org is the organisation identifier.
    Example: "1"

  - `project` (string, required)
    Project is the project identifier.
    Example: "5gi"

  - `identifier` (string, required)
    Identifier is the project identifier.
    Example: "8xc"

## Header parameters:

  - `Harness-Account` (string, required)
    Account is the internal customer account ID.
    Example: "yx"

## Response 200 fields (application/json):

  - `account` (string, required)
    Account is the internal customer account ID.
    Example: "ls"

  - `associated_template` (object)
    AssociatedTemplate defines the template details with template_id and version.
    Example: {"template_id":"d","version":"80j"}

  - `associated_template.template_id` (string)
    Template ID of the template associated to the Workspace.
    Example: "d"

  - `associated_template.version` (string)
    Version of the template associated to the Workspace.
    Example: "80j"

  - `backend_locked` (boolean)
    Defines if the remote backend is locked or not
    Example: true

  - `budget` (number)
    define the budget for a specific workspace
    Example: 0.27365077

  - `cost_breakdown_json` (string)
    cost_breakdown_json is the identifier to the breakdown cost file from the current execution that was applied successfully
    Example: "c4a2d99bc28d236098a095277b7eb0718d6be068"

  - `cost_diff_json` (string)
    cost_diff_json is the identifier to the diff cost file between the previous and current successful executions
    Example: "c4a2d99bc28d236098a095277b7eb0718d6be068"

  - `cost_estimation_enabled` (boolean)
    define if cost estimation operations will be performed in this workspace
    Example: true

  - `created` (integer, required)
    Created is the unix timestamp at which the resource was originally created in milliseconds.
    Example: 8718740027912688000

  - `default_pipelines` (object)
    List of default pipelines associated with this workspace and any per-workspace overrides.
    Example: {"Deserunt eligendi consequatur.":{"project_pipeline":"Aspernatur illo qui non.","workspace_pipeline":"Dolorum itaque inventore quisquam eos tempore amet."},"Sit sed.":{"project_pipeline":"Aspernatur illo qui non.","workspace_pipeline":"Dolorum itaque inventore quisquam eos tempore amet."}}

  - `description` (string)
    Description provides long-form text about the resource.
    Example: "this is a more detailed explanation of the resource."

  - `environment_variables` (object, required)
    list of environment variables configured on the workspace.
    Example: {"Fuga repellat laborum perspiciatis eveniet reprehenderit rem.":{"created":4923130726746362000,"key":"q","updated":8423795292849694000,"value":"Vel eum accusantium soluta.","value_type":"secret"}}

  - `identifier` (string, required)
    Workspace identifier.
    Example: "18"

  - `modules_json` (string)
    modules_json is the identifier of any modules metadata associated with this workspace
    Example: "c4a2d99bc28d236098a095277b7eb0718d6be068"

  - `name` (string, required)
    Name is the human readable name for the resource.
    Example: "resource name"

  - `org` (string, required)
    Org is the organisation identifier.
    Example: "4"

  - `project` (string, required)
    Project is the project identifier.
    Example: "23t"

  - `provider_connector` (string, required)
    Provider Connector is the reference to the connector for the infrastructure provider.
    Example: "Quis hic et aut autem dolorum explicabo."

  - `provider_connectors` (array)
    define an array of provider connectors that belong to Workspace
    Example: [{"connector_ref":"7g","created":1627590400,"id":751768966876364300,"terragrunt_provider":true,"type":"aws","updated":1627686800,"workspace_id":2130613011624574000},{"connector_ref":"7g","created":1627590400,"id":751768966876364300,"terragrunt_provider":true,"type":"aws","updated":1627686800,"workspace_id":2130613011624574000},{"connector_ref":"7g","created":1627590400,"id":751768966876364300,"terragrunt_provider":true,"type":"aws","updated":1627686800,"workspace_id":2130613011624574000}]

  - `provider_connectors.connector_ref` (string, required)
    Connector reference in harness platform.
    Example: "6"

  - `provider_connectors.created` (integer)
    Timestamp when the connector was created.
    Example: 1627590400

  - `provider_connectors.id` (integer)
    ID PK for internal uses
    Example: 6011327796386148000

  - `provider_connectors.terragrunt_provider` (boolean)
    Whether this workspace uses terragrunt to provision infrastructure

  - `provider_connectors.type` (string, required)
    Type indicates the connector type.
    Enum: "aws", "azure", "gcp"

  - `provider_connectors.updated` (integer)
    Timestamp when the connector was last updated.
    Example: 1627686800

  - `provider_connectors.workspace_id` (integer)
    Workspace ID FK for internal uses
    Example: 3217464190686301000

  - `providers_json` (string)
    providers_json is the identifier of any modules metadata associated with this workspace
    Example: "c4a2d99bc28d236098a095277b7eb0718d6be068"

  - `provisioner` (string, required)
    Provisioner defines the provisioning tool to use.
    Example: "Aut nihil."

  - `provisioner_data` (string, required)
    Example: "Amet qui sint possimus et blanditiis."

  - `provisioner_version` (string)
    Provisioner Version defines the tool version to use.
    Example: "Fuga id."

  - `prune_sensitive_data` (boolean)
    prune_sensitive_data is a flag to enable or disable pruning of sensitive data
    Example: true

  - `repository` (string)
    Repository is the name of the repository to use.
    Example: "Non cupiditate consectetur."

  - `repository_branch` (string)
    Repository Branch in which the code should be accessed.
    Example: "main"

  - `repository_commit` (string)
    Repository Commit/Tag in which the code should be accessed.
    Example: "abc10ed"

  - `repository_connector` (string, required)
    Repository Connector is the reference to the connector to use for this code.
    Example: "Et quos sunt voluptatum."

  - `repository_path` (string)
    Repository Path is the path in which the infra code resides.

  - `repository_sha` (string)
    Repository SHA in which the code should be accessed.
    Example: "abc10ed"

  - `repository_submodules` (string)
    repository_submodules is the instruction about whether to clone submodules in the pipeline step
    Enum: "false", "true", "recursive"

  - `run_all` (boolean)
    Run-All terragrunt modules.
    Example: true

  - `sparse_checkout` (string)
    List of patterens that will be used for sparse checkout option of git clone
    Example: "Sit accusantium modi labore voluptatibus nesciunt ut."

  - `state_checksum` (string)
    state_checksum is the sha-256 checksum of terraform state file
    Example: "d21c1662d8ce2c74f24efdc8db93eb34473b86810aeccca4b1518f70b0ccde8f"

  - `status` (string, required)
    The status of the workspace
    Enum: "active", "inactive", "provisioning", "destroying", "failed", "unknown"

  - `tags` (string, required)
    Tags associated with the workspace.
    Example: {"foo":"bar"}

  - `terraform_plan_json` (string)
    terraform_plan_json is the identifier to the current state file only in JSON format.
    Example: "f9e21473daaa2674d862b67a1339f4570e86de17"

  - `terraform_state` (string)
    terraform_state is the identifier to the plan file used to create the latest state.
    Example: "fc1200c7a7aa52109d762a9f005b149abef01479"

  - `terraform_state_json` (string)
    terraform_state_json is the identifier to the plan file used to create the latest state only in JSON format.
    Example: "c4a2d99bc28d236098a095277b7eb0718d6be068"

  - `terraform_variable_files` (array)
    define an array of terraform variables files that belong to a different repository
    Example: [{"repository":"Recusandae consequuntur nisi eius facilis.","repository_branch":"main","repository_commit":"abc10ed","repository_connector":"Enim voluptas aut nihil quas.","repository_path":"","repository_sha":"abc10ed"},{"repository":"Recusandae consequuntur nisi eius facilis.","repository_branch":"main","repository_commit":"abc10ed","repository_connector":"Enim voluptas aut nihil quas.","repository_path":"","repository_sha":"abc10ed"},{"repository":"Recusandae consequuntur nisi eius facilis.","repository_branch":"main","repository_commit":"abc10ed","repository_connector":"Enim voluptas aut nihil quas.","repository_path":"","repository_sha":"abc10ed"},{"repository":"Recusandae consequuntur nisi eius facilis.","repository_branch":"main","repository_commit":"abc10ed","repository_connector":"Enim voluptas aut nihil quas.","repository_path":"","repository_sha":"abc10ed"}]

  - `terraform_variables` (object, required)
    list of terraform variables configured on the workspace.
    Example: {"Dolor eius nulla placeat.":{"created":4923130726746362000,"key":"q","updated":8423795292849694000,"value":"Vel eum accusantium soluta.","value_type":"secret"},"Et rerum qui eaque.":{"created":4923130726746362000,"key":"q","updated":8423795292849694000,"value":"Vel eum accusantium soluta.","value_type":"secret"},"Perferendis doloribus vitae quidem unde culpa qui.":{"created":4923130726746362000,"key":"q","updated":8423795292849694000,"value":"Vel eum accusantium soluta.","value_type":"secret"}}

  - `terragrunt_version` (string)
    Terragrunt Version to use when provisioner is terragrunt.
    Example: "Similique perferendis distinctio expedita quidem commodi."

  - `updated` (integer, required)
    Modified is the unix timestamp at which the resource was last modified in milliseconds.
    Example: 3796733883333418500

  - `variable_sets` (array)
    Attached Variable Sets references
    Example: ["Ea illum totam veniam.","Sunt repellat animi.","Itaque fugiat harum ut perferendis cumque.","Consequatur autem nam sint qui."]

## Response 400 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 401 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 403 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 404 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 408 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 409 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 423 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 499 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 500 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 502 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true