BuildWithHQ PlatformTemplatesSolutionsCalculatorCompare DocsLog inGet started
API-First Extensibility

Custom code in its own container, without exposing the platform core

BuildWithHQ provides a controlled escape hatch for functionality that does not belong in a standard module or direct third-party API call. Developers can install custom services in an isolated tenant container and expose them through a declared API contract that the platform can validate, authorize, call, and audit.

How Isolated extensions fits into BuildWithHQ

BuildWithHQ provides a controlled escape hatch for functionality that does not belong in a standard module or direct third-party API call. Developers can install custom services in an isolated tenant container and expose them through a declared API contract that the platform can validate, authorize, call, and audit.

Platform relationship: This capability uses the same tenant, record, permission, workflow, logging, AI, and extension architecture as the rest of BuildWithHQ.

Container isolation

Tenant registry

Each extension container is registered to a SaaS application and customer account with role, runtime, host, image, resource limits, status, and health information.

Resource boundaries

CPU, memory, GPU hints, runtime type, and host placement can be tracked independently for each container.

Failure isolation

A crashing or misbehaving custom service affects its own container rather than the central execution engine or other tenants.

Independent deployment

Custom services can be upgraded or restarted without redeploying the shared BuildWithHQ application.

Package and endpoint model

Signed packages

Extension packages include publishers, semantic versions, image digests, manifests, release fingerprints, signatures, and SBOM references.

Declared endpoints

The package defines endpoint keys, methods, request and response contracts, timeouts, and operational requirements.

Egress policy

Outbound network behavior can be declared and validated instead of allowing unrestricted calls by default.

Secrets

Credentials remain server-side and are referenced through approved secret mappings rather than exposed to the browser.

Execution flow

1. Trigger

A page action, workflow, AI action, schedule, or API request selects an extension endpoint.

2. Authorize

The platform resolves the tenant, user, record, DataRoles, location, and required permission.

3. Prepare payload

Trusted tenant and user context is injected server-side; untrusted browser values are validated.

4. Invoke

The gateway calls the isolated endpoint and enforces timeout, size, rate, and egress rules.

5. Process response

Structured JSON results return to the workflow, page, record, or AI action.

6. Log evidence

Request and response hashes, outcome, status, duration, package version, endpoint, and disclosure details enter the invocation ledger.

Developer freedom

Custom SDKs

Install specialist libraries that should not run in the shared platform.

Background services

Run data synchronization, transformation, document processing, or long-running vertical logic.

Proprietary algorithms

Keep customer or agency code private inside the customer’s isolated environment.

Third-party adapters

Wrap complex vendor SDKs behind a clean JSON API that the visual builder and workflow engine can use.