---
title: "Creates a new launch group for a codebase."
method: POST
path: "/codebases/{codebaseId}/launch-groups"
tags: ["Launch Groups"]
---

# Creates a new launch group for a codebase.

`POST /codebases/{codebaseId}/launch-groups`

## Request

- Base URL: `https://api.acquia.com/v3`
- URL: `https://api.acquia.com/v3/codebases/{codebaseId}/launch-groups`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/acquia/apis/acquia-cloud-platform-api/docs/codebases/:codebaseId/launch-groups/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new launch group belonging to the specified codebase, designates the initial Published site instance, generates the group's shared FQDN, and registers it on the platform. Requires the `create launch group` permission.

## Path parameters

- `codebaseId` string, required

## Request body

- object
  - `name` string, required: The name of the launch group. Alphanumeric only; maximum 52 characters.
  - `site_id` string, required: Identifier of the site to designate as the initial Published site instance.
  - `environment_id` string, required: Identifier of the environment the initial Published site instance runs in.
  - `description` string, nullable: An optional, free-text description of the launch group. Can be changed later via `PUT /launch-groups/{launchGroupId}`. Leading and trailing whitespace (including common non-ASCII whitespace such as non-breaking or ideographic spaces, but not invisible zero-width characters or exotic control characters, which count as real content) is stripped before persisting, and the 512-character maxLength above is measured on the string after that stripping, not on the raw submitted value. A null value, an empty string (""), or a string that normalizes to one, all mean no description.
  - `additional_members` object[]: Optional additional (non-Published) member site instances to add at creation time.
    - `site_id` string, required: Identifier of the member site.
    - `environment_id` string, required: Identifier of the environment the member site instance runs in.

## Response `202`

Launch group creation started

- object
  - `_links` object, required: HAL links for the resource
    - `self` LaunchGroupAPIHalLink, required: HAL link object
      - `href` union, required: The target URI of the link (can be a URI or URI template)
        - string, uri
        - string, uri-template
      - `templated` boolean: Whether the link is a URI template
      - `type` string: Hint about the media type expected when dereferencing the target resource
      - `deprecation` string: A URL to a resource that provides deprecation information
      - `name` string: A secondary key for selecting links
      - `profile` string: A URI that hints about the profile of the target resource
      - `title` string: A human-readable identifier for the link
      - `hreflang` string: The language of the target resource
  - `_embedded` object: Embedded resources (optional)
  - `message` 'Launch group creation started.', required: Confirmation message that launch group creation has been started.

## Other responses

- `400`: Validation Error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/acquia/apis/acquia-cloud-platform-api.md) - [All operations](https://skmtc.dev/acquia/apis/acquia-cloud-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/acquia/apis/acquia-cloud-platform-api/revisions/508f8f94456d?raw)