Provision a site into a slot a plan you ALREADY PAY FOR includes.
Two different things can be meant by "create a site". Buying one is the
checkout flow (create_checkout → update → complete). This is the other: most
plans include several sites, and this uses one of them at no extra cost.
site_starter includes 5, site_plus 8, site_pro 12, and the agency plans
more. `whoami` and `list_sites` show what the account already holds.
⚠ Prefer this over buying a second subscription when a slot is free. Sites
under ONE subscription share one CPU pool, one disk quota and one
rate-limit bucket — that shared budget is what the plan sells. Two
subscriptions split it, so the customer pays twice for capacity they had.
Requires: API key with write scope, on the account that owns the plan.
Args:
slug: Sub-domain for the new site (lowercase, digits, hyphens)
subscription_id: The subscription whose slot to use
client_name: Display name for the site (optional)
domain: Custom domain; defaults to <slug>.borealhost.ai
site_type: wordpress (default) | php | php-nodb | static-site. Choose
here rather than provisioning WordPress and calling set_site_type
afterwards — that installs a WordPress you then abandon in the
docroot, and it costs a minute of provisioning.
Returns:
{"subscription_id": "uuid", "provisioning_job_id": "uuid",
"slug": "my-second-site", "domain": "my-second-site.borealhost.ai",
"status": "provisioning"}
Poll get_site_status(slug) until it reports active.
Errors:
VALIDATION_ERROR: Plan includes a single site, slug taken, or every
slot is in use (the message reports used/total)
NOT_FOUND: Unknown subscription, or it belongs to another account