BuildWithHQ
Canonical knowledge unit · operations

Domains, API clients, backups, integrations, and asynchronous operations

Builder-facing domain, credential, backup, and integration changes use scoped stored procedures/services; long-running verification and execution work is asynchronous.

ID: BWHQ-OPS-002Status: currentAuthority: highdomainsapi-clientsbackupsintegrations

Domains, API clients, backups, integrations, and asynchronous operations

Domains

Domains are added/removed/set-primary through scoped procedures. DNS/SSL verification can run asynchronously.

API clients

The backend generates high-entropy secrets, stores only safe derived data such as hashes where appropriate, and displays the raw secret once. Rotate/revoke operations are audited.

Backups

A backup request creates pending work. A worker executes it and updates status. Backup destinations are managed through scoped procedures and should avoid long-lived plaintext cloud credentials.

Integrations

Sensitive integration secrets are encrypted before database persistence and omitted from list/detail responses.

General rule

Long-running infrastructure actions should expose queued/provisioning/running/failed states and correlation IDs rather than block an interactive browser request.

Related knowledge

Builder account control planeThe builder portal manages the BuildWithHQ customer account, team, platform billing, portfolio, resource allocation, domains, API clients, backups, integrations, sessions, and audit—not the SaaS end-customer data plane.Secure fields, secrets, and disclosureSensitive values can be structurally excluded from normal search/AI paths, with decryption or disclosure treated as a separate privileged and auditable operation.
Machine-readable source: canonical Markdown. This HTML companion exists for human reading, search indexing, and AI retrieval.