---
title: "POST /v1/evaluation/results"
method: POST
path: "/v1/evaluation/results"
tags: ["Evaluation"]
---

# POST /v1/evaluation/results

`POST /v1/evaluation/results`

Creates an evaluation result

## Request body

- EvaluationResult — A evaluation result resource, representing the result after evaluating the target of evaluation with a specific control target_of_evaluation_id, category_name and catalog_id are necessary to get the corresponding AuditScope
  - `id` string, required — Evaluation result id
  - `targetOfEvaluationId` string — The Target of Evaluation ID the evaluation belongs to
  - `auditScopeId` string — The Audit Scope ID the evaluation belongs to
  - `controlId` string — The control id the evaluation was based on
  - `controlCategoryName` string — The category the evaluated control belongs to
  - `controlCatalogId` string — The catalog the evaluated control belongs to
  - `parentControlId` string — Optionally, specifies the parent control ID, if this is a sub-control
  - `status` 'EVALUATION_STATUS_UNSPECIFIED' | 'EVALUATION_STATUS_COMPLIANT' | 'EVALUATION_STATUS_COMPLIANT_MANUALLY' | 'EVALUATION_STATUS_NOT_COMPLIANT' | 'EVALUATION_STATUS_NOT_COMPLIANT_MANUALLY' | 'EVALUATION_STATUS_PENDING', enum, required — Evaluation status
  - `timestamp` string, date-time, required — Time of evaluation
  - `assessmentResultIds` string[], required — List of assessment results because of which the evaluation status is compliant or not compliant
  - `comment` string
  - `validUntil` string, date-time — Optional, but required if the status is one of the "manually" ones. This denotes how long the (manual) created evaluation result is valid. During this time, no automatic results are generated for the specific control.

## Response `200`

OK

- EvaluationResult — A evaluation result resource, representing the result after evaluating the target of evaluation with a specific control target_of_evaluation_id, category_name and catalog_id are necessary to get the corresponding AuditScope
  - `id` string, required — Evaluation result id
  - `targetOfEvaluationId` string — The Target of Evaluation ID the evaluation belongs to
  - `auditScopeId` string — The Audit Scope ID the evaluation belongs to
  - `controlId` string — The control id the evaluation was based on
  - `controlCategoryName` string — The category the evaluated control belongs to
  - `controlCatalogId` string — The catalog the evaluated control belongs to
  - `parentControlId` string — Optionally, specifies the parent control ID, if this is a sub-control
  - `status` 'EVALUATION_STATUS_UNSPECIFIED' | 'EVALUATION_STATUS_COMPLIANT' | 'EVALUATION_STATUS_COMPLIANT_MANUALLY' | 'EVALUATION_STATUS_NOT_COMPLIANT' | 'EVALUATION_STATUS_NOT_COMPLIANT_MANUALLY' | 'EVALUATION_STATUS_PENDING', enum, required — Evaluation status
  - `timestamp` string, date-time, required — Time of evaluation
  - `assessmentResultIds` string[], required — List of assessment results because of which the evaluation status is compliant or not compliant
  - `comment` string
  - `validUntil` string, date-time — Optional, but required if the status is one of the "manually" ones. This denotes how long the (manual) created evaluation result is valid. During this time, no automatic results are generated for the specific control.

## Other responses

- `default` — Default error response

## Changes

> 9 revisions in range; 1 could not be searched.

- **2025-01-08** `837ea0d4ed5c` — 4 breaking, 2 warning, 4 info
  - added the new required request property `assessmentResultIds`
  - the request property `id` became required
  - the request property `status` became required
  - the request property `timestamp` became required
  - …6 more
- **2025-01-08** `020d48e13d66` — 2 info
  - added the new optional request property `auditScopeId`
  - added the optional property `auditScopeId` to the response with the `200` status
- **2024-10-01** `1c4252633c35` — 2 warning, 2 info
  - removed the request property `cloudServiceId`
  - removed the optional property `cloudServiceId` from the response with the `200` status
  - added the new optional request property `certificationTargetId`
  - added the optional property `certificationTargetId` to the response with the `200` status
- **2023-10-10** `3b71dbbb6cc7` — 1 info
  - endpoint added
- **2023-04-19** `d53ceeeb5d17` — 1 breaking
  - api removed without deprecation

[Change history](https://skmtc.dev/clouditor/apis/evaluation-api/changes/v1/evaluation/results/post.md)

---

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