Domain.connect · StartupBuilder

Inputs

Input	Type	Required	Description
`hostname`	`string`	required	The hostname to attach.
`startup`	Startup	required	The Startup it serves.
`tenant`	Tenant		The Tenant it serves, when a Customer connects its own name.

Output	Type	Required	Description
`domain`	Domain	required	The connected Domain.

Emits Domain.connected.
Performed by the Integration Engineer.
Two-way: it runs at once, in the try, send and do modes.
Issues a certificate once the DNS record verifies.
Asks for a TXT ownership proof and a CNAME that delegates certificate validation; refuses to reach live without the CNAME.
Refuses a wildcard name for a Tenant, and past the Tenant’s name count follows its Entitlement’s atBound.
Registers the Domain with Stripe as a payment method domain on the Startup’s account.

Check	Error	Fix	Then call
The input does not match the schema of the operation.	`invalid-input`	Read the schema of the operation, then send every required field with the right type.	Domain.connect
The key is valid, but its scopes do not allow this operation.	`forbidden`	Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them.	Domain.connect
The record changed since it was read, so the write would overwrite a newer version.	`conflict`	Read the record again, then retry the write against its current state.	Domain.connect
A wildcard name for a Tenant, and past the Tenant’s name count follows its Entitlement’s `atBound`	`refused`	Clear what the check names, then call it again.	Domain.connect

Gate	Default
Decision class	Medium: two-way, visible
Delay window	1 business hour, in which a watcher can pause, redirect or cancel it; then it runs.
Limit	The call Limit of the Permission it runs under.
Over the Limit	It waits `pending` for an Approval from the Founder. Approved, it runs; refused, it ends `refused` with `limit-exceeded`; unanswered by its deadline, it ends `canceled`.