Infrastructure Hosting

Manage infrastructure hosting projects and deployments for your BigCommerce store. Use these endpoints to create and manage hosting projects, add custom domains, upload deployment artifacts, trigger deployments, monitor deployment progress via server-sent events, and query or tail worker logs.

For more about native hosting, see the Native Hosting Overview.

Projects

A project is the top-level infrastructure container for your application. You create a project once, then use it as the target for future deployments of that storefront.

Domains

Add, list, claim, transfer, and remove custom domains bound to a project. Adding a domain triggers DNS verification; the domain remains in the pending verification status until DNS propagation and hostname validation complete. If a domain is already bound to a different store, use the claim endpoint with the returned TXT record to verify ownership before it can be bound to your project. To move a verified domain between two projects in the same store, use the transfer endpoint.

For DNS record guidance, see Add a custom domain in the Native Hosting getting started guide.

Deployments

A deployment is a specific version of your project that has been built and released. Use the deployment endpoints to upload build artifacts, create deployments, and monitor deployment progress in real time via server-sent events.

Logs

Query historical worker logs for a project within a time window, with optional filtering by HTTP method, status code, URL, and minimum log level. Or tail real-time worker logs for a project, including request information, log levels, and exceptions.