---
title: "POST /v1/orchestrator/assessment_results"
method: POST
path: "/v1/orchestrator/assessment_results"
tags: ["Orchestrator"]
---

# POST /v1/orchestrator/assessment_results

`POST /v1/orchestrator/assessment_results`

Stores the assessment result provided by an assessment tool

## Request body

- AssessmentResult — A result resource, representing the result after assessing the cloud resource with id resource_id.
  - `id` string, required — Assessment result id
  - `createdAt` string, date-time, required — Time of assessment
  - `metricId` string, required — Reference to the metric the assessment was based on
  - `metricConfiguration` MetricConfiguration, required — Defines the operator and a target value for an individual metric
    - `operator` string, required — The operator to compare the metric, such as == or >
    - `targetValue` unknown, required
    - `isDefault` boolean, required — Whether this configuration is a default configuration
    - `updatedAt` string, date-time — The last time of update
    - `metricId` string, required — The metric this configuration belongs to
    - `targetOfEvaluationId` string, required — The target of evaluation this configuration belongs to
  - `compliant` boolean — Compliant case: true or false
  - `evidenceId` string, required — Reference to the last assessed evidence
  - `resourceId` string, required — Reference to the resource of the assessed evidence
  - `resourceTypes` string[], required — Resource types
  - `complianceComment` string, required — ComplianceComment contains a human readable description on the reason for (non)-compliance.
  - `complianceDetails` ComparisonResult[] — ComplianceDetails contains machine-readable details about which comparisons lead to a (non)-compliance.
    - `property` string, required — Property is the property that was compared
    - `value` unknown, required
    - `operator` string, required — Operator is the operator used in the comparison
    - `targetValue` unknown, required
    - `success` boolean, required — Success is true, if the comparison was sucessful
  - `targetOfEvaluationId` string, required — The target of evaluation which this assessment result belongs to
  - `toolId` string, required — Reference to the tool which provided the assessment result
  - `historyUpdatedAt` string, date-time, required — The time of the last update of the assessment result history field
  - `history` Record[], required — Stores the history of evidence IDs and timestamps for evidence that have the same content as the evidence used for this assessment result.
    - `evidenceId` string, required
    - `evidenceRecordedAt` string, date-time, required

## Response `200`

OK

- StoreAssessmentResultResponse — StoreAssessmentResultReponse belongs to StoreAssessmentResult, which uses a custom unary RPC and therefore requires a response message according to the style convention. Since no return values are required, this is empty.

## Other responses

- `default` — Default error response

## Changes

- **2025-07-16** `36dbd5beec62` — 3 breaking, 1 warning
  - added the new required request property `createdAt`
  - added the new required request property `history`
  - added the new required request property `historyUpdatedAt`
  - removed the request property `timestamp`
- **2025-03-27** `f2db05790701` — 2 breaking, 2 warning
  - added the new required request property `metricConfiguration/allOf[#/components/schemas/MetricConfiguration]/targetOfEvaluationId`
  - added the new required request property `targetOfEvaluationId`
  - removed the request property `certificationTargetId`
  - removed the request property `metricConfiguration/allOf[#/components/schemas/MetricConfiguration]/certificationTargetId`
- **2025-01-08** `2b79660c20a0` — 15 breaking, 2 warning, 1 info
  - added the new required request property `complianceComment`
  - the request property `certificationTargetId` became required
  - the request property `evidenceId` became required
  - the request property `id` became required
  - …14 more
- **2024-10-16** `161557f4ca31` — 1 info
  - added the new optional request property `nonComplianceDetails`
- …earlier changes not shown

[Full history](https://skmtc.dev/clouditor/apis/orchestrator-api/changes/v1/orchestrator/assessment_results/post.md)

---

[API](https://skmtc.dev/clouditor/apis/orchestrator-api.md) · [All operations](https://skmtc.dev/clouditor/apis/orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clouditor/orchestrator-api/revisions/6f8ae69f4eb5/schema)