ACacquia
Launch Groups

Assigns a domain to a launch group.

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.

put/launch-groups/{launchGroupId}/domains/{domainName}

Request

Path parameters

launchGroupIdstring required

Unique identifier for the launch group.

domainNamestring required

The fully-qualified domain name (e.g., www.example.com).

Request body

source_site_idstring

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_idstring

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

Domain assignment started

_embeddedobject

Embedded resources (optional)

message'Domain assignment started.' required

Confirmation message that the domain assignment has been started.

Example response

{
  "_links": {
    "self": {
      "href": "https://api.acquia.com/v3/resources/1"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.