> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracklysms.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate Private Registration Preview

> Queue a private hosted-form preview for the exact registration revision.

Requires the same API-audience registration authority and request binding as [creation](/api-reference/v2/agent-number-requests/create). This queues private generation; it does not publish a site or submit registration.

<ParamField path="request_id" type="string" required>
  The request ID returned by creation.
</ParamField>

<ParamField header="Idempotency-Key" type="string" required>
  1–255 printable ASCII characters, retained for this exact preview operation.
</ParamField>

<ParamField body="revision" type="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.
</ParamField>

Returns `202` with `{"request": ...}`. [Read the request](/api-reference/v2/agent-number-requests/get) 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](/agents/number-registration); 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.