---
title: "Assigns a domain to a launch group."
method: PUT
path: "/launch-groups/{launchGroupId}/domains/{domainName}"
tags: ["Launch Groups"]
---

# Assigns a domain to a launch group.

`PUT /launch-groups/{launchGroupId}/domains/{domainName}`

## Request

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

Assigns the domain named in the path to the launch group, recording it with `dns_status: pending`. With no request body, assigns a brand-new domain that has no prior site instance association. To assign a domain that already exists on a member site instance (a Standby domain) instead, provide `source_site_id` and `source_environment_id` in the request body — the domain is moved from that member onto the group's Published member. Rejects with a `409` if the domain is unavailable, if the source site instance is not a member of the group, if the domain does not exist on the source site instance, or if assigning it would exceed the platform's per-site-instance domain limit. Requires the `manage launch group` permission.

## Path parameters

- `launchGroupId` string, required
- `domainName` string, required

## Request body

- object
  - `source_site_id` string: Identifier of the member site instance that currently owns the domain. Provide this (together with `source_environment_id`) to assign a Standby domain — one that already exists on a member site instance. Omit both fields entirely to assign a brand-new domain with no prior site instance association.
  - `source_environment_id` string: Identifier of the environment the source member site instance runs in. Required together with `source_site_id`; must be provided if and only if `source_site_id` is provided.

## Response `202`

Domain assignment 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` 'Domain assignment started.', required: Confirmation message that the domain assignment 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)