Skip to main content
POST
Generate Private Registration Preview
Requires the same API-audience registration authority and request binding as creation. This queues private generation; it does not publish a site or submit registration.
string
required
The request ID returned by creation.
string
required
1–255 printable ASCII characters, retained for this exact preview operation.
integer
required
Current positive draft revision. The JSON body must contain only this field and be at most 64 KiB; duplicate fields and query overrides are rejected.
Returns 202 with {"request": ...}. Read the request to observe completion and the owner’s next action. Only one preview may be in flight per request; each account is limited to 10 preview intents per rolling hour. A 429 includes Retry-After: 3600. Replay the current operation key to read its result; superseded keys return 409 idempotency_conflict. Keys remain recorded after the budget window expires. failed or unknown requires the documented recovery and owner decision; never switch keys or create a new draft simply to retry an ambiguous generation. Errors include 400 invalid input, 401 invalid bearer, 403 missing authority, 404 binding mismatch, 409 revision/idempotency or preview-state conflict, 413 oversized body, 422 incomplete or unsupported details, 429 preview limit, and 503 unavailable dependencies/indexes. The owner reviews the exact frozen preview before publication, handles optional domain-provider consent, and separately approves final paid registration submission.