provision_preview · Provision Preview

Validate an approved root domain and proposed domains before execution. Returns preview issues, workspace routing, and a preview_id.

Back to docs Open portal

Use this when

Best-fit situations

Check whether the approved root domain is customer-owned and execution-ready.

See preflight issues before consuming quota.

Confirm the exact workspace routing that execute would use.

Arguments

Expected inputs

approved_root_domain · required

One approved root domain already registered for the customer.

domains · required

One or more mailbox domains that belong to the approved root domain.

project_alias · optional

Optional project alias when the approved root domain maps to exactly one target project.

requested_by · optional

Optional operator or workflow label for audit readability.

Success shape

What comes back

preview_id

ready_to_execute

issues

workspace_routing

preflight.items with schedulable state

Failure modes

What to expect when it blocks

asset_missing when the root domain is not registered for the customer

workspace_routing_missing when no approved workspace target exists

consent_required or consent_revoked for root-domain consent problems

domain_out_of_scope when a requested domain is outside the approved root domain

Example

Sample tool arguments

{
  "approved_root_domain": "mailionaire-demo.ch",
  "domains": [
    "mailionaire-demo.ch"
  ],
  "project_alias": "mailionaire",
  "requested_by": "pilot-check"
}