---
title: "Create new Assessment"
method: POST
path: "/v1/well-architected-framework/assessment-definition/create"
tags: ["WafAssessmentDefinitions"]
---

# Create new Assessment

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

Create a new Assessment Definition. The definition is used to manage a set of versions. This request takes no body

## Response `200`

Created

- WellArchitectedFrameworkAssessmentDefinition
  - `sysId` string — Identifier of the definition
  - `createdOn` string, date-time — Definition created on
  - `updatedOn` string, date-time — Definition updated on
  - `headVersion` 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
  - `releaseVersion` 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
  - `tenant_id` string, required — Tenant owning the assessment
  - `owner` string — Owner of the assessment
  - `approver` string — Approver of the assessment
  - `name` string — Name of the assessment
  - `description` string — Description of the assessment
  - `is_active` boolean, required — States if the assessment is active or not
  - `notification_configuration` WellArchitectedFrameworkAssessmentNotification
    - `email_recipients` string[]
    - `webhooks` WellArchitectedFrameworkAssessmentNotificationWebHook[] — webhooks to trigger notifications
      - `webhook_id` string — Webhook ID to trigger notification
      - `__type` string, required — Concrete type used for polymorphic deserialization (discriminator)

## 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)