Choose which address a root domain leads with

For a root domain (example.com), which of its two names people should use — example.com itself or www.example.com. Body: { "primary": "www.example.com" }, and it must be one of those two.

The other name redirects to the one you pick, and this decides which DNS record is presented as required and which as optional. Nothing is redeployed. A subdomain has no second name and is refused. To choose which of your app’s DOMAINS is its main address, use POST /client/domains/{id}/make-primary. id is a DOMAIN id, from GET /client/services/{id}/domains. Requires apps:deploy.