Assessment Results API

An Assessment Result is the summary record of an instance of health assessment. HCP Terraform can perform automatic health assessments in a workspace to assess whether its real infrastructure matches the requirements defined in its Terraform configuration. Refer to Health for more details.

Show Assessment Result

Any user with read access to a workspace can retrieve assessment results for the workspace.

GET api/v2/assessment-results/:assessment_result_id

Sample Request

$ curl \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/vnd.api+json" \
  https://app.terraform.io/api/v2/assessment-results/asmtres-cHh5777xm

Sample Response

{
  "id": "asmtres-UG5rE9L1373hMYMA",
  "type": "assessment-results",
  "data": {
    "attributes": {
      "drifted": true,
      "succeeded": true,
      "error-msg": null,
      "created-at": "2022-07-02T22:29:58+00:00",
    },
    "links": {
      "self": "/api/v2/assessment-results/asmtres-UG5rE9L1373hMYMA/"
      "json-output": "/api/v2/assessment-results/asmtres-UG5rE9L1373hMYMA/json-output"
      "json-schema": "/api/v2/assessment-results/asmtres-UG5rE9L1373hMYMA/json-schema"
      "log-output": "/api/v2/assessment-results/asmtres-UG5rE9L1373hMYMA/log-output"
    }
  }
}

Retrieve the JSON output from the assessment execution

The following endpoints retrieve files documenting the plan, schema, and logged runtime associated with the specified assessment result. They provide complete context for an assessment result. The responses do not adhere to JSON API spec.

You cannot access these endpoints with organization tokens. You must access them with a user token or team token that has admin level access to the workspace. Refer to Permissions for details.

JSON Plan

The following endpoint returns the JSON plan output associated with the assessment result.

GET api/v2/assessment-results/:assessment_result_id/json-output

Sample Request

$ curl \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/vnd.api+json" \
  https://app.terraform.io/api/v2/assessment-results/asmtres-cHh5777xm/json-output

JSON Schema file

The following endpoint returns the JSON provider schema associated with the assessment result.

GET api/v2/assessment-results/:assessment_result_id/json-schema

Sample Request

$ curl \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/vnd.api+json" \
  https://app.terraform.io/api/v2/assessment-results/asmtres-cHh5777xm/json-schema

JSON Log Output

The following endpoint returns Terraform JSON log output.

GET api/v2/assessment-results/assessment_result_id/log-output

Sample Request

$ curl \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/vnd.api+json" \
  https://app.terraform.io/api/v2/assessment-results/asmtres-cHh5777xm/log-output