---
title: "POST /start-app-assessment"
method: POST
path: "/start-app-assessment"
---

# POST /start-app-assessment

`POST /start-app-assessment`

Creates a new application assessment for an application.

## Request body

- object
  - `appArn` string, required — Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:<code>partition</code>:resiliencehub:<code>region</code>:<code>account</code>:app/<code>app-id</code>. For more information about ARNs, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html"> Amazon Resource Names (ARNs)</a> in the <i>Amazon Web Services General Reference</i> guide.
  - `appVersion` string, required — The version of the application.
  - `assessmentName` string, required — The name for the assessment.
  - `clientToken` string — Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.
  - `tags` object — Tags assigned to the resource. A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key/value pair.

## Response `200`

Success

- StartAppAssessmentResponse
  - `assessment` object, required — The assessment created.
    - `appArn` string — Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:<code>partition</code>:resiliencehub:<code>region</code>:<code>account</code>:app/<code>app-id</code>. For more information about ARNs, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html"> Amazon Resource Names (ARNs)</a> in the <i>Amazon Web Services General Reference</i> guide.
    - `appVersion` string — Version of an application.
    - `assessmentArn` string, required — Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn:<code>partition</code>:resiliencehub:<code>region</code>:<code>account</code>:app-assessment/<code>app-id</code>. For more information about ARNs, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html"> Amazon Resource Names (ARNs)</a> in the <i>Amazon Web Services General Reference</i> guide.
    - `assessmentName` string — Name of the assessment.
    - `assessmentStatus` 'Pending' | 'InProgress' | 'Failed' | 'Success', required — Current status of the assessment for the resiliency policy.
    - `compliance` object — Application compliance against the resiliency policy.
    - `complianceStatus` 'PolicyBreached' | 'PolicyMet' | 'NotApplicable' | 'MissingPolicy' — Current status of the compliance for the resiliency policy.
    - `cost` object — Cost for the application.
      - `amount` number, double, required — The cost amount.
      - `currency` string, required — The cost currency, for example <code>USD</code>.
      - `frequency` 'Hourly' | 'Daily' | 'Monthly' | 'Yearly', required — The cost frequency.
    - `driftStatus` 'NotChecked' | 'NotDetected' | 'Detected' — Indicates if compliance drifts (deviations) were detected while running an assessment for your application.
    - `endTime` string, date-time — End time for the action.
    - `invoker` 'User' | 'System', required — The entity that invoked the assessment.
    - `message` string — Error or warning message from the assessment execution
    - `policy` object — Resiliency policy of an application.
      - `creationTime` string, date-time — Date and time when the resiliency policy was created.
      - `dataLocationConstraint` 'AnyLocation' | 'SameContinent' | 'SameCountry' — Specifies a high-level geographical location constraint for where your resilience policy data can be stored.
      - `estimatedCostTier` 'L1' | 'L2' | 'L3' | 'L4' — Specifies the estimated cost tier of the resiliency policy.
      - `policy` object — The resiliency policy.
      - `policyArn` string — Amazon Resource Name (ARN) of the resiliency policy. The format for this ARN is: arn:<code>partition</code>:resiliencehub:<code>region</code>:<code>account</code>:resiliency-policy/<code>policy-id</code>. For more information about ARNs, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html"> Amazon Resource Names (ARNs)</a> in the <i>Amazon Web Services General Reference</i> guide.
      - `policyDescription` string — Description of the resiliency policy.
      - `policyName` string — The name of the policy
      - `tags` object — Tags assigned to the resource. A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key/value pair.
      - `tier` 'MissionCritical' | 'Critical' | 'Important' | 'CoreServices' | 'NonCritical' | 'NotApplicable' — The tier for this resiliency policy, ranging from the highest severity (<code>MissionCritical</code>) to lowest (<code>NonCritical</code>).
    - `resiliencyScore` object — Current resiliency score for an application.
      - `componentScore` object — <p>The score generated by Resilience Hub for the scoring component after running an assessment.</p> <p>For example, if the <code>score</code> is 25 points, it indicates the overall score of your application generated by Resilience Hub after running an assessment.</p>
      - `disruptionScore` object, required — The disruption score for a valid key.
      - `score` number, double, required — The outage score for a valid key.
    - `resourceErrorsDetails` object — A resource error object containing a list of errors retrieving an application's resources.
      - `hasMoreErrors` boolean — This indicates if there are more errors not listed in the <code>resourceErrors</code> list.
      - `resourceErrors` ResourceError[] — A list of errors retrieving an application's resources.
        - `logicalResourceId` string — Identifier of the logical resource.
        - `physicalResourceId` string — Identifier of the physical resource.
        - `reason` string — This is the error message.
    - `startTime` string, date-time — Starting time for the action.
    - `summary` object — <p>Indicates the AI-generated summary for the Resilience Hub assessment, providing a concise overview that highlights the top risks and recommendations.</p> <note> <p>This property is available only in the US East (N. Virginia) Region.</p> </note>
      - `riskRecommendations` AssessmentRiskRecommendation[] — <p>Indicates the top risks and recommendations identified by the Resilience Hub assessment, each representing a specific risk and the corresponding recommendation to address it.</p> <note> <p>This property is available only in the US East (N. Virginia) Region.</p> </note>
        - `appComponents` String255[] — <p>Indicates the Application Components (AppComponents) that were assessed as part of the assessment and are associated with the identified risk and recommendation.</p> <note> <p>This property is available only in the US East (N. Virginia) Region.</p> </note>
        - `recommendation` string — <p>Indicates the recommendation provided by the Resilience Hub to address the identified risks in the application.</p> <note> <p>This property is available only in the US East (N. Virginia) Region.</p> </note>
        - `risk` string — <p>Indicates the description of the potential risk identified in the application as part of the Resilience Hub assessment.</p> <note> <p>This property is available only in the US East (N. Virginia) Region.</p> </note>
      - `summary` string — <p>Indicates a concise summary that provides an overview of the Resilience Hub assessment.</p> <note> <p>This property is available only in the US East (N. Virginia) Region.</p> </note>
    - `tags` object — Tags assigned to the resource. A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key/value pair.
    - `versionName` string — Version name of the published application.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — ConflictException
- `483` — ServiceQuotaExceededException
- `484` — ThrottlingException
- `485` — ValidationException
- `486` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/resiliencehub.md) · [All operations](https://skmtc.net/aws/apis/resiliencehub/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/resiliencehub/versions/163b82209f70/schema)
