Attach a custom domain

Adds one of your own hostnames. You point DNS at us; the certificate is issued automatically once it resolves. Every record we ask for is a CNAME onto the app’s own Roar address, including at a zone apex — so the domain follows the app if it ever moves and you never have to edit it again. Your DNS provider must be able to put a CNAME at the root of a domain (Cloudflare, DNSimple, Namecheap and bunny.net can); if yours cannot, use www. as your address and forward the bare root to it at your registrar.

Body: { "domain": "shop.example.com" }. For a root domain you may also send preferWww: true, which makes www.example.com the address we present as yours — the other name redirects to it. Sending www.example.com itself does the same: it attaches example.com with www as the address. id is a SERVICE id — take it from services[].id on GET /client/apps/{appId}, not the app id itself. Requires apps:deploy.