Launch Groups

Promotes a member to Published.

Promotes the specified member to Published, moving all domains assigned to the launch group from the current Published site instance's domain routing to the new one. The switch runs asynchronously and sets status to switch-in-progress until it completes, or to failed if it does not; a failed switch can be retried. Rejects with a 409 if a publish switch is already in progress, if the target is not a current non-Published member, or if the switch would exceed the platform's per-site-instance domain limit. Requires the manage launch group permission.

post/launch-groups/{launchGroupId}/actions/publish

Request

Base URL
https://api.acquia.com/v3
Auth
HTTP bearer
TypeScript
https://skmtc.dev/acquia/apis/acquia-cloud-platform-api/docs/launch-groups/:launchGroupId/actions/publish/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

launchGroupIdstring required

Unique identifier for the launch group.

Request body

site_idstring required

Identifier of the target member site to promote to Published. Must be a current non-Published member of the launch group.

environment_idstring required

Identifier of the environment the target member site instance runs in.

Response

Publish switch started

_embeddedobject

Embedded resources (optional)

message'Publish switch started.' required

Confirmation message that the publish switch 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.