---
title: "Start an assessment run for the assessment definition"
method: POST
path: "/v1/well-architected-framework/assessment-run/create"
tags: ["WafAssessmentRuns"]
---

# Start an assessment run for the assessment definition

`POST /v1/well-architected-framework/assessment-run/create`

Create an assessment run for a given Assessment Definition

## Request body

- WellArchitectedFrameworkAssessmentRunCreateRequest
  - `assessment_version` RecordIdentity
    - `sysId` string — Unique Identifier of the tracked item
    - `lastUpdate` string, date-time — Last update of the tracked item
    - `table` string — Context of the tracked item
  - `workload_version` RecordIdentity
    - `sysId` string — Unique Identifier of the tracked item
    - `lastUpdate` string, date-time — Last update of the tracked item
    - `table` string — Context of the tracked item

## Response `200`

Started

- WellArchitectedFrameworkAssessmentRun
  - `sysId` string — ID of the Assessment run
  - `createdOn` string, date-time — Assessment run created on
  - `updatedOn` string, date-time — Assessment run updated on
  - `status` 'InProgress' | 'Abandoned' | 'Completed' — Status of the assessment run
  - `assessment_definition` RecordIdentity
    - `sysId` string — Unique Identifier of the tracked item
    - `lastUpdate` string, date-time — Last update of the tracked item
    - `table` string — Context of the tracked item
  - `assessment_version` RecordIdentity
    - `sysId` string — Unique Identifier of the tracked item
    - `lastUpdate` string, date-time — Last update of the tracked item
    - `table` string — Context of the tracked item
  - `workload_version` RecordIdentity
    - `sysId` string — Unique Identifier of the tracked item
    - `lastUpdate` string, date-time — Last update of the tracked item
    - `table` string — Context of the tracked item
  - `hyperscaler_workload_id` string — ARN of workload created when synced to AWS
  - `sync_failure_reason` string — Sync failure reason

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

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