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

# POST /configuration

`POST /configuration`

Create a new configuration.

## Request body

- object
  - `name` string, required — User-friendly name for the configuration.
  - `description` string — Optional description for the configuration.
  - `runConfigurations` object, required — Run-specific configuration settings.
    - `vpcConfig` object — VPC configuration for workflow runs.
      - `securityGroupIds` SecurityGroupId[] — List of security group IDs. Maximum of 5 security groups allowed.
      - `subnetIds` SubnetId[] — List of subnet IDs. Maximum of 16 subnets allowed.
  - `tags` object — Optional tags for the configuration.
  - `requestId` string, required — Optional request idempotency token. If not specified, a universally unique identifier (UUID) will be automatically generated for the request.

## Response `201`

Success

- CreateConfigurationResponse
  - `arn` string — Unique resource identifier for the configuration.
  - `uuid` string — Unique identifier for the configuration.
  - `name` string — User-friendly name for the configuration.
  - `description` string — Description for the configuration.
  - `runConfigurations` object — Run-specific configurations.
    - `vpcConfig` object — VPC configuration for workflow runs with computed VPC ID.
      - `securityGroupIds` SecurityGroupId[] — List of security group IDs.
      - `subnetIds` SubnetId[] — List of subnet IDs.
      - `vpcId` string — VPC ID computed from the provided subnet IDs.
  - `status` 'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING' | 'DELETED' | 'FAILED' — Current configuration status.
  - `creationTime` string, date-time — Configuration creation timestamp.
  - `tags` object — Tags for the configuration.

## Other responses

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

---

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