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

# POST /runGroup

`POST /runGroup`

Creates a run group to limit the compute resources for the runs that are added to the group. Returns an ARN, ID, and tags for the run group.

## Request body

- object
  - `name` string — A name for the group.
  - `maxCpus` integer — The maximum number of CPUs that can run concurrently across all active runs in the run group.
  - `maxRuns` integer — The maximum number of runs that can be running at the same time.
  - `maxDuration` integer — The maximum time for each run (in minutes). If a run exceeds the maximum run time, the run fails automatically.
  - `tags` object — Tags for the group.
  - `requestId` string, required — To ensure that requests don't run multiple times, specify a unique ID for each request.
  - `maxGpus` integer — The maximum number of GPUs that can run concurrently across all active runs in the run group.

## Response `201`

Success

- CreateRunGroupResponse
  - `arn` string — The group's ARN.
  - `id` string — The group's ID.
  - `tags` object — Tags for the run group.

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