> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/api-reference/iacm/system.md).

# System

System Service handles the API for health checks and version.

## health system

> Check server health

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"system","description":"System Service handles the API for health checks and version."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/health":{"get":{"tags":["system"],"summary":"health system","description":"Check server health","operationId":"system#health","responses":{"200":{"description":"OK response."}}}}}}
```

## latest-plugin-version system

> Get the latest plugin version

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"system","description":"System Service handles the API for health checks and version."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/latest-plugin-version":{"post":{"tags":["system"],"summary":"latest-plugin-version system","description":"Get the latest plugin version","operationId":"system#latest-plugin-version","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PluginReportedVersion"}}}},"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HarnessIacmPluginversion"}}}}}}}},"components":{"schemas":{"PluginReportedVersion":{"type":"object","properties":{"commit":{"type":"string","description":"Build identifier"},"version":{"type":"string","description":"Version number"}},"description":"Plugin Reported Version","required":["version","commit"]},"HarnessIacmPluginversion":{"type":"object","properties":{"commit":{"type":"string","description":"Build identifier"},"version":{"type":"string","description":"Version number"}},"description":"Plugin version"}}}}
```

## get-provisioner-config system

> Get provisioner configuration with supported versions and settings.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"system","description":"System Service handles the API for health checks and version."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/provisioners/{provisioner}/config":{"get":{"tags":["system"],"summary":"get-provisioner-config system","description":"Get provisioner configuration with supported versions and settings.","operationId":"system#get-provisioner-config","parameters":[{"name":"provisioner","in":"path","description":"Provisioner type to get configuration for.","required":true,"schema":{"type":"string","description":"Provisioner type to get configuration for.","enum":["awscdk","terraform","opentofu","terragrunt","all"]}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvisionerConfig"}}}}}}}},"components":{"schemas":{"ProvisionerConfig":{"type":"object","properties":{"awscdk":{"$ref":"#/components/schemas/CDKConfig"},"opentofu":{"$ref":"#/components/schemas/OpentofuConfig"},"terraform":{"$ref":"#/components/schemas/TerraformConfig"},"terragrunt":{"$ref":"#/components/schemas/TerragruntConfig"}},"description":"Provisioner configuration response"},"CDKConfig":{"type":"object","properties":{"versions":{"type":"object","description":"Map of CDK versions to their configurations","additionalProperties":{"$ref":"#/components/schemas/CDKVersionConfig"}}},"description":"CDK configuration"},"CDKVersionConfig":{"type":"object","properties":{"languages":{"type":"object","description":"Map of language names to their configurations","additionalProperties":{"$ref":"#/components/schemas/LanguageConfig"}}},"description":"Configuration for a specific CDK version"},"LanguageConfig":{"type":"object","properties":{"versions":{"type":"object","description":"Map of language versions to their configurations","additionalProperties":{"$ref":"#/components/schemas/LanguageVersionConfig"}}},"description":"Configuration for a programming language"},"LanguageVersionConfig":{"type":"object","properties":{"package_manager":{"type":"object","description":"Map of package manager names to their supported versions","additionalProperties":{"type":"array","items":{"type":"string"}}}},"description":"Configuration for a specific language version"},"OpentofuConfig":{"type":"object","properties":{"versions":{"type":"array","items":{"type":"string"},"description":"List of supported OpenTofu versions"}},"description":"OpenTofu configuration"},"TerraformConfig":{"type":"object","properties":{"versions":{"type":"array","items":{"type":"string"},"description":"List of supported Terraform versions"}},"description":"Terraform configuration"},"TerragruntConfig":{"type":"object","properties":{"versions":{"type":"array","items":{"type":"string"},"description":"List of supported Terragrunt versions"}},"description":"Terragrunt configuration"}}}}
```

## list-supported-provisioner-versions system

> List supported provisioner versions.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"system","description":"System Service handles the API for health checks and version."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/provisioners/supported/{provisioner}":{"get":{"tags":["system"],"summary":"list-supported-provisioner-versions system","description":"List supported provisioner versions.","operationId":"system#list-supported-provisioner-versions","parameters":[{"name":"provisioner","in":"path","description":"Provisioner defines the provisioning tool to use.","required":true,"schema":{"type":"string","description":"Provisioner defines the provisioning tool to use.","enum":["terraform","opentofu","terragrunt","awscdk"]}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}}}}}}}}
```

## version system

> Get server version

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"system","description":"System Service handles the API for health checks and version."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/version":{"get":{"tags":["system"],"summary":"version system","description":"Get server version","operationId":"system#version","responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceVersion"}}}}}}}},"components":{"schemas":{"ServiceVersion":{"type":"object","properties":{"commit":{"type":"string","description":"Build identifier"},"deployment_mode":{"type":"string","description":"Determines if the service is running on saas or smp","enum":["saas","smp"]},"version":{"type":"string","description":"Version number"}},"description":"Service version","required":["version","commit","deployment_mode"]}}}}
```