Make a domain primary
set_primary_domain
Chooses which of a site's connected custom domains is the one address shown wherever only one is shown.
The primary domain is used for links to the live site and for the links and examples in the site's texts. Every other connected domain keeps opening the site. Only a connected domain can be primary, so a domain still waiting for DNS is refused. Without a choice, the first connected domain is primary, and removing the primary domain makes the next connected one primary. It needs the permission to manage domains in the workspace. See Custom domains.
Request
Call it with a POST to https://api.modulify.ai/v1/set_primary_domain, sending the inputs below as a JSON object. The token needs the config:write scope.
It makes changes, so send an Idempotency-Key header whenever you might retry it. A retry with the same key gets the first answer back instead of running again.
curl -X POST https://api.modulify.ai/v1/set_primary_domain \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"projectId":"PROJECT_ID","domainId":"DOMAIN_ID"}'Over MCP, the same method is the set_primary_domain tool.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
projectId |
string | Yes | The site id. |
domainId |
string | Yes | The _id of the connected custom domain to make primary, as get_domain_status returned it. |
Response
Every call answers with the JSON envelope of success, message, data, code and version. data holds the result described above, and on a method that returns a total, count carries it. The response headers carry the call's X-Request-Id and what is left of your per-minute budget in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors explains every status code a call can answer with.