---
title: "POST /create-app-version-app-component"
method: POST
path: "/create-app-version-app-component"
---

# POST /create-app-version-app-component

`POST /create-app-version-app-component`

Creates a new Application Component in the Resilience Hub application.

This API updates the Resilience Hub application draft version. To use this Application Component for running assessments, you must publish the Resilience Hub application using the `PublishAppVersion` API.

## Request body

- object
  - `additionalInfo` object — Currently, there is no supported additional information for Application Components.
  - `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.
  - `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.
  - `id` string — Identifier of the Application Component.
  - `name` string, required — Name of the Application Component.
  - `type` string, required — Type of Application Component. For more information about the types of Application Component, see <a href="https://docs.aws.amazon.com/resilience-hub/latest/userguide/AppComponent.grouping.html">Grouping resources in an AppComponent</a>.

## Response `200`

Success

- CreateAppVersionAppComponentResponse
  - `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.
  - `appComponent` object — List of Application Components that belong to this resource.
    - `additionalInfo` object — <p>Additional configuration parameters for an Resilience Hub application. If you want to implement <code>additionalInfo</code> through the Resilience Hub console rather than using an API call, see <a href="https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html">Configure the application configuration parameters</a>.</p> <note> <p>Currently, this parameter accepts a key-value mapping (in a string format) of only one failover region and one associated account.</p> <p>Key: <code>"failover-regions"</code> </p> <p>Value: <code>"[{"region":"&lt;REGION&gt;", "accounts":[{"id":"&lt;ACCOUNT_ID&gt;"}]}]"</code> </p> </note>
    - `id` string — Identifier of the Application Component.
    - `name` string, required — Name of the Application Component.
    - `type` string, required — The type of Application Component.
  - `appVersion` string, required — Resilience Hub application version.

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