---
title: "POST /applications"
method: POST
path: "/applications"
---

# POST /applications

`POST /applications`

Creates a new application with given parameters. Requires an existing runtime environment and application definition file.

## Request body

- object
  - `clientToken` string — A client token is a unique, case-sensitive string of up to 128 ASCII characters with ASCII values of 33-126 inclusive. It is generated by the client to ensure idempotent operations, allowing safe retries without unintended side effects.
  - `definition` object, required — The application definition for a particular application.
    - `content` string — The content of the application definition. This is a JSON object that contains the resource configuration/definitions that identify an application.
    - `s3Location` string — The S3 bucket that contains the application definition.
  - `description` string — The description of the application.
  - `engineType` 'microfocus' | 'bluage', required — The type of the target platform for this application.
  - `kmsKeyId` string — The identifier of a customer managed key.
  - `name` string, required — The unique identifier of the application.
  - `roleArn` string — The Amazon Resource Name (ARN) that identifies a role that the application uses to access Amazon Web Services resources that are not part of the application or are in a different Amazon Web Services account.
  - `tags` object — A list of tags to apply to the application.

## Response `200`

Success

- CreateApplicationResponse
  - `applicationArn` string, required — The Amazon Resource Name (ARN) of the application.
  - `applicationId` string, required — The unique application identifier.
  - `applicationVersion` integer, required — The version number of the application.

## Other responses

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

---

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