MEO Site Management
Platform: This skill applies to MEO (Multi-site Enterprise Operations) subscriptions only. For ACE (Acquia Cloud Enterprise), see Application Management.
Use when:
- Listing, inspecting, creating, or updating sites
- Duplicating an existing site to create a new one
- Scheduling a site for deletion or recovering it
- Finding which sites belong to a codebase or subscription
Note: All commands below use acli api:v3:* (V3 API). Run acli list api:v3:sites to see all current site commands.
List Sites
# All sites you have access to
acli api:v3:sites:list
# Sites for a specific subscription
acli api:v3:subscriptions:list-sites <subscriptionId>
# Sites associated with a specific codebase
acli api:v3:codebases:list-sites <codebaseId>
# Sites in a specific environment
acli api:v3:environments:list-sites <environmentId>
Supports pagination: --offset=<n> and --limit=<n>.
Get Site Details
acli api:v3:sites:find <siteId>
Returns site id, name, label, codebase_id, status, and timestamps.
Create a Site
acli api:v3:sites:create <name> <label> <codebase_id>
| Argument | Required | Description |
|---|---|---|
name |
Yes | Machine name — lowercase letters and hyphens only, starts with a letter |
label |
Yes | Human-readable display name |
codebase_id |
Yes | UUID of the codebase this site will use |
# Example
acli api:v3:sites:create my-new-site "My New Site" d3b07384-d9a0-4568-b1c0-e1e23f123456
Optional flags: --description="...", --site_id=<uuid> (supply your own UUID).
Update a Site
acli api:v3:sites:update <siteId> --label="New Label" --description="Updated description"
Only label and description can be updated after creation.
Duplicate a Site
Creates a new site by copying an existing one into one or more environments.
acli api:v3:sites:duplicate <sourceSiteId> <site_name> <site_label> <environment_mapping>
| Argument | Required | Description |
|---|---|---|
site_name |
Yes | Machine name for the new site |
site_label |
Yes | Display label for the new site |
environment_mapping |
Yes | JSON array mapping source to destination environments |
# Example — duplicate into the same environment
acli api:v3:sites:duplicate abc-site-uuid new-site "New Site" \
'[{"source_environment_id":"env-uuid","destination_environment_id":"env-uuid"}]'
Optional: --hook_argument="..." passes a custom argument to duplication hooks.
Schedule a Site for Deletion
Caution: Schedules the site and all its site instances for deletion. Use
acli api:v3:sites:recoverwithin the grace period to cancel.
acli api:v3:sites:schedule-delete <siteId>
Recover a Site Scheduled for Deletion
acli api:v3:sites:recover <siteId>
Cancels a pending scheduled deletion. Must be run before the grace period expires.
Delete a Site
Destructive operation — explicit approval required. Permanently deletes the site and all associated site instances. This cannot be undone. Confirm with the user before executing.
acli api:v3:sites:delete <siteId>
Typical Workflows
Provision a new site
# 1. Find the codebase UUID
acli api:v3:subscriptions:list-codebases <subscriptionId>
# 2. Create the site
acli api:v3:sites:create my-site "My Site" <codebaseId>
# 3. Associate it with an environment (creates a site instance)
acli api:v3:environments:create-site-instance <environmentId> <siteId>
Clone a site for a new tenant
acli api:v3:sites:duplicate <originalSiteId> \
tenant-new "Tenant New" \
'[{"source_environment_id":"<envId>","destination_environment_id":"<envId>"}]'
Discover More Commands
acli list api:v3:sites
acli list api:v3:subscriptions
acli api:v3:sites:create --help
Related Topics
- MEO Overview — ACE vs MEO, data model, authentication
- MEO Codebases — Manage the git repository backing your sites
- MEO Site Instances — Manage a site within a specific environment
- MEO Environments — Environment-level operations