---
title: "Partially updates a launch group's name and/or description."
method: PUT
path: "/launch-groups/{launchGroupId}"
tags: ["Launch Groups"]
---

# Partially updates a launch group's name and/or description.

`PUT /launch-groups/{launchGroupId}`

## Request

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

Updates a launch group's name and/or description. This is a partial update, not a full replace — `name` and `description` are each independently optional, and omitting either leaves it unchanged. There is no way to clear `name`; submitting it as null is rejected. An explicit null, an empty string, or a whitespace-only `description` all clear it. At least one of `name`/`description` must be present. The launch group's `fqdn` is generated once, from the name the group had at creation, and is never regenerated when `name` changes, so `name` and `fqdn` may permanently disagree after a rename. Requires the `manage launch group` permission.

## Path parameters

- `launchGroupId` string, required

## Request body

- object
  - `name` string: The name of the launch group. Alphanumeric only; maximum 52 characters. Optional: omitting this property leaves the current name unchanged. There is no way to clear the name -- submitting it as null is rejected. Renaming a launch group deliberately does not change its `fqdn` -- the FQDN is generated once, from the name the group had at creation, and is never regenerated, so `name` and `fqdn` may permanently disagree after a rename.
  - `description` string, nullable: An optional, free-text description of the launch group. Omitting this property leaves the current description unchanged. An explicit null value, an empty string (""), or a string that normalizes to one, all clear it to no description. 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.

## Response `202`

Launch group update 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 update started.', required: Confirmation message that launch group update has been started.

## Other responses

- `400`: Validation Error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `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)