About the Site Management APIs

The Site Management APIs let a Wix Enterprise account operate its sites from its own systems, using an Enterprise API key. They cover the parts of running a site at scale that the site dashboard handles 1 site at a time: taking a site offline and putting your own SSL certificate on its domains.

The Site Management APIs include:

• Site Publish State: Take a published site offline without deleting it, so it stops serving visitors while it stays in the account and remains editable.
• SSL Certificate: Install your own SSL certificate on the domains connected to a site, and retrieve the certificate a domain currently serves.

To make a site live again after taking it offline, call Publish Site in the Site Actions API. To list the sites in the account and find their IDs, use the Sites API.

Before you begin

It's important to note the following points before starting to code:

• These APIs are called with an Enterprise API key. Send the key in the Authorization header and the ID of the account that owns the key in the wix-account-id header. The key needs the Manage Enterprise Site Publish State permission scope for the Site Publish State API, or the Manage Enterprise Site SSL Certificates permission scope for the SSL Certificate API. You select scopes when you create the key in the API Keys Manager.
• Every request identifies the site it acts on in metaSiteId. The key must have access to that site.

Terminology

• metaSiteId: The ID of the site a request acts on. The Sites API returns it as the site's ID.
• Published site: A site that's live on the internet and reachable by visitors at its domain.
• Connected domain: A domain that's attached to a site and serves it. Certificates are installed per connected domain.