---
title: "POST /v1/assessment/evidences"
method: POST
path: "/v1/assessment/evidences"
tags: ["Assessment"]
---

# POST /v1/assessment/evidences

`POST /v1/assessment/evidences`

Assesses the evidence sent by the discovery. Part of the public API, also
 exposed as REST.

## Request body

- Evidence — An evidence resource
  - `id` string — the ID in a uuid format
  - `timestamp` string, date-time — time of evidence creation
  - `targetOfEvaluationId` string — Reference to a target of evaluation (e.g., service, organization) this evidence was gathered from
  - `toolId` string — Reference to the tool which provided the evidence
  - `resource` Resource — Resource is a wrapper around google.protobuf.Value that is needed for persistence reasons.
    - `id` string, required — Id contains a unique ID for each resource. This is specific for the cloud provider this resource was gathered for and can for example be a resource URL.
    - `targetOfEvaluationId` string, required — TargetOfEvaluationId is the UUID for the target of evaluation to which this resource belongs to.
    - `resourceType` string, required — ResourceType contains a comma separated string of resource types according to our ontology.
    - `toolId` string, required — Reference to the tool which provided the resource
    - `properties` GoogleProtobufAny, required — Contains an arbitrary serialized message along with a @type that describes the type of the serialized message.
      - `@type` string — The type of the serialized message.
  - `experimentalRelatedResourceIds` string[] — Very experimental property. Use at own risk. This property will be deleted again. Related resource IDs. The assessment will wait until all evidences for related resource have arrived in the assessment and are recent enough. In the future, this will be replaced with information in the "related" edges in the resource. For now, this needs to be set manually in the evidence.

## Response `200`

OK

- AssessEvidenceResponse — AssessEvidenceResponse belongs to AssessEvidence, 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.
  - `status` 'ASSESSMENT_STATUS_UNSPECIFIED' | 'ASSESSMENT_STATUS_WAITING_FOR_RELATED' | 'ASSESSMENT_STATUS_ASSESSED' | 'ASSESSMENT_STATUS_FAILED', enum

## Other responses

- `default` — Default error response

## Changes

- **2026-07-17** `a2bb419632db` — 5 breaking, 52 warning
  - added the new required request property `resource/allOf[#/components/schemas/Resource]/id`
  - added the new required request property `resource/allOf[#/components/schemas/Resource]/properties`
  - added the new required request property `resource/allOf[#/components/schemas/Resource]/resourceType`
  - added the new required request property `resource/allOf[#/components/schemas/Resource]/targetOfEvaluationId`
  - …53 more
- **2025-04-07** `7c2efb798a79` — 7 breaking, 5 warning, 19 info
  - the `resource/allOf[#/components/schemas/Resource]/genericDocument/securityFeatures/items/l3Firewall/restrictedPorts` request property type/format changed from `array`/`` to `string`/``
  - the `resource/allOf[#/components/schemas/Resource]/identity/authorization/l3Firewall/restrictedPorts` request property type/format changed from `array`/`` to `string`/``
  - the `resource/allOf[#/components/schemas/Resource]/loadBalancer/accessRestriction/l3Firewall/restrictedPorts` request property type/format changed from `array`/`` to `string`/``
  - the `resource/allOf[#/components/schemas/Resource]/networkInterface/accessRestriction/l3Firewall/restrictedPorts` request property type/format changed from `array`/`` to `string`/``
  - …27 more
- …earlier changes not shown

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

---

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