Producer-neutral contract

One API.
Anything can call it.

The platform accepts portable artifacts and exposes sites, operations, claims, revisions, retention, and promotions. Clients never need to understand MDI or Cloudflare internals.

Resources

Small surface, durable operations.

PUT

/v1/artifacts/{sha256}

Validate and stage immutable website input.

POST

/v1/sites

Allocate an isolated site and begin materialization.

GET

/v1/sites/{siteId}

Read preview status, URL, and claim metadata.

GET

/v1/sites/{siteId}/operations/{operationId}

Poll progress and terminal receipt.

POST

/v1/sites/{siteId}/administrator-claim

Exchange the one-time capability for site credentials.

POST

/v1/sites/{siteId}/promotions

Future contract: start destination-owned permanent materialization.

Contract properties

Safe to retry. Hard to confuse.

IDENTITY

Digest addressed

Artifact bytes, declared size, and SHA-256 must agree before work is created.

REPLAY

Idempotent

Exact retries converge. Reusing a key with different immutable input fails closed.

AUTHORITY

Capability scoped

API tokens have bounded scopes and quotas; administrator claims transfer one site credential once.

ClientInputWhat it learns
WP BuildGenerated multipage artifactPreview URL and durable build receipt.
StudioExported local websiteShareable remote review environment.
ChatGPTArtifact reference through an ActionSite creation is truly discoverable and generic.
CIBranch build outputRepeatable review site with bounded retention.
WordPress.comPromotion revisionPermanent site materialization and cutover.